Einführung
Ein Bericht wurde außerhalb von Terraform bearbeitet. Ihr Team benötigt einen Beobachtungsjob, der die Abweichung erkennt, sie von einem Ausführungsfehler unterscheidet und die Entscheidung über eine Korrektur dem Bereitstellungsworkflow mit Prüfung überlässt.
Sie beobachten eine übereinstimmende Umgebung, nehmen eine kontrollierte externe Änderung vor, wiederholen die Beobachtung ohne Korrektur und testen eine ungültige Jobeingabe. Anschließend korrigieren Sie den Speicher durch einen separaten konkreten Plan, dessen Prüfung und Anwendung. Die bereitgestellte Beobachtungsaktion führt die native Planung mit detaillierten Exitcodes aus und protokolliert die Ergebnisse; sie enthält keinen automatischen Apply-Schritt.
Sie sollten gespeicherte Pläne, deren geprüfte Anwendung, State, die Isolation von Umgebungen sowie Shell-Exitstatus verstehen. Dieses Lab startet unabhängig mit zwei vorhandenen Berichtsspeichern und einem separaten benachbarten Objekt. Die gewünschten Release-Eingaben und Qualitätsprüfungen sind bereits vorbereitet und müssen unverändert bleiben.
Bezug zu Zertifizierungen
| Zertifizierung | Prüfungsaufgabe | Übung |
|---|---|---|
| DevOps Engineer – Professional (DOP-C02) | Task 2.1 | Grundlegende Praxis im IaC-Änderungsmanagement: Tatsächliche Abweichungen und Fehler vor einer separat geprüften Korrektur beobachten. |

