Documentation et infrastructure - AWS Well-Architected Tool

Documentation et infrastructure

Lorsque vous exécuterez une WAFR, vous constaterez peut-être que pour la plupart des bonnes pratiques que vous suivez, vous disposez d’un processus documenté, d’une procédure opérationnelle standard (SOP), d’un dossier d’exploitation ou d’un playbook. Pendant la WAFR, enregistrez les informations et le contexte dans le champ de notes de l’outil Well-Architected (WA Tool). Vous pouvez gagner du temps lors de la révision en rassemblant à l’avance tous les artefacts de documentation pertinents relatifs à la charge de travail.

Lorsque vous étudiez votre documentation, posez-vous les questions suivantes :

  • Quelle documentation existe sur la charge de travail ?

  • Quels sont les documents manquants ?

  • Quels outils seraient utilisés pour créer et stocker ces artefacts ?

  • Qui participerait à la création et à la maintenance de ces artefacts ?

Voici quelques exemples de documentation concernant votre charge de travail :

  • Pages wiki sur la charge de travail

  • Schéma de l’architecture

  • Dossier de décisions architecturales

  • Procédures opérationnelles standard

  • Référentiels d’infrastructure en tant que code (IaC)

  • Topologie du réseau

  • Playbooks et dossiers d’exploitation

  • Structure organisationnelle

  • Documentation de la stratégie multicompte

  • Configuration du fournisseur d’identité central

  • Configuration de la solution de surveillance centralisée

  • Documentation pour les charges de travail dépendantes

  • Guide de référence des API

  • Versions de la bibliothèque logicielle

  • Processus et historique de correction des erreurs (COE)

  • Stratégie d’ingénierie du chaos

  • Informations sur l’équipe de test de charge

  • Modèle de la menace

  • Rétrospectives de l’équipe

  • Documents de la journée de jeu

Antimodèles

Si aucune de ces ressources n’existe, vous pouvez toujours exécuter la WAFR en tant que mécanisme de découverte. Toutefois, le processus peut prendre plus de temps sans ces artefacts. La création de ressources documentaires peut être la première étape vers l’amélioration de la santé architecturale.

Découverte des charges de travail

Il est difficile de passer en revue efficacement une architecture sans connaître ses composants et ses ressources. Les charges de travail existantes évoluent souvent au fil du temps ou changent de propriétaire, et elles n’ont peut-être pas été définies à l’aide d’outils d’infrastructure en tant que code (IaC) tels que AWS CloudFormation, AWS CDK ou Terraform.

Avant de discuter des améliorations, comprenez les différents composants architecturaux de la charge de travail et ses dépendances, et créez une représentation visuelle afin de fournir une compréhension partagée.

De nombreux outils tiers de découverte et de création de diagrammes automatiques sont disponibles directement auprès des fournisseurs de logiciels, de AWS Marketplace ou sous forme de solutions open source.

Ressources