Dokumentation und Infrastruktur
Bei der Durchführung einer WAFR werden Sie möglicherweise feststellen, dass Sie für viele Ihrer bewährten Methoden über einen dokumentierten Prozess, ein Standardbetriebsverfahren (Standard Operating Procedure, SOP), ein Runbook oder ein Playbook verfügen. Notieren Sie während der WAFR Informationen und Kontext im Notizfeld des Well-Architected-Tools (WA-Tool). Sie können bei der Überprüfung Zeit sparen, wenn Sie alle relevanten Dokumentationsartefakte, die sich auf den Workload beziehen, bereits im Voraus zusammenstellen.
Berücksichtigen Sie bei der Bearbeitung Ihrer Dokumentation die folgenden Fragen:
-
Welche Dokumentation gibt es in Bezug auf den Workload?
-
Welche Dokumentation fehlt?
-
Welche Tools würden verwendet werden, um diese Artefakte zu erstellen und zu speichern?
-
Wer wäre an der Erstellung und Pflege dieser Artefakte beteiligt?
Einige Beispiele für die Dokumentation zu Ihrem Workload:
-
Wiki-Seiten zu dem Workload
-
Architekturdiagramme
-
Aufzeichnung architektonischer Entscheidungen (Architectural Decision Record, ADR)
-
Standardbetriebsverfahren (SOPs)
-
Infrastructure as Code (IaC)-Repositorys
-
Netzwerktopologie
-
Playbooks und Runbooks
-
Organisations oder Teamstruktur
-
Dokumentation der Strategie für mehrere Konten
-
Konfiguration des zentralen Identitätsanbieters
-
Konfiguration der zentralen Überwachungslösung
-
Dokumentation für abhängige Workloads
-
API-Referenzhandbuch
-
Versionen der Softwarebibliothek
-
Prozess und Verlauf der Fehlerkorrektur (Correction of Errors, COE)
-
Chaos-Engineering-Strategie
-
Details zum Lasttestteam
-
Bedrohungsmodell
-
Team-Rückblicke
-
Dokumente für den Gameday
Gegenmuster
Wenn keine dieser Ressourcen vorhanden ist, können Sie die WAFR dennoch als Entdeckungsmechanismus ausführen. Ohne diese Artefakte kann der Prozess jedoch länger dauern. Die Erstellung von Dokumentationsressourcen kann der erste Schritt zur Verbesserung der architektonischen Integrität sein.
Workload-Erkennung
Es ist schwierig, eine Architektur effizient zu überprüfen, ohne ihre Komponenten und Ressourcen zu kennen. Ältere Workloads entwickeln sich häufig im Laufe der Zeit weiter oder wechseln den Besitzer und wurden möglicherweise nicht mithilfe von Infrastructure as Code (IaC)-Tools wie AWS CloudFormation, AWS CDK oder Terraform definiert.
Bevor Sie über Verbesserungen sprechen, sollten Sie sich mit den verschiedenen Architekturkomponenten des Workloads und ihren Abhängigkeiten vertraut machen und eine visuelle Darstellung erstellen, um ein gemeinsames Verständnis zu schaffen.
Es gibt viele Tools von Drittanbietern zur Erkennung und automatischen Diagrammerstellung. Diese sind direkt bei den Softwareanbietern, AWS Marketplace
Ressourcen
