Architekturentscheidungsdatensatz
Ein Architekturentscheidungseintrag (Architecture Decision Record, ADR) ist einer der wichtigsten Lieferumfang eines Lösungsarchitekten. Dieser Datensatz dokumentiert Architekturentscheidungen, die Sie während des gesamten Entwurfsprozesses treffen. Sie enthält auch kontextspezifische Begründungen und Auswirkungen für jede Entscheidung.
Der ADR dokumentiert alle wichtigen Entscheidungen, einschließlich Alternativen, die Sie ausgeschlossen haben, für architektonisch signifikante Anforderungen. Das Protokoll enthält Anforderungen und Einschränkungen in die dokumentierten Auswirkungen einer Entscheidung.
Implementieren eines ADR
Starten Sie den ADR zu Beginn einer Arbeitsauslastung, und verwalten Sie ihn während der gesamten Lebensdauer der Workload. Ein ADR sollte für Brownfield-Workloads gestartet werden, und wenn die Daten verfügbar sind, sollte er rückwirkend basierend auf bekannten früheren Entscheidungen generiert werden. Der ADR dient als Nur-Anfüge-Protokoll. Dieser Datensatz erstreckt sich über den ursprünglichen Entwurf hinaus, um Designaspekte gegenüber zukünftigen funktionalen und nichtfunktionalen Anforderungen einzuschließen.
Vorgeschlagene Merkmale eines einzelnen Datensatzes
Seien Sie mit der Anatomie jedes Datensatzes konsistent. Entwerfen Sie eine Datensatzvorlage, und befolgen Sie sie konsistent.
Ein Datensatz sollte konsistente Elemente enthalten, z. B.:
- Problem-Anweisung mit Kontext
- In Betracht gezogene Optionen
- Entscheidungsergebnis
- Wichtige Kompromisse mit dieser Entscheidung einschließen
- Notieren Sie das Konfidenzniveau der Entscheidung. Manchmal wird eine architektonisch bedeutende Entscheidung mit relativ geringem Vertrauen getroffen. Dokumentieren, dass der Status mit niedriger Konfidenz für zukünftige Überdenken hilfreich sein könnte.
Unterteilen Sie eine Entscheidung in mehrere, wenn eine architekturbezogene Entscheidung mehrere Phasen wie kurzfristige, mittelfristige, langfristige Ansätze zur Folge hat. Protokollieren Sie jede Phase als eigenen Entscheidungsdatensatz.
Vermeiden Sie das Ausblenden von Folgen von Entscheidungen absichtlich oder versehentlich.
Bewahren Sie Datensätze pithy, assertive, on-topic und fakten auf.
Vermeiden Sie Entwurfshandbücher für Entscheidungsaufzeichnungen. Wenn mehr Begründung oder Entwurfsidee verfügbar sind, stellen Sie einen Link zu einem Dokument als ergänzendes Material bereit, aber die Entscheidung muss klar und eigenständig sein, ohne dieses Material.
Workloaddokumentations-Repository
Dieses Protokoll sollte leicht verfügbar und offen mit der Dokumentation der Workload gespeichert werden.
Ein Architekt kann einem Workload-Team helfen, Empfehlungen von Operational Excellence zu erzielen, indem es hilft, ein Dokument- und Objekt-Repository zu erstellen und zu verwalten. Architekten helfen Teams, alle ihre Ressourcen in das Repository zu setzen, z. B. dieses Entscheidungsprotokoll. Sie ermutigen auch die einheitliche Einführung einer einzigen Quelle der Wahrheit, die für Referenz, Audits und Reaktion auf Vorfälle verwendet werden soll.
Nächste Schritte
Weitere Ressourcen
Vorlagenbeispiele finden Sie in der GitHub-Organisation für Architekturentscheidungsdatensätze.