理解軟體如何運行於硬體之上，是任何開發者都必須具備的關鍵技能。雖然程式碼定義了行為，但部署圖則定義了位置。這種視覺化表示法能清楚呈現系統的物理架構，顯示軟體組件如何與底層基礎設施互動。對於剛踏入系統設計領域的初學者而言，掌握此類圖表能彌補抽象邏輯與實際現實之間的差距。
本指南將深入探討 UML 部署圖。我們將研究核心元素、標準符號，以及為實際專案建立這些圖表的結構化方法。閱讀完本指南後，您將能不依賴特定工具，就掌握如何視覺化系統邊界、硬體節點與通訊路徑。
🧩 什麼是部署圖？
部署圖是統一模型語言（UML）中的一種結構圖。它描述了實體元件在硬體節點上的部署情況。與顯示邏輯關係的類圖，或顯示時間上行為互動的序列圖不同，部署圖專注於系統的拓撲結構。
- 範圍： 它涵蓋生產環境，而不僅僅是開發環境。
- 重點： 它強調軟體組件與託管它們的硬體或虛擬資源之間的關係。
- 用途： 它有助於容量規劃、網路設定，以及理解分散式系統。
可將其視為基礎設施團隊的藍圖。當開發者說「API 在伺服器上執行」時，部署圖能明確指出是哪一台伺服器、使用何種作業系統，以及它如何與資料庫通訊。
📐 核心元素與符號
要有效地繪製部署圖，必須理解標準符號。UML 透過特定的樣式（stereotypes）來傳達意義，同時避免視覺空間過於雜亂。
1. 節點 🖥️
節點代表一個運算資源。它是一種執行軟體的實體或虛擬裝置。節點是您圖表中的容器。
- 裝置： 代表實體硬體，例如筆電、路由器或感測器。通常以一個方框內含小矩形的方式呈現。
- 執行環境： 提供節點執行時期環境的軟體層。範例包括 Java 虛擬機器（JVM）或 Linux 核心。
- 元件： 部署於節點上的軟體檔案。
2. 元件 📄
元件代表軟體的實體實作單元。這些是會被複製、安裝或執行的檔案。
- 可執行檔： 編譯後的程式碼，例如 .exe 檔案、二進位檔或指令碼。
- 資料： 靜態檔案、資料庫或設定檔。
- 文件： 技術規格或使用者手冊。
3. 通訊路徑 🔗
這些是連接節點的線條，代表系統之間的網路或通訊通道。
- 通訊協定： 用於通訊的標準（例如：HTTP、TCP/IP、REST）。
- 方向： 線條可以是單向或雙向的。
📊 部署元素比較
了解這些元素之間的差異，可避免在設計複雜系統時產生混淆。請使用下方表格作為快速參考指南。
| 元素 | 分類 | 範例 | 視覺呈現 |
|---|---|---|---|
| 節點 | 硬體 / 執行時期 | Web 伺服器、資料庫伺服器 | 3D 立方體或方塊 |
| 工件 | 軟體檔案 | Index.html、.jar 檔案、SQL 指令碼 | 右上角摺疊的矩形 |
| 連結 | 連接 | 乙太網路、Wi-Fi、雲端連接 | 虛線或實線 |
| 介面 | 合約 | API 端點、通訊埠 | 棒棒糖或插座符號 |
🛠️ 建立部署圖的逐步指南
繪製圖表不僅僅是畫出形狀；更重要的是準確地建模系統。遵循此結構化流程，以確保您的圖表對利益相關者和開發人員都有用。
步驟 1：識別系統邊界 🔍
繪製之前，定義系統內部和外部的內容。這有助於確定應包含哪些節點。
- 範圍內：您擁有、管理或直接部署的伺服器。
- 範圍外：第三方服務（例如支付網關提供商），通常以外部節點表示。
步驟 2：列出硬體節點 🖥️
列出所需的實體或虛擬機器。考慮以下內容：
- 客戶端：使用者裝置，例如行動電話、桌面電腦或平板電腦。
- 伺服器端：應用伺服器、負載平衡器和資料庫伺服器。
- 網路設備：防火牆、路由器和交換機。
為每個節點定義其規格。它運行的是 Windows 還是 Linux？是虛擬機器還是裸金屬伺服器？這些資訊對於部署策略至關重要。
步驟 3：映射軟體元件 📦
將軟體組件放置在節點上。此步驟將程式碼與基礎架構連結起來。
- 前端：靜態檔案（HTML、CSS、JS）通常放置於網頁伺服器或 CDN。
- 後端：應用程式邏輯（Java、Python、Node）放置於應用伺服器。
- 資料：資料庫結構和檔案放置於資料庫伺服器。
確保每個元件都有其對應的節點。如果某個檔案被列出來卻沒有對應的節點，表示它在系統中懸浮，這代表設計上存在缺陷。
步驟 4：定義通訊路徑 🔌
使用代表資料流的線來連接節點。明確指定通訊所使用的協定。
- 內部流量：資料中心內部的高速連接（例如 TCP/IP）。
- 外部流量：網際網路流量（例如 HTTPS、REST）。
- 安全性： 指出該路徑是加密還是未加密。
使用協定名稱（例如 HTTP/1.1 或 gRPC）標示這些路徑，能為審查圖表的網路工程師帶來顯著價值。
步驟 5：審查與優化 🔄
繪製完成後，根據需求驗證圖表。
- 冗餘： 是否存在單點故障？若某個節點至關重要，是否應設置備用節點？
- 可擴展性： 此圖表能否展示系統如何擴展？（例如增加更多應用伺服器）。
- 清晰度： 布局是否清晰易讀？盡可能避免線路交叉。
🧠 可擴展系統的進階概念
隨著您從簡單應用程式進階至分散式系統，您的圖表也必須不斷演進。以下是一些應當記住的進階概念。
1. 群集與負載平衡
在現代架構中，您很少會有一台伺服器處理所有請求。您會有群集。部署圖應顯示負載平衡器將流量分散至多個應用節點。這能呈現高可用性。
- 視覺提示： 使用樣式或標示為「群集」的邊界框，將多個相同的節點合併為一組。
- 優勢： 展示系統即使失去一個節點，仍能持續運作而不會中斷。
2. 虛擬化與容器
容器（如 Docker）與虛擬機（VM）增加了抽象層。單一實體伺服器可能主機多個容器節點。
- 表示方式： 您可以繪製一個大型節點框，內含較小的內部框，以代表容器執行個體。
- 背景： 這有助於區分實體硬體限制與虛擬資源配置。
3. 外部系統與 API
您的系統很少孤立運作。它會與外部服務互動。
- 第三方節點： 將這些節點表示為位於您主要邊界之外的獨立節點。
- 介面： 明確標示 API 調用進入和離開您系統的位置。
- 安全性： 突出顯示安全連接（HTTPS）與內部信任連接之間的差異。
⚠️ 應避免的常見錯誤
即使經驗豐富的架構師也會犯錯。對於初級開發人員而言，避免這些常見陷阱可確保您的文件保持準確。
- 過度複雜化： 不要試圖在一個圖表中展示每個微服務。對於複雜的架構，請使用子系統或獨立的圖表。
- 忽略延遲： 圖表是靜態的，但網絡是動態的。如果資料庫與應用程式位於不同區域，請在說明中註明。
- 缺少協定： 沒有標籤的線條毫無用處。請始終明確指出是 HTTP、FTP 還是專有協定。
- 混淆邏輯與物理： 不要將類圖概念（如繼承）與部署概念混為一談。應專注於硬體與部署。
- 靜態快照： 請記住，此圖表代表某一時刻的狀態。雲端環境變化迅速，文件版本控制至關重要。
🔗 與其他 UML 圖表的整合
部署圖並非孤立存在。它與其他圖表協同工作，以提供完整的系統視圖。
1. 與組件圖的關係
組件圖顯示軟體結構。部署圖顯示這些組件的所在位置。您應能從邏輯圖中追蹤組件，到部署圖中節點上的特定實體。
2. 與順序圖的關係
順序圖顯示隨時間變化的互動。部署圖顯示這些互動中涉及的參與者。如果順序圖顯示請求從客戶端傳送到伺服器，部署圖可確認兩者均為有效的節點。
3. 與類圖的關係
類圖定義資料模型。部署圖定義儲存該資料的資料庫所在位置。這確保資料庫結構能在儲存硬體的背景下被正確理解。
🌍 實際應用情境
讓我們看看這些圖表如何應用於實際開發情境中。
情境 1：初創企業的最小可行產品（MVP）
一家新創公司推出一個網路應用程式。他們從單一雲端伺服器開始。
- 節點： 一台虛擬機器。
- 實體： 網頁伺服器軟體、資料庫軟體、應用程式程式碼。
- 連結： 客戶端直接連接到虛擬機。
這個簡單的圖表有助於團隊理解，未來擴展時將需要增加更多的虛擬機。
情境 2：企業系統
一家大型企業需要一個具有多層結構的安全系統。
- 節點： 負載平衡器、Web 層（3 個節點）、應用程式層（3 個節點）、資料庫層（2 個節點）。
- 藝術品： 每一層都有獨立的藝術品。
- 連結： 各層之間的防火牆。外部流量使用加密連結。
在這裡，圖表扮演著安全文件的角色。它顯示資料庫並非直接從互聯網存取。
📝 文件編寫的最佳實務
文件是一種持續演進的產物。為了保持其實用性，請遵循這些實務。
- 一致性： 在專案中的所有圖表中，對相同類型的節點使用相同的圖示和顏色。
- 版本控制： 將您的圖表與程式碼儲存在同一個程式碼庫中。當基礎架構變更時，請更新圖表。
- 圖例： 如果您使用自訂符號或特定顏色來表示安全等級，請始終包含圖例。
- 協作： 與 DevOps 團隊一起審查圖表。他們最了解基礎架構，能夠驗證您的假設。
🎓 重點總結
建立部署圖的重點在於將抽象轉化為具體。這需要清楚理解軟體組件與硬體限制。透過遵循上述步驟，您可以產製出準確、可擴展且對整個團隊都有價值的圖表。
- 專注於節點： 了解您正在部署的硬體或執行環境。
- 定義藝術品： 明確指出涉及的檔案與資料。
- 標示連結： 永遠不要留下未標記的通訊路徑。
- 以層次思維思考： 区分實體硬體與虛擬環境。
- 保持更新： 基礎設施會變動，因此你的圖表也必須隨之改變。
作為一名初級開發人員，主動記錄系統的部署架構展現了成熟與遠見。這使你的觀點從撰寫程式轉變為建構系統。以此指南為基礎，隨著你接觸到更複雜的基礎設施，持續精進你的技能。
