# Ein Plan ist grün, wenn zwei von drei Sichten übereinstimmen. Die dritte ist die Wahrheit.

> Ein terraform plan für einen verwalteten Observability-Stack zeigte einen Incident-Fix als ausstehende Änderung, obwohl der Fix seit dem Incident live war und nur der State hinterherhinkte. In den Tagen, bevor die Datei nachgezogen wurde, wäre derselbe Plan grün gewesen, und das nächste Apply hätte den Fix zurückgedreht. Ein Plan ist ein Diff zwischen zwei Sichten, aber das System hat drei. Alle drei zu lesen, bevor Sie planen, ist das, was den Diff von einer Vermutung in eine Entscheidung verwandelt.

- URL: https://ashkmb.com/de/blog/three-way-merge-plan-truth/
- Author: Ashkan Kamyab (https://ashkmb.com)
- Published: 2026-08-14
- Language: de

Ein `terraform plan` für einen verwalteten Observability-Stack kam mit genau einer Änderung zurück: einem Incident-Fix, dargestellt, als würde er gerade erst eingeführt. Der On-Call hatte diesen Fix während eines Incidents zwei Wochen zuvor von Hand angewendet. Der Fix war live. Der Fix war in der Datei. Nur der State war hinterher, also war das Apply ein harmloses Nachziehen. Der gefährliche Moment war bereits vorbei. In den Tagen zwischen dem Hand-Fix und dem Datei-Update stimmten State und Datei miteinander überein, aber nicht mit Live, und ein Plan in diesem Fenster hätte "keine Änderungen" gemeldet, nicht zu unterscheiden von "keine Drift". Das nächste Apply in diesem Fenster hätte jede incident-mildernde Zeile in einem Schritt zurückgedreht. Das ist eine Geschichte über einen grünen Plan, der ein echtes Problem versteckt hätte, und über einen nicht leeren Plan, der nichts Laufendes veränderte.

## Ein Plan ist ein Diff. Das System hat drei Sichten

Ein typischer Plan ist ein Diff zwischen zwei Dingen: State und Datei. "State" ist die letzte erfolgreiche Apply; "Datei" ist das, was Sie schreiben würden, wenn Sie jetzt anfingen. Der Plan rendert *unverändert*, wann immer State und Datei übereinstimmen, was das Grün ist, das jeder Operator zu wollen lernt.

Das System hat drei Quellen der Wahrheit, und nur zwei davon sind im Diff. **Live** ist das laufende Ding, der Cluster oder die Workload oder der Storage-Bucket. **State** ist das, was Terraform oder Helm zuletzt aufgezeichnet haben. **Datei** ist das, was das Repo gerade sagt. Jede wird separat editiert. Jede kann driften. Ein Plan ignoriert die erste.

Die drei Quellen fügen sich zu vier Formen, und der Plan vergleicht nur zwei davon. Alle drei stimmen überein, weil alle drei aus derselben Datei stammen: der kanonische Fall, den ein grüner Plan korrekt meldet. Der State ist hinterher, während Datei und Live bereits aufgeholt haben: Der Plan zeigt eine Änderung, die an der API schon wahr ist, und das Apply ist ein Nachziehen, das nichts Laufendes verändert. Die Datei ist hinterher, während Live und State übereinstimmen (der Fall "ich habe es von meinem Branch angewendet und nie gemergt"): Der Plan zeigt eine Änderung in Richtung Datei, die beim Apply ein Revert ist. Live ist der Ausreißer, während State und Datei übereinstimmen (ein Hand-Fix, der noch nicht im Repo steht, oder der Fall "die Platform hat meine Änderung zurückgedreht, weil sie abgestürzt ist"): Der Plan rendert grün, identisch mit keiner Drift, und das ist der Fall, der die gefährlichste Drift versteckt.

Zwei Sichten, die miteinander übereinstimmen, während sie von der dritten abweichen, sind der Fall, den ein Plan nicht für Sie einordnen kann. Wenn die beiden übereinstimmenden State und Datei sind, rendert er grün und klebt Live vollständig zu. Ein Plan ist ein Diff über einen Vergleich zwischen zwei Dingen, und das dritte Ding bekommt keine Stimme.

## Das erste Exponat: der verwaltete Observability-Stack

Es war mitten in einem Incident. Der On-Call fuhr Hand-`helm upgrade`s gegen das Live-Release; die Values landeten im Cluster, aber die Datei im Repo wurde nicht aktualisiert. Der Incident schloss sich, das Team holte später in der Woche nach und aktualisierte die Datei passend, und an der Oberfläche glich sich alles aus. Dann kam die Planungsphase der nächsten Änderung, und `terraform plan` war nicht leer. Die Ausgabe zeigte den Incident-Fix selbst, die alten Values auf der `-`-Seite und den Fix auf der `+`-Seite, als würde der Fix gerade erst eingeführt.

Gegen die drei Sichten gelesen, war dieser Diff nichts, wovor man sich fürchten musste. Die `-`-Seite war der State, geschrieben vom letzten Apply vor dem Incident. Die `+`-Seite war die Datei, die den Fix inzwischen enthielt. Live ist nicht Teil dieses Diffs, und Live hielt den Fix bereits, weil das Hand-Upgrade ihn dorthin gebracht hatte. Live und Datei stimmten überein; nur der State war hinterher. Das Apply würde in den Cluster schreiben, was dort bereits lief, und den State auf den aktuellen Stand bringen. Das zu wissen, war nicht Aufgabe des Plans. Die Aufgabe des Plans ist es, den Diff zwischen State und Datei zu berechnen, und genau das tat er: Diese Datei will diesen Fix anwenden. Erst der dritte Read sagt, dass der Fix schon da ist.

Die Gefahr lag früher, in einem Fenster, das sich bereits geschlossen hatte. Zwischen dem Hand-Upgrade und dem Datei-Update stimmten State und Datei miteinander überein: Beide hielten die Values von vor dem Incident. Nur Live hielt den Fix. Ein Plan in diesem Fenster rendert "keine Änderungen", und genau so sieht keine Drift aus. Und die nächste Änderung, die in diesem Fenster appliziert wird, ganz gleich welche, rendert das Release neu aus der Datei: Ihr Plan zeigt nur die neue Änderung, während ihr Apply jede Zeile des Incident-Fixes in einem Schritt zurückdreht.

Dieses Fenster ist der Bug. Es ist leicht zu übersehen, weil der Plan darin der Traum ist: grün, oder er zeigt genau die Änderung, die Sie vorhatten. Der Postmortem hätte gelesen "Apply hat den Produktions-Fix während der nächsten Änderung revertet", und er hätte recht gehabt, und er wäre die teuerstmögliche Rahmung eines Missverständnisses gewesen, das der Plan selbst nicht hätte fangen können.

## Das zweite Exponat: der verwaltete Kubernetes-Cluster, einen Tag später

Derselbe Mechanismus, andere Oberfläche. Das Repo-Verzeichnis für einen verwalteten Kubernetes-Cluster enthielt eine echte Änderung: eine Node-Group-Verkleinerung, `general_arm` von 6 auf 4, ein echter Drain von zwei Nodes, absichtlich angefragt. Über diese Änderung sprachen alle. Sie war nicht das Einzige im Plan.

Drei andere Node-Groups auf demselben Cluster waren *State-hinterher*. Ein Code-Sync war eine Woche zuvor gelandet, und seitdem war kein Apply gelaufen. Live passte bereits zur Datei; nur der State trug noch die alten Zahlen. Also zeigte der Plan drei weitere `update in place`-Änderungen an der Scaling-Config der Groups, jede davon an der API bereits wahr. Appliziert hätten sie am Cluster nichts verändert und den State auf den aktuellen Stand gebracht.

Das Risiko war kein Revert; es lag im Lesen. Der `general_arm`-Drain zog die ganze Aufmerksamkeit auf sich, und genau das ist der Punkt. Operatoren neigen dazu, den Diff zu lesen, um den es in der Änderung geht, diesen einen auf Sicherheit zu prüfen und den Rest durchzuwinken. Hier war der Rest zufällig harmlos, aber nichts im Plan sagte das; das kam erst aus dem Lesen von Live. Und das Apply schreibt vier Node-Groups, nicht die eine, die die Änderungsbeschreibung nennt. Andersherum gelesen laden drei Abgleiche, die genauso aussehen wie der Drain, dazu ein, den ganzen Plan als Nachziehen abzuhaken, und die eine Zeile, die zwei Nodes entfernt, versteckt sich zwischen ihnen. Hätte eine der drei leisen Groups nicht zu Live gepasst, hätte der Postmortem gelesen "das Apply hat unbeabsichtigte Änderungen mitgezogen", und er hätte die Ursache dem lauten Diff zugeschrieben statt den drei leisen.

Beide Exponate gehen denselben Mechanismus durch. In dem Moment, in dem jeder Plan lief, stimmten Live und Datei überein und der State war hinterher, und der Plan stellte diesen Rückstand als Änderung dar, die an der API bereits wahr war. Diese Form ist sicher zu applizieren, und allein am Plan ist sie nicht von einer echten Änderung zu unterscheiden; so kann sich ein echter Drain zwischen Abgleichen verstecken. Die gefährliche Form ist ihr Spiegelbild, das das erste Exponat Tage zuvor durchlaufen hatte: State und Datei stimmen überein, während Live sich bewegt hat, was grün rendert und das nächste Apply Live zurückdrehen lässt. Der Plan sagt Ihnen nie, in welcher Form Sie sich befinden; das sagt nur der dritte Read.

## Warum ein Plan das nicht sehen kann

`terraform plan` konsultiert State und Datei. Es konsultiert nicht Live zur Apply-Zeit. `helm template` konsultiert nicht Live zur Plan-Zeit. Keines der beiden Tools wurde dafür entworfen, das Live-System zu verifizieren; beide wurden dafür entworfen zu verifizieren, *was sich ändern würde gegeben den letzten bekannten State*. Der Drei-Wege-Merge, den die Platform nicht macht, ist der, den Sie selbst machen müssen, vor dem Plan, nicht als Teil davon.

Die Form der Limitation ist über Werkzeuge hinweg konsistent. Was auch immer außerhalb des Modells der Platform irgendwo aufgezeichnet wird, ist das Ding, das der Plan nicht sehen kann. Für Terraform ist das die Live-API. Für Helm ist es das Live-Release, das `helm template` nicht abfragt. Für `kubectl diff` gegen einen Server-Side-Apply ist es welcher Admission-Controller auch immer zuletzt modifiziert hat, was der lokale Dry-Run nie sieht. Das Plan-Werkzeug und die Platform beachten zwei verschiedene Quellen; die dritte Quelle ist die, an die der Benutzer nicht zu denken pflegt.

Ein Plan, der sauber zurückkommt, ist keine Aussage, dass Live zur Datei passt. Es ist eine Aussage, dass State zur Datei passt, was Information ist, die der Operator in eine andere Frage umwandeln muss, die Frage, was Live tut, von dem keine der beiden weiß.

## Wie man es tatsächlich liest

Drei billige Reads gegen die drei Quellen, in dieser Reihenfolge: State vom Backend, Datei von der Platte, Live von der API. Legen Sie sie nebeneinander. Der Fall, in dem zwei übereinstimmen und einer abweicht, ist der Fall, den ein Plan nicht für Sie einordnen kann: Ist der State der Ausreißer, zeigt der Plan eine Änderung, die schon live ist; ist es Live, rendert der Plan grün. Der Fall, in dem alle drei übereinstimmen, ist der Fall, den ein grüner Plan korrekt meldet. Sie zu unterscheiden kostet einen State-Pull und einen Read, kein Apply, keine Review-Latenz.

Für Terraform:

```bash
# Read 1: state
terraform state pull
# Read 2: file
terraform plan -no-color
# Read 3: live
# Whatever the platform surfaces (e.g., aws eks describe-cluster ...)
```

Der Punkt sind nicht die Befehle. Der Punkt ist, dass die drei Reads zusammen beantworten, "welche Sicht hinten ist", was die Frage ist, die ein einzelner grüner Plan nicht beantworten kann.

Für Helm:

```bash
# Read 1: state
helm get values <release> -n <ns>
# Read 2: file
helm template <release> <chart> -f values.yaml
# Read 3: live (after dry-run)
helm diff upgrade <release> <chart> -f values.yaml
```

Jedes Paar von Reads lässt sich mit dem Auge abgleichen. Wann immer die drei Reads nicht alle übereinstimmen, halten Sie inne: Der eine, der von den anderen beiden abweicht, ist die Sicht, die hinterher ist, und wenn alle drei voneinander abweichen, hat jemand eine Änderung gemacht, die niemand aufgeschrieben hat. Die Reads dauern beim ersten Mal länger einzurichten als zu laufen; nach dem ersten Mal sind sie ein Skript, und das Skript ist ein Check, der vor jedem Plan läuft, und der Check ist das, was den grünen Diff von einer Vermutung in eine Entscheidung verwandelt.

Der wertvollste Moment, das zu tun, ist der Moment, in dem Sie dabei sind, einen Plan "nichts zu tun" zu nennen, nachdem es kürzlich Hand-Fixes am selben System gab. Das ist der einzige Moment, in dem ein grüner Diff wahrscheinlicher falsch als richtig ist, und es ist der einzige Moment, in dem das Lesen der dritten Sicht billig ist. Die Kosten sind fix; der Zeitpunkt ist alles.

## Die Regel und die Zwillinge

Lesen Sie alle drei Quellen, bevor Sie planen; der Plan ist ein Diff über die Lücke, keine Aussage der Wahrheit.

Der Beitrag des ersten Exponats ist, dass der gefährliche Plan der grüne war, im Fenster, bevor die Datei nachgezogen wurde: "Nichts zu tun" wäre die falsche Lesart gewesen, und die Kosten des Falschliegens hätten darin bestanden, den Fix zurückzudrehen, der den Stack am Laufen hielt. Der Beitrag des zweiten Exponats ist, dass ein echter Diff zwischen drei bereits wahren entweder die ganze Aufmerksamkeit bekommt oder gar keine, und Operatoren neigen dazu, den Diff zu lesen, um den es in der Änderung geht. Sie haben dieselbe Form, weil der Mechanismus derselbe ist; was sich unterscheidet, ist die Oberfläche und welches Paar übereinstimmte, als man hinsah.

Das nächste Mal, wenn ein Plan nach einem Hand-Fix oder einer Out-of-Band-Änderung am selben System unauffällig zurückkommt, ist die Frage nicht "ist das richtig". Die Frage ist *welche der drei Sichten die ist, die hinterher ist*. Die Antwort ist das, was die dritte Quelle sagt, und sie zu lesen dauert weniger Zeit, als dieser Beitrag zu schreiben.
