View a markdown version of this page

OPS11-BP08 Documenter et partager des enseignements - AWS Well-Architected Framework

OPS11-BP08 Documenter et partager des enseignements

Documenter et partager des enseignements : documentez et partagez les enseignements que vous tirez des activités opérationnelles afin de pouvoir les utiliser en interne et entre les équipes. Vous devriez partager les enseignements tirés par vos équipes afin d’en retirer un bénéfice accru pour toute votre organisation. Partagez des informations et des ressources pour éviter les erreurs évitables et faciliter les efforts de développement, et concentrez-vous sur la livraison des fonctionnalités souhaitées.

Utilisez Gestion des identités et des accès AWS (IAM) pour définir les autorisations permettant de contrôler l’accès aux ressources que vous souhaitez partager au sein des comptes et entre les comptes.

Résultat souhaité :

  • Vous utilisez des référentiels dont les versions sont contrôlées pour partager des bibliothèques d’application, des procédures scriptées, de la documentation de procédure et d’autres documentations système.

  • Vous partagez vos normes d’infrastructure sous forme de modèles AWS CloudFormation dont les versions sont contrôlées.

  • Vous passez en revue les leçons apprises par les équipes.

Anti-modèles courants :

  • Vous avez subi une panne prolongée, car votre organisation utilise couramment une bibliothèque défaillante. Depuis, vous avez migré vers une bibliothèque fiable. Les autres équipes de votre organisation ne savent pas qu’elles sont exposées à des risques. Personne ne documente et ne partage l’expérience vécue avec cette bibliothèque, et personne n’est conscient des risques.

  • Vous avez identifié un cas limite dans un microservice partagé en interne qui entraîne l’abandon des sessions. Vous avez mis à jour vos appels au service pour éviter ce cas limite. Les autres équipes de votre organisation ne savent pas qu’elles sont exposées à des risques.

  • Vous avez trouvé un moyen de réduire considérablement les besoins d’utilisation du processeur pour l’un de vos microservices. Vous ne savez pas si d’autres équipes peuvent tirer parti de cette technique.

Avantages de la mise en place de cette bonne pratique : partager les leçons apprises pour favoriser l’amélioration et maximiser les avantages de l’expérience.

Niveau de risque exposé si cette bonne pratique n’est pas respectée : faible

Directives d’implémentation

  • Documentez et partagez les leçons tirées : mettez en place des procédures pour documenter les leçons que vous tirez de l’exécution des activités opérationnelles et des analyses rétrospectives, afin que d’autres équipes puissent s’en inspirer.

  • Partager les leçons tirées : imaginez des procédures permettant de partager ces leçons, ainsi que les artefacts qui y sont associés, avec les autres équipes. Partagez par exemple les mises à jour concernant les procédures, les conseils, la gouvernance et les bonnes pratiques par l’intermédiaire d’un wiki accessible. Partagez des scripts, du code et des bibliothèques grâce à un référentiel commun.

Ressources

Bonnes pratiques associées :

Documents connexes :

Vidéos connexes :