Introduction aux ADR

Transcript

1. Midi Formation Introduction aux ADR
2. Architecture Decision Records
3. Pourquoi écrire des ADR ?
6. • Quel est le contexte ? • Quelles sont les contraintes ? • Quelles sont les solutions identifiées ? • Quels sont les impacts de chaque solution ? • Quelle décision est prise et selon quels critères ? • Quelles sont les conséquences de cette décision ?
7. Information Intérêt à court terme Intérêt à long terme Contexte Compréhension commune Cadre de la décision Solutions Tracer les idées Pistes envisagées Décision Choix partagé Critères désicifs
8. Quand écrire des ADR ?
9. • Choix d'architecture • Choix d'un outil • Choix d'implémentation • Choix ...
10. Quel format choisir ?
11. • • • • • Markdown Textile AsciiDoc Latex Plaintext Markup language
12. Comment structurer l'ADR ?
13. Template by Michael Nygard
14. Où stocker les ADR ?
16. Cas concret
17. docs/architecture/decisions/0000-template.md
19. docs/architecture/decisions/0002-mailpit-as-email-testing-tool.md
22. Tools • • • • • • https://github.com/thomvaill/log4brains https://github.com/adr/adr-manager https://github.com/structurizr/lite https://github.com/npryce/adr-tools https://github.com/globtec/phpadr https://github.com/cspray/architectural-decision
23. Sources • • • • • • • https://adr.github.io https://github.com/joelparkerhenderson/architecture-decision-record https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions https://tameflow.com/blog/2016-02-09/design-patterns https://www.redhat.com/en/blog/architecture-decision-records https://blog.octo.com/architecture-decision-record https://blog.stack-labs.com/code/adr-to-remember-past-archiectural-decisions
24. Questions ?