常見問答集 - AWS規範指導

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

常見問答集

創建 ADR 流程有哪些優點?

項目團隊應創建一個 ADR 流程,以簡化架構決策,防止重複討論相同的架構主題,並有效地傳達架構決策。

項目團隊應何時創建 ADR?

項目團隊應該為影響結構(模式,如微服務)、非功能要求(安全性、高可用性和容錯)、依賴性(組件耦合)、接口(API 和已發佈的合同)和構建的軟件的各個方面創建 ADR技術(庫、框架、工具和流程)。

項目小組應該多久審查 ADR?

項目小組應在接受 ADR 之前至少審查一次。

誰應該創建 ADR?

每個團隊成員都可以創建一個 ADR。我們建議您推廣 ADR 的所有權概念。擁有 ADR 的作者應積極維護和傳播 ADR 內容。其他團隊成員可以隨時為 ADR 做出貢獻。ADR 所有者應批準對 ADR 的更改。

ADR 應包含哪些信息?

每個發展成果評估至少必須界定決定的背景、決定本身以及決定對項目及其交付成果的影響。背景情況應提及小組考慮的可能解決辦法。它還應包含與項目、客户或技術堆棧相關的任何相關信息。該決定必須以強制性語言明確説明團隊決定採用的解決方案。避免使用諸如「應該」這樣的詞語,每個決定都説「我們使用...」或「團隊必須使用...」。後果部分應提及所有已知的決策權衡。每個 ADR 必須具有狀態和更新日誌,其中包含更改日期和負責更改的人員。

哪裏可以找到 ADR 模板?

ADR 模板有多種版本和變體可用。有關常用 ADR 模板的公共集合,請參閲ADR GitHub 儲存庫