Documentación e infraestructura - AWS Well-Architected Tool
Prácticas de uso no recomendadasDetección de la carga de trabajoRecursos

Documentación e infraestructura

Al ejecutar una WAFR, es posible que, para muchas de las prácticas recomendadas que esté siguiendo, cuente con un proceso documentado, un procedimiento operativo estándar (SOP), un manual de procedimientos o un manual de estrategias. Durante la WAFR, registre la información y el contexto en el campo de notas de Well-Architected Tool (WA Tool). Puede ahorrar tiempo durante la revisión recopilando con antelación todos los artefactos de documentación relevantes relacionados con la carga de trabajo.

Tenga en cuenta las siguientes preguntas al analizar la documentación:

  • ¿Qué documentación existe sobre la carga de trabajo?

  • ¿Qué documentación falta?

  • ¿Qué herramientas se utilizarían para crear y almacenar estos artefactos?

  • ¿Quién participaría en la creación y el mantenimiento de estos artefactos?

Algunos ejemplos de documentación sobre su carga de trabajo incluyen:

  • Páginas wiki de carga de trabajo

  • Diagramas de arquitectura

  • Registro de decisiones de arquitectura (ADR)

  • Procedimientos operativos estándar (SOP)

  • Repositorios de infraestructura como código (IaC)

  • Topología de red

  • Guías y manuales de procedimientos

  • Estructura de la organización o el equipo

  • Documentación de la estrategia de varias cuentas

  • Configuración del proveedor de identidades central

  • Configuración de la solución de supervisión central

  • Documentación para cargas de trabajo dependientes

  • Guía de referencia de la API

  • Versiones de la biblioteca del software

  • Proceso e historial de corrección de errores (COE)

  • Estrategia de ingeniería de caos

  • Detalles del equipo de pruebas de carga

  • Modelo de amenaza

  • Retrospectivas de equipos

  • Documentos de día de juego

Prácticas de uso no recomendadas

Si no existe ninguno de estos recursos, aún puede ejecutar la WAFR como mecanismo de detección. Sin embargo, el proceso puede llevar más tiempo sin estos artefactos. La creación de activos de documentación puede ser el primer paso hacia la mejora del estado de la arquitectura.

Detección de la carga de trabajo

Es difícil revisar de manera eficiente una arquitectura sin conocer sus componentes y recursos. Las cargas de trabajo heredadas suelen evolucionar con el tiempo o cambiar de propietario, y es posible que no se hayan definido utilizando herramientas de infraestructura como código (IaC) como AWS CloudFormation, AWS CDK o Terraform.

Antes de hablar de las mejoras, comprenda los diferentes componentes arquitectónicos de la carga de trabajo y sus dependencias, y cree una representación visual que proporcione una comprensión compartida.

Hay muchas herramientas de detección y creación de diagramas automática de terceros disponibles directamente de los proveedores de software, de AWS Marketplace o como soluciones de código abierto.

Recursos