GitOps-Ablauf
Wenn ein Deploy einem git-Repository folgt, ist der Merge das Deployment, also ist der Merge der Schritt, der eine
Freigabe braucht. Vaicoa bietet zwei Wege, beide über den Treiber forgejo_git, getestet mit Forgejo 17 und Flux 2.9.
git.change: ein Pull Request, den du freigibst
Abschnitt betitelt „git.change: ein Pull Request, den du freigibst“- Ein Agent oder ein Mensch schlägt eine Änderung vor, zum Beispiel „setze die Replicas von
apps/web.yamlauf 2“ in einem Deploy-Repository. - Der Treiber pusht einen Branch und öffnet einen Pull Request. Der Plan ist der Tree-Hash des Commits plus die CI-Ergebnisse.
- Du gibst frei. Deine Freigabe bindet den Tree-Hash.
- Der Treiber merged selbst, erst wenn die erforderlichen Checks grün und eine Weile stabil sind, und nur, wenn der
Branch noch genau diesen Tree hat. Hat jemand anderes inzwischen auf
maingemergt, hält er mitbase_movedan; du schlägst erneut vor und gibst erneut frei. - Vaicoa stößt einen Flux-Reconcile an und prüft, dass Flux den Merge-Commit angewendet hat.
Der Agent darf Branches pushen, aber nicht mergen. Dateien mit dem Namen *.sops.* werden nie angefasst. Das
Forge-Token ist im Kern versiegelt, nie in der Umgebung des Treibers.
Wem ein Feld gehört. Ein Objekt mit dem Label von Flux gehört Flux. Werte, die in git liegen (Replicas, Image,
Volume-Größe), ändern sich nur über git.change; eine direkte Änderung würde beim nächsten Reconcile zurückgedreht.
Was nicht in git liegt (ein Rollout-Restart), ändert sich direkt. Ein Objekt, das Flux nicht verwaltet, ändert der Node
direkt, mit einem vorher berechneten Plan.
git.tag: ein Release freigeben statt eines Merges
Abschnitt betitelt „git.tag: ein Release freigeben statt eines Merges“Für trunk-basiertes Arbeiten: Agenten pushen auf main, und nur ein Release-Tag deployt. Du gibst den Tag frei.
- Ein Release-Bot ist der Einzige, der Tags setzen darf, die auf das Release-Muster passen (zum Beispiel
v*), geschützt in Forgejo. Ein Agent mit Schreibrechten kann einen solchen Tag weder pushen noch über die API anlegen. - Der Plan zeigt den vorigen Tag, die Commits seitdem mit ihrem CI-Status und dem Agent-Lauf hinter jedem (aus dem
Commit-Trailer
Vaicoa-Run:), die erforderlichen Checks und eine Diff-Zusammenfassung. - Bevor du ihn siehst, lehnt der Kern ab: ein ungeschütztes Muster, einen Commit, der nicht auf dem Default-Branch liegt, rote oder ausstehende Checks, einen roten Commit im Bereich, einen bereits vorhandenen Tag, eine Version, die nicht steigt, oder zu viele Commits.
- Nach der Freigabe liest der Treiber alles noch einmal. Ein neues Check-Ergebnis oder ein entfernter Schutz beendet die Op, und es wird kein Tag angelegt. Andernfalls setzt der Bot einen annotierten Tag mit der Op, den Freigebenden und dem Plan.
vaicoa-core checkwarnt, wenn ein Deploy einem solchen Repository per Branch statt per Tag folgt: Dann käme jeder Merge ohne Release-Freigabe in Produktion.
Das Playbook release.rollout baut darauf auf: Tag, auf Flux warten, ein Canary-Schritt mit einem Teil der Replicas,
ein Health-Check, und bei einem Fehlschlag gehen die Replicas zurück (siehe
Betriebsprozesse).