Enregistrement de décision d’architecture
Un enregistrement de décision d’architecture (ADR) est l’un des livrables les plus importants d’un architecte de solution. Cet enregistrement documente les décisions architecturales que vous prenez tout au long du processus de conception. Il fournit également des justifications et des implications spécifiques au contexte pour chaque décision.
L’ADR documente toutes les décisions clés, y compris les alternatives que vous avez exclues, pour des exigences architecturalement significatives. Le journal incorpore les exigences et les contraintes dans les effets documentés d’une décision.
Implémenter une ADR
Démarrez l’ADR au début d’une charge de travail et maintenez-la tout au long de la durée de vie de la charge de travail. Une ADR doit être démarrée pour les charges de travail brownfield et, si les données sont disponibles, elles doivent être générées rétroactivement en fonction des décisions passées connues. L’ADR sert de journal d’ajout uniquement. Cet enregistrement s’étend au-delà de la conception initiale pour inclure des aspects de conception par rapport aux futures exigences fonctionnelles et non fonctionnelles.
Caractéristiques suggérées d’un enregistrement individuel
Soyez cohérent avec l’anatomie de chaque enregistrement. Concevez un modèle d’enregistrement et suivez-le de manière cohérente.
Un enregistrement doit inclure des éléments cohérents tels que :
- Instruction de problème avec le contexte
- Options prises en compte
- Résultat de la décision
- Inclure des compromis importants pris avec cette décision
- Enregistrez le niveau de confiance de la décision. Parfois, une décision architecturalement importante est prise avec une confiance relativement faible. Documenter que le statut de confiance faible pourrait s’avérer utile pour les décisions de reconsidération futures.
Divisez une décision en plusieurs si une décision architecturale va entraîner plusieurs phases, telles que des approches à court terme, à moyen terme et à long terme. Consignez chaque phase comme propre dossier de décision.
Évitez de masquer les conséquences des décisions intentionnellement ou accidentellement.
Conservez les enregistrements pithy, assertif, sur le sujet et factuels.
Évitez de prendre des guides de conception des enregistrements de décision. Si davantage de justification ou d’idées de conception sont disponibles, fournissez un lien vers un document en tant que matériel supplémentaire, mais la décision doit être claire et autonome sans ce matériel.
Référentiel de documentation de charge de travail
Ce journal doit être facilement disponible et stocké de manière ouverte avec la documentation de la charge de travail.
Un architecte peut aider une équipe de charge de travail à obtenir des recommandations d’excellence opérationnelle en aidant à établir et à maintenir un référentiel de documents et de ressources. Les architectes aident les équipes à placer toutes leurs ressources dans le référentiel, comme ce journal des décisions. Ils encouragent également l’adoption unifiée des équipes d’une seule source de vérité à utiliser pour référence, audits et réponse aux incidents.
Étapes suivantes
Plus de ressources
Pour obtenir des exemples de modèles, visitez l’organisation GitHub d’enregistrements de décision architecturales.