アーキテクチャ決定レコード
アーキテクチャ決定レコード (ADR) は、ソリューション アーキテクトの最も重要な成果物の 1 つです。 このレコードは、設計プロセスを通じて行ったアーキテクチャに関する決定を文書化したものです。 また、各決定について、コンテキストに応じた正当性や影響も示しています。
ADR により、アーキテクチャに関する重要な要件について、除外した代替案を含むすべての重要な決定が文書化されます。 ログにより、文書化された決定の効果に要件と制約が組み込まれます。
ADR を実装する
ADR はワークロードの開始時に開始し、ワークロードの有効期間が終了するまで維持します。 ADR は、ブラウンフィールド ワークロードに対して開始される必要があり、データが利用できる場合は、既知の過去の決定に基づいて遡及的に生成される必要があります。 ADR は追加のみのログとして機能します。 このレコードは初期設計にとどまらず、将来の機能要件や非機能要件に対する設計の側面も含みます。
個々の記録の推奨される特性
すべてのレコードの構造に一貫性を保つ。 レコード テンプレートを設計し、一貫してそれに従う。
レコードには、次のような一貫した要素を含める必要があります。
- コンテキストに沿った問題の説明
- 考慮されるオプション
- 決定結果
- この決定で行われた重要なトレードオフを含めます
- 決定の信頼度を記録します。 アーキテクチャに関する重要な決定が、比較的低い信頼度で行われる場合があります。 その信頼度の低さを文書化しておくことで、将来の再検討の決定に役立つ可能性があります。
アーキテクチャに関する決定が、短期、中期、長期のアプローチなど複数のフェーズにまたがる場合は、1 つの決定を複数に分割します。 各フェーズをそれぞれの決定レコードとしてログに記録します。
故意であれ偶然であれ、決定の結果を隠すことは避けます。
レコードは簡潔で、断定的で、トピックに沿った、事実に基づいたものにします。
決定レコードの設計ガイドの作成は避けます。 詳細な根拠や設計上のアイデアがある場合は、補足資料としてドキュメントへのリンクを提供します。ただし、そのような資料がなくても、決定が明瞭で、単独で成立するものである必要があります。
ワークロード ドキュメント リポジトリ
ログはすぐに利用できて、ワークロードのドキュメントと共にオープンに保存する必要があります。
アーキテクトは、ドキュメントと資産のリポジトリの確立と維持をサポートすることで、ワークロード チームによるオペレーショナル エクセレンスの推奨事項の実現に役立ちます。 アーキテクトは、この決定ログのように、チームがすべての資産をリポジトリに配置するのに役立ちます。 また、参照、監査、インシデント対応に使用される信頼できる唯一の情報源をチームで統一して導入することもお勧めします。
次のステップ
その他のリソース
テンプレートの例については、アーキテクチャの決定レコード GitHub 組織に関する記事を参照してください。