你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
体系结构决策记录
体系结构决策记录（ADR）是解决方案架构师最重要的可交付结果之一。 此记录记录在整个设计过程中做出的体系结构决策。 它还为每个决策提供特定于上下文的理由和含义。
ADR 记录了所有关键决策，包括你排除的替代项，以满足 体系结构上的重要要求。 日志将要求和约束合并到决策的记录效果中。
实现 ADR
在工作负荷开始时启动 ADR，并在工作负荷的整个生命周期内维护它。 应针对棕色地带工作负荷启动 ADR，如果数据可用，则应根据已知的过去决策追溯生成它。 ADR 充当仅追加日志。 此记录超出了初始设计的范围，包括针对未来功能和非功能要求的设计方面。
单个记录的建议特征
与每个记录的剖析一致。 设计记录模板，并一致地遵循它。
记录应包括一致的元素，例如：
- 包含上下文的问题语句
- 考虑的选项
- 决策结果
- 包括使用此决定做出的重要权衡
- 记录决策的置信度。 有时，以相对较低的置信度做出具有重大体系结构意义的决策。 记录低置信度状态对于未来的重新考虑决定可能很有用。
如果体系结构决策将导致多个阶段（例如短期、中期、长期方法），则将一个决策分解为多个决策。 将每个阶段记录为自己的决策记录。
避免故意或意外地隐藏决策的后果。
保留记录异常、自信、主题和事实。
避免制定决策记录设计指南。 如果提供了更多理由或设计理念，请提供文档链接作为补充材料，但决策必须清晰且独立，且没有该材料。
工作负荷文档存储库
此日志应随时可用，并随工作负荷的文档公开存储。
架构师通过帮助建立和维护文档和资产存储库，帮助工作负荷团队实现卓越运营建议。 架构师可帮助团队将所有资产放入存储库，例如此决策日志。 他们还鼓励团队统一采用用于参考、审核和事件响应的单一事实来源。
后续步骤
更多资源
有关模板示例，请访问 体系结构决策记录 GitHub 组织。