Documentazione e infrastruttura - AWS Well-Architected Tool

Documentazione e infrastruttura

Quando si esegue una WAFR, è possibile che, per molte delle best practice seguite, si utilizzi un processo documentato, una procedura operativa standard (SOP), un runbook o un playbook. Durante la WAFR, registra informazioni e contesto nel campo delle note all'interno dello strumento Well-Architected (strumento WA). È possibile risparmiare tempo durante la revisione raccogliendo in anticipo tutti gli elementi della documentazione pertinenti relativi al carico di lavoro.

Considera le seguenti domande quando esamini la documentazione:

  • Quale documentazione esiste sul carico di lavoro?

  • Quale documentazione manca?

  • Quali strumenti verrebbero utilizzati per creare e archiviare questi artefatti?

  • Chi sarebbe coinvolto nella creazione e nella manutenzione di questi artefatti?

Alcuni esempi di documentazione sul carico di lavoro includono:

  • Pagine wiki relative al carico di lavoro

  • Diagrammi dell'architettura

  • Record sulle decisioni architetturali (ADR)

  • Procedure operative standard (SOP)

  • Archivi Infrastructure as code (IaC)

  • Topologia di rete

  • Playbook e runbook

  • Struttura dell'organizzazione o del team

  • Documentazione di strategia multi-account

  • Configurazione centralizzata dei provider dell'identità digitale

  • Configurazione della soluzione di monitoraggio centrale

  • Documentazione per i carichi di lavoro dipendenti

  • Guida di riferimento dell'API

  • Versioni delle librerie software

  • Processo e cronologia della correzione degli errori (COE)

  • Strategia di ingegneria del caos

  • Carica i dettagli del team di test

  • Modello di minaccia

  • Retrospettive dei team

  • Documenti del giorno del gioco

Modelli non idonei

Se nessuna di queste risorse esiste, puoi comunque eseguire la WAFR come meccanismo di scoperta. Tuttavia, il processo può richiedere più tempo senza questi artefatti. La creazione di risorse di documentazione può essere il primo passo verso il miglioramento dell’integrità architetturale.

Individuazione dei carichi di lavoro

È difficile rivedere in modo efficiente un'architettura senza conoscerne i componenti e le risorse. I carichi di lavoro legacy spesso si evolvono nel tempo o cambiano proprietà e potrebbero non essere stati definiti utilizzando strumenti di infrastructure as code (IaC) come AWS CloudFormation, AWS CDK o Terraform.

Prima di discutere dei miglioramenti, comprendi i diversi componenti architettonici del carico di lavoro e le sue dipendenze e crea una rappresentazione visiva per fornire una comprensione condivisa.

Esistono molti strumenti di rilevamento e creazione automatica di diagrammi di terze parti disponibili direttamente dai fornitori di software Marketplace AWS, da o come soluzioni open source.

Risorse