阿里技術(shù)專家：一文教你高效畫出技術(shù)架構(gòu)圖
來源：easemob.com/news/2767
如果有同樣的困惑，本文將介紹一種畫圖的方法論，來讓架構(gòu)圖更清晰。
先厘清一些基礎(chǔ)概念
什么是架構(gòu)?
架構(gòu)就是對系統(tǒng)中的實體以及實體之間的關(guān)系所進(jìn)行的抽象描述，是一系列的決策。
做好架構(gòu)是個復(fù)雜的任務(wù)，也是個很大的話題，本篇就不做深入了。有了架構(gòu)之后，就需要讓干系人理解、遵循相關(guān)決策。
什么是架構(gòu)圖?
系統(tǒng)架構(gòu)圖是為了抽象地表示軟件系統(tǒng)的整體輪廓和各個組件之間的相互關(guān)系和約束邊界，以及軟件系統(tǒng)的物理部署和軟件系統(tǒng)的演進(jìn)方向的整體視圖。
架構(gòu)圖的作用
一圖勝千言。要讓干系人理解、遵循架構(gòu)決策，就需要把架構(gòu)信息傳遞出去。架構(gòu)圖就是一個很好的載體。
架構(gòu)圖分類
搜集了很多資料，分類有很多，有一種比較流行的是 4+1 視圖，分別為場景視圖、邏輯視圖、物理視圖、處理流程視圖和開發(fā)視圖。
場景視圖
場景視圖用于描述系統(tǒng)的參與者與功能用例間的關(guān)系，反映系統(tǒng)的最終需求和交互設(shè)計，通常由用例圖表示。
邏輯視圖
邏輯視圖用于描述系統(tǒng)軟件功能拆解后的組件關(guān)系，組件約束和邊界，反映系統(tǒng)整體組成與系統(tǒng)如何構(gòu)建的過程，通常由 UML 的組件圖和類圖來表示。
物理視圖
處理流程視圖
處理流程視圖用于描述系統(tǒng)軟件組件之間的通信時序，數(shù)據(jù)的輸入輸出，反映系統(tǒng)的功能流程與數(shù)據(jù)流程，通常由時序圖和流程圖表示。
開發(fā)視圖
開發(fā)視圖用于描述系統(tǒng)的模塊劃分和組成，以及細(xì)化到內(nèi)部包的組成設(shè)計，服務(wù)于開發(fā)人員，反映系統(tǒng)開發(fā)實施過程。
怎樣的架構(gòu)圖是好的架構(gòu)圖
上面的分類是前人的經(jīng)驗總結(jié)，圖也是從網(wǎng)上摘來的，那么這些圖畫的好不好呢?是不是我們要依葫蘆畫瓢去畫這樣一些圖?
先不去管這些圖好不好，我們通過對這些圖的分類以及作用，思考了一下，總結(jié)下來。
我們認(rèn)為，在畫出一個好的架構(gòu)圖之前， 首先應(yīng)該要明確其受眾，再想清楚要給他們傳遞什么信息 。
那么，畫出的圖好不好的一個直接標(biāo)準(zhǔn)就是：受眾有沒有準(zhǔn)確接收到想傳遞的信息。
明確這兩點之后，從受眾角度來說，一個好的架構(gòu)圖是不需要解釋的，它應(yīng)該是自描述的，并且要具備一致性和足夠的準(zhǔn)確性，能夠與代碼相呼應(yīng)。
畫架構(gòu)圖遇到的常見問題
方框代表什么?
為什么適用方框而不是圓形，它有什么特殊的含義嗎?隨意使用方框或者其他形狀可能會引起混淆。
虛線、實線什么意思?箭頭什么意思?顏色什么意思?
隨意使用線條或者箭頭可能會引起誤會。
運(yùn)行時與編譯時沖突?層級沖突?
架構(gòu)是一項復(fù)雜的工作，只使用單個圖表來表示架構(gòu)很容易造成莫名其妙的語義混亂。
本文推薦的畫圖方法
C4 模型使用容器(應(yīng)用程序、數(shù)據(jù)存儲、微服務(wù)等)、組件和代碼來描述一個軟件系統(tǒng)的靜態(tài)結(jié)構(gòu)。
這幾種圖比較容易畫，也給出了畫圖要點，但最關(guān)鍵的是，我們認(rèn)為，它明確指出了每種圖可能的受眾以及意義。
下面的案例來自 C4 官網(wǎng)，然后加上了一些我們的理解，來看看如何更好的表達(dá)軟件架構(gòu)。
語境圖(System Context Diagram)
可以看到，非常簡單、清晰，相信不需要解釋，都看的明白，里面包含了需要建設(shè)的系統(tǒng)本身，系統(tǒng)的客戶，和這個系統(tǒng)有交互的周邊系統(tǒng)。
這樣一個簡單的圖，可以告訴我們，要構(gòu)建的系統(tǒng)是什么;它的用戶是誰，誰會用它，它要如何融入已有的 IT 環(huán)境。
這個圖的受眾可以是開發(fā)團(tuán)隊的內(nèi)部人員、外部的技術(shù)或非技術(shù)人員。即：
容器圖(Container Diagram)
容器圖是把語境圖里待建設(shè)的系統(tǒng)做了一個展開。
搜索公眾號互聯(lián)網(wǎng)架構(gòu)師后臺回復(fù)2T”，獲取一份驚喜禮包。
看這張圖的時候，不會去關(guān)注到圖中是直角方框還是圓角方框，不會關(guān)注是實線箭頭還是虛線箭頭，甚至箭頭的指向也沒有引起太多注意。
我們有許多的畫圖方式，都對框、線的含義做了定義，這就需要畫圖的人和看圖的人都清晰的理解這些定義，才能讀全圖里的信息。
而現(xiàn)實是，這往往是非常高的一個要求，所以，很多圖只能看個大概的含義。
這個圖的受眾可以是團(tuán)隊內(nèi)部或外部的開發(fā)人員，也可以是運(yùn)維人員。用途可以羅列為：
怎么畫?用一個框圖來表示，內(nèi)部可能包括名稱、技術(shù)選擇、職責(zé)，以及這些框圖之間的交互，如果涉及外部系統(tǒng)，最好明確邊界。
組件圖(Component Diagram)
組件圖是把某個容器進(jìn)行展開，描述其內(nèi)部的模塊。
這個圖主要是給內(nèi)部開發(fā)人員看的，怎么去做代碼的組織和構(gòu)建。其用途有：
描述了系統(tǒng)由哪些組件/服務(wù)組成
厘清了組件之間的關(guān)系和依賴
為軟件開發(fā)如何分解交付提供了框架
類圖(Code/Class Diagram)
這個圖很顯然是給技術(shù)人員看的，比較常見，就不詳細(xì)介紹了。
案例分享
下面是內(nèi)部的一個實時數(shù)據(jù)工具的架構(gòu)圖。作為一個應(yīng)該自描述的架構(gòu)圖，這里不多做解釋了。如果有看不明白的，那肯定是還畫的不夠好。
畫好架構(gòu)圖可能有許多方法論，本篇主要介紹了 C4 這種方法，C4 的理論也是不斷進(jìn)化的。
但不論是哪種畫圖方法論，我們回到畫圖初衷，是為了更好的交流，我們在畫的過程中不必被條條框框所限制。簡而言之，畫之前想好：畫圖給誰看，看什么，怎么樣不解釋就看懂。
畫圖的工具有：
PS：如果覺得我的分享不錯，歡迎大家隨手點贊、轉(zhuǎn)發(fā)、在看。
PS：如果覺得我的分享不錯，歡迎大家隨手點贊、轉(zhuǎn)發(fā)、在看。