Beslissingsrecord voor architectuur
Een architectuurbeslissingsrecord (ADR) is een van de belangrijkste producten van een oplossingsarchitect. Met deze record worden architectuurbeslissingen vastgelegd die u tijdens het ontwerpproces neemt. Het biedt ook contextspecifieke redenen en implicaties voor elke beslissing.
De ADR documenteert alle belangrijke beslissingen, inclusief alternatieven die u hebt uitgesloten, voor architectuur significante vereisten. Het logboek bevat vereisten en beperkingen in de gedocumenteerde effecten van een beslissing.
Een ADR implementeren
Start de ADR bij het begin van een workload en onderhoud deze gedurende de levensduur van de workload. Een ADR moet worden gestart voor brownfield-workloads en als de gegevens beschikbaar zijn, moet deze met terugwerkende kracht worden gegenereerd op basis van bekende beslissingen uit het verleden. De ADR fungeert als een alleen-toevoegen-logboek. Deze record gaat verder dan het eerste ontwerp om ontwerpaspecten op te nemen ten opzichte van toekomstige functionele en niet-functionele vereisten.
Voorgestelde kenmerken van een afzonderlijke record
Wees consistent met de anatomie van elke record. Ontwerp een recordsjabloon en volg deze consistent.
Een record moet consistente elementen bevatten, zoals:
- Probleeminstructie met context
- Overwogen opties
- Beslissingsresultaat
- Belangrijke compromissen opnemen die met deze beslissing zijn gemaakt
- Noteer het betrouwbaarheidsniveau van de beslissing. Soms wordt een architectonisch belangrijke beslissing genomen met relatief weinig vertrouwen. Documenteren van die lage betrouwbaarheidsstatus kan nuttig zijn voor toekomstige overwegingen.
Breek één beslissing in meerdere als een architectuurbeslissing zal leiden tot meerdere fasen, zoals kortetermijn-, middellange- en langetermijnbenaderingen. Registreer elke fase als een eigen beslissingsrecord.
Vermijd het verbergen van gevolgen van beslissingen opzettelijk of per ongeluk.
Bewaar records pithy, assertief, on-topic en feitelijk.
Vermijd ontwerphandleidingen voor beslissingsrecords. Als er meer redenen of ontwerpideeën beschikbaar zijn, geeft u een koppeling naar een document op als aanvullend materiaal, maar moet de beslissing duidelijk en zelfstandig zijn zonder dat materiaal.
Opslagplaats voor workloaddocumentatie
Dit logboek moet direct beschikbaar zijn en open worden opgeslagen met de documentatie van de workload.
Een architect kan een workloadteam helpen aanbevelingen van Operational Excellence te bereiken door een document- en assetopslagplaats te maken en te onderhouden. Architecten helpen teams om al hun assets in de opslagplaats te plaatsen, zoals dit beslissingslogboek. Ze moedigen ook de geïntegreerde acceptatie van één bron van waarheid aan voor referentie, audits en incidentrespons van de teams.
Volgende stappen
Meer resources
Voor sjabloonvoorbeelden gaat u naar de GitHub-organisatie Architectural Decision Records.