Eine übereinstimmende Umgebung beobachten
In diesem Schritt erstellen Sie eine Beobachtungsanfrage für eine explizite Quellrevision und Umgebung und interpretieren anschließend ein tatsächliches Ergebnis ohne Änderungen.
Wechseln Sie in das vorbereitete Repository und laden Sie dessen Werkzeuge.
cd /home/labex/project/report-release
source environment.sh
Lesen Sie die gewünschte Release-Konfiguration und die Qualitätsstufen.
cat release.auto.tfvars.json pipeline.json
Sowohl delivery-release-preview als auch delivery-release-review enthalten derzeit release one report. Terraform verwaltet jeden Bucket und seinen Bericht über einen separaten Umgebungs-State. delivery-release-neighbor/keep.txt enthält unabhängige Daten. Behalten Sie die bereitgestellten Terraform-Dateien, Release-Eingaben, die Lockdatei, Tests und Qualitätsstufen bei; Ihre bearbeitbaren JSON-Jobanfragen sind von der gewünschten Terraform-Konfiguration getrennt.
Halten Sie den aktuellen Baseline-Commit für diesen Job und die spätere geprüfte Korrektur fest.
git rev-parse HEAD > selected-revision.txt
Erstellen Sie die Beobachtungsanfrage mit jq. -n startet ohne Eingabedokument, und --arg revision übergibt dem JSON-Ausdruck sicher eine Zeichenfolge. Die resultierende Anfrage wählt explizit preview und die aufgezeichnete Quellrevision aus.
jq -n --arg revision "$(cat selected-revision.txt)" '{revision: $revision, environment: "preview"}' > observation.json
Lesen Sie die Anfrage.
cat observation.json
Sie sollte die vollständige Commit-Kennung und environment: preview enthalten. Führen Sie die bereitgestellte Beobachtungsaktion aus.
python3 delivery.py observe observation.json
Erwarten Sie den nativen Terraform-Exitcode 0 und classification: no_changes. Die gewünschte Konfiguration stimmt derzeit mit dem beobachteten Ziel überein. Dieses Ergebnis betrifft das ausgewählte Modul und die Umgebung, nicht den Zustand sämtlicher Systeme.
Die Aktion exportiert den ausgewählten Quellstand und führt nativ terraform plan -detailed-exitcode aus, ohne einen Ausgabeplan zu speichern oder Apply auszuführen. Sie zeichnet den tatsächlichen Status und Fingerabdrücke des fachlichen State auf. Das Ergebnis ohne Änderungen ist ein nützlicher Nachweis; es berechtigt nicht zu späteren Änderungen.
Lesen Sie den aktuellen Bericht direkt aus dem Speicher.
aws s3 cp s3://delivery-release-preview/report.txt -
Erwarten Sie release one report.
Drift von einem Ausführungsfehler unterscheiden
In diesem Schritt nehmen Sie eine bekannte externe Änderung vor und zeigen, dass wiederholte Beobachtungen sie nicht korrigieren. Außerdem erzeugen Sie einen tatsächlichen nativen Eingabevalidierungsfehler, der weder als unveränderte Umgebung noch als erkannter Drift klassifiziert werden darf.
Bereiten Sie lokal einen kleinen Ersatzbericht vor. printf schreibt den Text und den abschließenden Zeilenumbruch.
printf 'outside edit\n' > outside-report.txt
Laden Sie ihn über AWS CLI unter dem Schlüssel des vorhandenen preview-Objekts hoch. Dies ändert absichtlich nur die Berichtsbytes außerhalb von Terraform; weder der gewünschte Quellstand noch der fachliche State von Terraform werden aktualisiert.
aws s3 cp outside-report.txt s3://delivery-release-preview/report.txt --content-type text/plain
Beobachten Sie den unveränderten Quellstand erneut. Dieser Befehl gibt absichtlich den Exitcode 2 zurück.
python3 delivery.py observe observation.json
Erwarten Sie classification: changes_detected und eine vorgeschlagene Aktualisierung zur Wiederherstellung des Berichts. Der native Code 2 bedeutet, dass ein erfolgreicher Plan Abweichungen gefunden hat; er bezeichnet keinen Provider- oder Ausführungsfehler. Anders als der Befehl zur Erzeugung eines gespeicherten Plans im vorherigen Lab gibt dieser Beobachtungsbefehl den nativen Status bewusst weiter, damit Aufrufer ihn klassifizieren können.
Wiederholen Sie genau denselben Job. Dieser Befehl gibt absichtlich erneut den Exitcode 2 zurück.
python3 delivery.py observe observation.json
Die Abweichung sollte bestehen bleiben, da keine der beiden Beobachtungen den Vorschlag anwendet. Lesen Sie nach beiden Durchläufen das tatsächliche Objekt.
aws s3 cp s3://delivery-release-preview/report.txt -
Es muss weiterhin outside edit enthalten. Der Job meldet Drift, ohne unbemerkt die gewünschten Daten zurückzuschreiben oder den fachlichen State zu überschreiben. Temporäre native Sperren und gewöhnliche Zugriffsprotokolle sind Auswirkungen der Koordination und keine Korrektur.
Erstellen Sie eine separate ungültige Anfrage. report_override ist eine bereitgestellte Eingabe ausschließlich für die Beobachtung, mit der Sie einen ungültigen Durchlauf testen können, ohne den eingecheckten Quellstand zu ändern. Ein leerer Bericht verletzt die vorhandene Validierungsregel des Moduls. Die ursprüngliche gültige Anfrage bleibt unverändert.
jq '. + {report_override: ""}' observation.json > invalid-observation.json
Führen Sie diese Anfrage aus. Dieser Befehl gibt absichtlich den nativen Exitcode 1 zurück.
python3 delivery.py observe invalid-observation.json
Erwarten Sie classification: execution_error und The report input must not be empty. Dies ist der beabsichtigte Terraform-Validierungsfehler. Auch ein Netzwerk- oder Providerfehler müsste untersucht werden; er darf niemals als Ergebnis ohne Änderungen gemeldet oder als erfolgreiche Drift-Erkennung behandelt werden.
Kehren Sie zur ursprünglichen gültigen Anfrage zurück. Dieser Befehl gibt absichtlich den Exitcode 2 zurück, da die externe Änderung noch nicht korrigiert wurde.
python3 delivery.py observe observation.json
Lesen Sie den tatsächlichen Bericht erneut.
aws s3 cp s3://delivery-release-preview/report.txt -
Erwarten Sie outside edit. Die wiederholten gültigen Durchläufe und der ungültige Durchlauf haben das Objekt nicht korrigiert, die Baseline-Konfiguration nicht geändert und den fachlichen State nicht überschrieben. Die drei nativen Ergebnisse sind verschieden: 0 für keine Änderungen, 2 für erkannte Änderungen und 1 für einen Ausführungsfehler.
Durch Prüfung korrigieren und erneut beobachten
In diesem Schritt übergeben Sie die bekannte Abweichung an den normalen Bereitstellungsworkflow. Die Beobachtung hat Informationen geliefert; die separate Abfolge aus Planung, Prüfung und Anwendung macht die Korrektur explizit.
Erzeugen Sie ein konkretes Korrekturartefakt für dieselbe ausgewählte Baseline und die Umgebung preview.
python3 delivery.py plan repair-baseline --revision "$(cat selected-revision.txt)" --environment preview
Erwarten Sie, dass die Qualitätsprüfungen erfolgreich sind und der native Plan mit Code 2 die Berichtsaktualisierung erkennt. Der Bereitstellungsbefehl gibt 0 zurück, weil er das Artefakt erfolgreich erzeugt hat. Die Quelleingaben fordern weiterhin den ursprünglichen Bericht an; bearbeiten Sie sie nicht, um die externe Änderung zu verbergen.
Untersuchen Sie den tatsächlichen Vorschlag und seinen Kontext.
python3 delivery.py inspect repair-baseline
Bestätigen Sie, dass er auf delivery-release-preview/report.txt zielt und den Baseline-Bericht wiederherstellt. Die ausgewählte Revision, Lockdatei und Umgebung müssen zur Korrektur passen, die Sie autorisieren möchten.
Protokollieren Sie die Prüfung.
python3 delivery.py review repair-baseline --revision "$(cat selected-revision.txt)" --environment preview
Wenden Sie diesen geprüften binären Plan über den bereitgestellten Einstiegspunkt an.
python3 delivery.py apply repair-baseline --revision "$(cat selected-revision.txt)" --environment preview
Erwarten Sie den nativen Apply-Exitcode 0. Dies ist die bewusste Korrektur; die Beobachtungsaktion selbst hat nichts angewendet.
Führen Sie die ursprüngliche Beobachtung noch einmal aus.
python3 delivery.py observe observation.json
Erwarten Sie den nativen Exitcode 0 und classification: no_changes. Der gewünschte Quellstand und das tatsächliche Ziel stimmen nun überein. Diese abschließende Beobachtung muss die Bytes des korrigierten fachlichen State unverändert lassen.
Lesen Sie den wiederhergestellten Bericht.
aws s3 cp s3://delivery-release-preview/report.txt -
Erwarten Sie release one report. Prüfen Sie die benachbarte Umgebung und die unabhängigen Daten.
aws s3 cp s3://delivery-release-review/report.txt -
Erwarten Sie dort ebenfalls release one report.
aws s3 cp s3://delivery-release-neighbor/keep.txt -
Erwarten Sie preserve release neighbor. Behalten Sie die wiederhergestellten vorhandenen Speicher, den State und die Jobnachweise zur Bewertung bei. Es wurde kein separater Infrastruktur-Stack erstellt. Sie haben die Beobachtung wiederholbar und auf Lesezugriffe beschränkt gehalten und die tatsächliche Korrektur über ein explizites geprüftes Artefakt ausgeführt.
Zusammenfassung
Sie haben einen Beobachtungsjob für einen bestimmten Quellstand konfiguriert und die nativen Ergebnisse 0 für keine Änderungen, 2 für erkannte Änderungen und 1 für einen Ausführungsfehler unterschieden. Wiederholte Beobachtungen haben die tatsächliche externe Änderung und den fachlichen State erhalten. Ein separater geprüfter gespeicherter Plan hat die Korrektur ausgeführt. Danach ergab die Beobachtung wieder keine Änderungen, während die andere Umgebung und die benachbarten Daten erhalten blieben.
Beobachtung und Korrektur haben unterschiedliche Aufgaben. Lesen Sie Diagnosen und klassifizieren Sie Fehler, bevor Sie entscheiden, was geändert werden soll. Die offizielle Referenz zu detaillierten Exitcodes beschreibt die hier verwendeten nativen Statuscodes.



