{"canonical_url":"https://engineer.company/de/glossary/gitops/","content_markdown":"# GitOps\n\n## Was es ist\n\nGitOps ist eine Betriebsweise für Softwaresysteme: Der gewünschte Zustand\neines Systems wird als Deklaration in Git festgehalten. Softwareagenten\nhalten das laufende System damit in Einklang. Niemand ändert die Produktion\nvon Hand oder über ein Skript auf einem Laptop. Eine Änderung ist ein\nCommit. Ein Agent innerhalb der Umgebung bemerkt den neuen Commit und bringt\ndas System in den dazu passenden Zustand. Das Projekt OpenGitOps formuliert\ndie Idee in vier Prinzipien. Deren Version 1.0.0 wurde am 8. Oktober 2021\nvon der GitOps Working Group veröffentlicht, die das Projekt betreut.\n\nNach diesen Prinzipien muss der Sollzustand deklarativ, versioniert und\nunveränderlich sein, automatisch abgerufen und fortlaufend abgeglichen\nwerden. Deklarativ bedeutet: Die Dateien beschreiben, wie das System aussehen\nsoll, nicht die Befehle, die es dorthin bringen. Versioniert und unveränderlich\nbedeutet: Eine gespeicherte Version wird nie bearbeitet, nur abgelöst;\ndie vollständige Historie bleibt erhalten. Automatisch abgerufen bedeutet:\nSoftwareagenten holen die Deklarationen selbst von der Quelle.\nFortlaufend abgeglichen bedeutet: Agenten vergleichen das laufende System\nwiederholt mit seiner Deklaration und arbeiten daran, beide in Einklang zu\nbringen. Das Projektglossar ergänzt: Fortlaufend heißt, dass die Arbeit\nimmer wieder stattfindet, nicht dass sie augenblicklich geschieht.\n\nZwei Abgrenzungen in diesem Glossar lassen sich leicht übersehen. Git, von\ndem der Name stammt, ist der kanonische Zustandsspeicher. Es eignet sich\naber jeder Speicher, der unveränderliche Versionen hält sowie\nZugriffskontrolle und die Nachvollziehbarkeit von Änderungen am Sollzustand\nbietet. Und der Sollzustand umfasst die Konfiguration, die zum Neuerstellen\ndes Systems nötig ist. Dauerhaft gespeicherte Daten wie Datenbankinhalte\nsind im Allgemeinen ausgenommen. GitOps kann die Rechner einer Datenbank\nneu aufbauen, aber nicht die darin gespeicherten Zeilen.\n\n## Warum es wichtig ist\n\nDer Unterschied zu einer gewöhnlichen Bereitstellungspipeline liegt darin,\nwas die Arbeit auslöst. Das OpenGitOps-Glossar stellt CI/CD-Jobs mit zuvor\nkonfigurierten Auslösern GitOps gegenüber, bei dem der Abgleich ausgelöst\nwird, sobald der Istzustand vom deklarierten abweicht. Die Abweichung kann\nvon beiden Seiten kommen: Ein neuer Commit ändert das Gewünschte, oder das\nlaufende System entfernt sich vom deklarierten Zustand. Eine Pipeline, die\neinmal `kubectl apply` ausgeführt hat, sieht nicht, was danach geschieht.\nDie eigene Kubernetes-Dokumentation hält fest, dass deklaratives Apply\ndirekt an laufenden Objekten vorgenommene Änderungen beibehält, ohne sie in die\nKonfigurationsdateien zurückzuführen. Dateien und Cluster können deshalb\nunbemerkt auseinanderlaufen. Ein abgleichender Agent erkennt beide Arten\nvon Abweichungen.\n\nDer zweite Vorteil betrifft den Ort der Zugriffsrechte. Argo CDs Dokumentation\nweist darauf hin, dass eine Bereitstellungspipeline bei automatischer\nSynchronisierung ohne Zugangsdaten für Argo CDs API-Server arbeiten kann:\nDie Pipeline erstellt einen Commit und pusht ihn. Sie braucht Schreibzugriff\nauf ein Repository statt auf den Cluster. Im Repository werden Änderungen\nohnehin geprüft.\n\nDer dritte Vorteil ist die Historie. Weil der Sollzustand versioniert und\nunveränderlich ist, hält das Repository-Log jede beabsichtigte Änderung fest:\nwas sich geändert hat, wer es geändert hat und wann. Zurückzugehen bedeutet,\neine frühere Version auszuwählen. Argo CD nennt den Rollback auf jede in Git\ncommittete Anwendungskonfiguration als Funktion. Nach einem Vorfall\nbeantwortet diese Historie die erste Frage: Was hat sich geändert? Niemand\nmuss es aus Shell-Verläufen und Erinnerungen rekonstruieren.\n\n## Wie es in der Praxis aussieht\n\nFlux und Argo CD sind zwei Agenten, die dies auf Kubernetes umsetzen.\nArgo CD beschreibt sich als deklaratives GitOps-Werkzeug für Continuous\nDelivery auf Kubernetes. Flux nennt seine Controller und APIs zusammen\nGitOps Toolkit. Nehmen wir ein Team, das seine Produktionsmanifeste in einem\nRepository namens fleet hält. Zwei Flux-Objekte verbinden den Cluster damit:\nDas erste sagt dem Source-Controller von Flux, wo das Repository liegt und\nwie oft er es abrufen soll. Das zweite sagt dem Kustomize-Controller,\nwelches Verzeichnis er anwenden und wie oft er den Cluster dagegen prüfen\nsoll.\n\n```yaml\napiVersion: source.toolkit.fluxcd.io/v1\nkind: GitRepository\nmetadata:\n  name: fleet\n  namespace: flux-system\nspec:\n  interval: 5m\n  url: https://git.example.com/platform/fleet.git\n  ref:\n    branch: main\n---\napiVersion: kustomize.toolkit.fluxcd.io/v1\nkind: Kustomization\nmetadata:\n  name: production\n  namespace: flux-system\nspec:\n  interval: 10m\n  sourceRef:\n    kind: GitRepository\n    name: fleet\n  path: \"./production\"\n  prune: true\n  timeout: 1m\n```\n\nVerfolgen wir nun eine Änderung. Ein Entwickler führt einen Pull Request\nzusammen, der einen Dienst auf ein neues Image-Tag umstellt. Der\nSource-Controller ruft den Branch alle fünf Minuten ab und sieht beim\nnächsten Abruf eine neue Revision. Eine neue Quellrevision wird sofort\nbehandelt, statt bis zum nächsten Intervall zu warten. Der\nKustomize-Controller baut daher die Manifeste unter `./production` und\nwendet sie an. Die Flux-Dokumentation beschreibt den Rest genau für dieses\nObjektpaar. Alle zehn Minuten führt die `Kustomization` entsprechend dem\nIntervall einen Probelauf von Server-Side Apply aus, um Abweichungen zu\nfinden, und gleicht sie dann ab. Ein Kollege, der dasselbe Objekt mit\n`kubectl edit` ändert, sieht seine Änderung daher rückgängig gemacht.\nWeil `prune` aktiv ist, wird ein Objekt, dessen Manifest aus dem Verzeichnis\nentfernt wurde, mit der nächsten Revision aus dem Cluster gelöscht.\nEin Rollback ist ein `git revert` mit anschließendem Merge und nimmt\ndenselben Weg wie jede andere Änderung.\n\nArgo CD erledigt dieselbe Aufgabe über eine Ressource vom Typ `Application`,\nmit anderen Vorgaben. Eine Dokumentationsseite sagt, dass es Repositorys\nalle drei Minuten abfragt. Eine andere, zur automatischen Synchronisierung,\nnennt 120 Sekunden plus bis zu 60 Sekunden zufällige Verzögerung, insgesamt\nhöchstens drei Minuten. Weicht der laufende Zustand vom Zielzustand in Git\nab, wird die Anwendung als OutOfSync markiert. Ist automatische\nSynchronisierung aktiv, synchronisiert Argo CD sie. Standardmäßig löscht\ndiese Synchronisierung aber nichts, was aus Git verschwunden ist, und\nreagiert nicht auf direkte Änderungen im Cluster. Bereinigung und\nSelbstheilung haben eigene Schalter, `prune` und `selfHeal`. Beide sind\nanfangs abgeschaltet.\n\nDasselbe Muster funktioniert außerhalb von Kubernetes. Eine\n[Zone mit 20 DNS-Einträgen, die gegen die API des Anbieters abgeglichen wird](/de/portfolio/reconciled-a-20-record-dns-zone-as-code/),\numgesetzt im August 2026, überführte Einträge aus der Webkonsole eines\nAnbieters in eine Deklaration im Repository. Ein Einstiegspunkt gleicht die\nDeklaration mit dem Anbieter ab. Ein anderer, der eine ausdrückliche\nAktivierung erfordert, prüft nur und meldet Unterschiede, ohne etwas zu\nändern. Die Seite nennt die Prüfung als den am häufigsten genutzten Teil:\nMeist geht es eher darum, den Unterschied zu kennen, als ihn zu beseitigen.\nAn den vier Prinzipien gemessen erfüllt das die ersten beiden: Die Zone\nist deklariert und versioniert. Die Seite beschreibt keinen Agenten, der\ndie Deklaration selbstständig abruft und anwendet. Die letzten beiden werden\ndaher nicht beansprucht. Es ist auch ein nachvollziehbares Argument, dort\nanzufangen, wo Argo CD standardmäßig anfängt: erst die Abweichung zeigen,\nbevor irgendetwas sie korrigieren darf.\n\n## Wo es schiefgeht\n\n**Geheimnisse im Klartext in Git.** Ein Repository mit dem gesamten\nSollzustand verführt dazu, auch Passwörter dort abzulegen. Seine Historie\nbehält sie nach dem Löschen. Laut Flux-Dokumentation ist das Speichern von\nKubernetes-Secrets als Klartext oder base64 in Git unsicher, selbst in einem\nprivaten Repository mit eingeschränktem Zugriff. Verschlüsseln Sie sie vor\ndem Commit. Flux entschlüsselt mit SOPS über age, OpenPGP oder einen\nSchlüsselverwaltungsdienst eines Cloudanbieters, konfiguriert durch\n`.spec.decryption`. Verschlüsseln Sie nur `data` und `stringData`, denn\n`metadata`, `kind` und `apiVersion` müssen lesbar bleiben. Argo CDs\nDokumentation empfiehlt nachdrücklich einen anderen Weg: Geheimnisse im\nZielcluster mit einem Werkzeug wie Sealed Secrets, External Secrets Operator\noder Secrets Store CSI Driver auflösen, statt sie während Argo CDs\nManifestgenerierung einzuspeisen. Davor warnt sie unter anderem, weil der\nRedis-Cache eine unverschlüsselte Kopie der erzeugten Manifeste hält.\n\n**Ein Hotfix, der nicht bleibt, oder eine Abweichung, die nicht verschwindet.**\nDie beiden Werkzeuge verhalten sich standardmäßig unterschiedlich.\nUnter Flux wird eine mit `kubectl edit`, `patch` oder `delete` vorgenommene\nÄnderung umgehend zurückgenommen. Das ist richtig, bis jemand während eines\nAusfalls von Hand eine dringende Korrektur vornimmt und sie verschwinden\nsieht. Bei Argo CD löst eine direkte Änderung im Cluster ohne aktive\nSelbstheilung keine automatische Synchronisierung aus. Eine Abweichung kann\ndaher unbegrenzt als OutOfSync markiert bestehen bleiben. Die Lösung ist\nbei beiden dieselbe: Nehmen Sie die Änderung in Git vor oder setzen Sie\nden Abgleich ausdrücklich aus. Flux' `.spec.suspend` stoppt das Anwenden neuer Revisionen und pausiert die\nKorrektur von Abweichungen, bis es wieder auf false gesetzt wird.\nFür ein von einem anderen Controller verwaltetes Feld, etwa die Anzahl der\nReplikate eines vom Autoscaler betreuten `Deployment`, nimmt Flux'\n`.spec.ignore` JSON-Pointer-Pfade wie `/spec/replicas` entgegen. So\nüberschreiben sich die beiden Controller nicht mehr gegenseitig.\nNehmen Sie auch einen Rollback über Git vor: Argo CD verweigert ihn bei\neiner Anwendung mit aktiver automatischer Synchronisierung.\n\n**In Git gelöscht, weiterhin in Betrieb.** Das Entfernen eines Manifests\nentfernt die Deklaration, nicht das Objekt. Ressourcen, die nicht mehr in Git definiert sind, löscht Argo CDs automatische\nSynchronisierung nur bei aktiver Bereinigung. Flux löscht sie nur, wenn `.spec.prune` auf true steht,\nein Feld, das jede `Kustomization` setzen muss. Bleibt es abgeschaltet,\nfüllt sich der Cluster langsam mit von niemandem deklarierten Objekten.\nSchalten Sie es ein und markieren Sie die wenigen Objekte, die ihr Manifest\nüberleben müssen, mit dem Label oder der Annotation\n`kustomize.toolkit.fluxcd.io/prune: disabled`. Argo CD ergänzt eine\nbewahrenswerte Schutzmaßnahme: Automatische Synchronisierung mit Bereinigung\nlässt eine Anwendung nur dann ohne jegliche Ressourcen zurück, wenn\n`allowEmpty` gesetzt ist. Ein fehlerhafter Commit, der ein Verzeichnis\nleert, leert dadurch nicht den Cluster.\n\n**Ein Merge wartet auf die nächste Abfrage.** Ein Agent, der nach Zeitplan\nabruft, tauscht Geschwindigkeit gegen Unabhängigkeit. Argo CD nennt drei\nMinuten als Abfrageintervall, und Flux sieht einen Commit beim nächsten\nAbruf der Quelle. Beide nehmen einen Webhook des Git-Servers an, um die\nWartezeit zu verkürzen. Argo CD empfängt ihn am Endpunkt `/api/webhook`.\nFlux nutzt eine Ressource vom Typ `Receiver`, die ein Push-Ereignis in den\nAbgleich der darin aufgelisteten Quellen umsetzt. Argo CDs gemeinsames\nWebhook-Geheimnis ist optional, weil die Nutzdaten nur eine Aktualisierung\nauslösen. Seine Dokumentation empfiehlt aber eines, wenn Argo CD öffentlich\nerreichbar ist, um verteilte Denial-of-Service-Angriffe zu verhindern.\nFlux erzeugt einen eindeutigen Webhook-Pfad aus Name, Namensraum und geheimem\nToken des Receivers. Bei GitHub prüft es die HMAC-Signatur der Nutzdaten.\n\n**Git wird zur Produktionsabhängigkeit.** Holt der Agent vom Git-Server ab,\nstoppt ein Git-Ausfall jede Änderung, auch Korrekturen. Die OCI-basierte\nFlux-Variante namens Gitless GitOps behält Git als Schnittstelle für\nMenschen bei, lässt den Cluster aber versionierte Artefakte aus einer\nContainer-Registry abrufen. Der Cluster kann seine Produktionsartefakte\ndadurch ohne Kontakt zum Git-Server beziehen. Welche Quelle der Agent auch\nliest: Geben Sie ihr die Verfügbarkeit, die Sie von der Produktion erwarten.\nWährend eines Ausfalls ist sie der einzige Weg für eine Änderung.\n\n## Weiterführende Lektüre\n\n- [OpenGitOps](https://opengitops.dev/) — die vier GitOps-Prinzipien,\n  Version 1.0.0, von der GitOps Working Group.\n- [GitOps-Glossar v1.0.0](https://github.com/open-gitops/documents/blob/v1.0.0/GLOSSARY.md)\n  — die Definitionen hinter den Prinzipien: Sollzustand, Drift, Abgleich\n  und Zustandsspeicher.\n- [Richtlinie für automatische Synchronisierung](https://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/)\n  — Argo CDs automatische Synchronisierung mit Schaltern für Bereinigung,\n  Selbstheilung und leere Anwendungen sowie den Zeitpunkten jedes Abgleichs.\n- [Kustomization](https://fluxcd.io/flux/components/kustomize/kustomizations/)\n  — Flux' API zum Anwenden eines Verzeichnisses mit Manifesten: Intervall,\n  Bereinigung, Pausieren, Ignorieren und SOPS-Entschlüsselung.\n- [Verwaltung von Geheimnissen](https://argo-cd.readthedocs.io/en/stable/operator-manual/secret-management/)\n  — Argo CDs Argumente für das Auflösen von Geheimnissen im Zielcluster\n  statt während der Manifestgenerierung.\n- [Deklarative Verwaltung von Kubernetes-Objekten mit Konfigurationsdateien](https://kubernetes.io/docs/tasks/manage-kubernetes-objects/declarative-config/)\n  — wie `kubectl apply` und `kubectl diff` auf einem Verzeichnis mit\n  Konfigurationsdateien arbeiten und was Apply mit Änderungen an laufenden\n  Objekten macht.\n\n\u003chttps://engineer.company/de/glossary/gitops/\u003e\n","date_modified":"2026-11-08T09:42:23Z","description":"Wie GitOps Infrastruktur anhand eines in Git gespeicherten Sollzustands betreibt, wie Flux und Argo CD ihn abgleichen und wo Fehler entstehen.","formats":{"gemtext":"https://engineer.company/de/glossary/gitops/index.gmi","gopher":"https://engineer.company/de/glossary/gitops/gophermap","html":"https://engineer.company/de/glossary/gitops/","json":"https://engineer.company/de/glossary/gitops/index.json","markdown":"https://engineer.company/de/glossary/gitops/index.md","pdf":"https://engineer.company/de/glossary/gitops/index.pdf"},"kind":"page","language":"de","title":"Was ist GitOps?","url":"https://engineer.company/de/glossary/gitops/","version":1}