Documentação e infraestrutura - AWS Well-Architected Tool
AntipadrõesDescoberta de workloadRecursos

Documentação e infraestrutura

Ao executar uma análise do Well-Architected Framework (WAFR), você provavelmente descobrirá que, para muitas das práticas recomendadas que está seguindo, você terá um processo documentado, um procedimento operacional padrão (SOP), um runbook ou um manual. Durante a WAFR, registre as informações e o contexto no campo de observações no Well-Architected Tool (WA Tool). Você pode economizar tempo durante a análise reunindo com antecedência todos os artefatos de documentação relevantes relacionados à workload.

Considere as seguintes questões ao considerar sua documentação:

  • Que documentação existe sobre a workload?

  • Qual documentação está faltando?

  • Quais ferramentas seriam usadas para criar e armazenar esses artefatos?

  • Quem estaria envolvido na criação e manutenção desses artefatos?

Alguns exemplos de documentação sobre a workload incluem:

  • Páginas wiki sobre a workload

  • Diagramas de arquitetura

  • Registro de decisão arquitetônica (ADR)

  • Procedimentos operacionais padrão (SOPs)

  • Repositórios de infraestrutura como código (IaC)

  • Topologia de rede

  • Manuais e runbooks

  • Estrutura da organização ou equipe

  • Documentação de estratégia de várias contas

  • Configuração do provedor de identidades central

  • Configuração da solução de monitoramento central

  • Documentação de workloads dependentes

  • Guia de referência de API

  • Versões de biblioteca de software

  • Processo e histórico de correção de erros (COE)

  • Estratégia de engenharia do caos

  • Detalhes da equipe de teste de carga

  • Modelo de ameaça

  • Retrospectivas da equipe

  • Documentos de dia de jogo

Antipadrões

Se nenhum desses recursos existir, ainda assim você poderá executar a WAFR como um mecanismo de descoberta. No entanto, o processo pode levar mais tempo sem esses artefatos. A criação de ativos de documentação pode ser o primeiro passo para a melhoria da integridade da arquitetura.

Descoberta de workload

É difícil analisar com eficiência uma arquitetura sem conhecer seus componentes e recursos. As workloads legadas geralmente evoluem com o tempo ou mudam de propriedade, e podem não ter sido definidas usando ferramentas de infraestrutura como código (IaC), como o AWS CloudFormation, o AWS CDK ou o Terraform.

Antes de discutir as melhorias, entenda os diferentes componentes da arquitetura da wokload e as respectivas dependências e crie uma representação visual para oferecer um entendimento em comum.

Há muitas ferramentas de descoberta e diagramação automática de terceiros que podem ser obtidas diretamente dos fornecedores de software, do AWS Marketplace ou como soluções de código aberto.

Recursos