Une documentation d’architecture doit aider à décider, dépanner et transmettre. Elle présente flux, données, accès, propriétaires et procédures sans recopier chaque détail d’implémentation.
Dessiner les flux
Maintenir la documentation
Chaque composant doit pointer vers propriétaire, dashboard, runbook, dépendances et objectif de reprise. Mettez à jour le schéma après changement et postmortem. Une revue trimestrielle compare documentation, inventaire et infrastructure réelle. Retirez les ressources supprimées et notez les exceptions avec une date de réexamen.
Montrez utilisateurs, DNS, CDN, API, bases, stockage, queues et services externes. Ajoutez sens, protocole et identité. Un flux non documenté devient une hypothèse pendant l’incident.
Décrire les données
Indiquez source, format, conservation, sauvegarde et région. Les données privées doivent avoir un chemin d’accès contrôlé. Le guide de rétention cloud complète cette partie.
Lier opérations et risques
Chaque composant pointe vers dashboard, runbook, propriétaire et retour. Notez quotas, certificats, dépendances et objectif de reprise. Une revue trimestrielle vérifie que le schéma correspond à l’infrastructure réelle.
Maintenir
Mettez à jour après changement important et postmortem. Sources : Google Cloud Architecture Framework, AWS Well-Architected.