Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Runbook zur Release-Rücknahme

Status: Aktiv Umfang: öffentlich, aktueller Stand Zuletzt geprüft: 2026-09-03 Verantwortlich: Release-Technik von AX Code

Dieses Runbook beschreibt, wie eine veröffentlichte stabile (Kanal latest) AX-Code-CLI-Veröffentlichung zurückgezogen und die vorherige wiederhergestellt wird. Vorabveröffentlichungen (Kanal beta) berühren den Homebrew-Tap oder winget nicht, daher verlangt ihre Rücknahme nur den GitHub-Release-Schritt unten.

Bevorzugen Sie einen Hotfix nach vorn (vX.Y.Z+1 ausliefern) bei funktionalen Fehlern. Nehmen Sie nur bei Fehlern der Release-Integrität zurück: defekte oder falsch signierte Artefakte, ein beschädigtes Installationsprogramm, ein Fehler von Kanal oder Tag (zum Beispiel ein Vorab-Tag, der auf latest veröffentlicht wurde) oder eine schwere Regression ohne schnelle Korrektur.

1. Den Kanal einfrieren

Pausieren Sie weitere Veröffentlichungen und Fortsetzungen von postpublish_only, bis die Rücknahme abgeschlossen ist. Der Release-Ablauf weigert sich, Assets einer bereits veröffentlichten Veröffentlichung zu ersetzen, daher kann kein gleichzeitiger erneuter Lauf den zurückzunehmenden Zustand überschreiben.

2. Die GitHub-Veröffentlichung neu ausrichten

Markieren Sie die fehlerhafte Veröffentlichung als Vorabveröffentlichung, damit latest zum vorherigen Tag auflöst, und stellen Sie die vorherigen Versionshinweise wieder her, falls sie überschrieben wurden:

gh release edit "vX.Y.Z" --repo defai-digital/ax-code --prerelease
gh release edit "vX.Y.(Z-1)" --repo defai-digital/ax-code --latest

Wenn die Assets der fehlerhaften Veröffentlichung beschädigt oder falsch signiert sind, löschen Sie sie ebenfalls, damit kein Installationsprogramm sie holen kann:

gh release delete-asset "vX.Y.Z" "<asset-name>" --repo defai-digital/ax-code

Löschen Sie das Release-Objekt selbst nicht, bevor seine Artefakte untersucht wurden. Die signierten Assets und Ablaufprotokolle sind der Nachweis für die Nachbetrachtung.

3. Den Homebrew-Tap zurücksetzen

bash .github/scripts/update-homebrew.sh hat einen Formula-Commit in das gemeinsame Repository defai-digital/homebrew-tap geschoben. Setzen Sie diesen Commit zurück, damit brew upgrade ax-code wieder die vorherige Version ausliefert. Das frühere Repository defai-digital/homebrew-ax-code enthält nur Migrationsmetadaten. Stellen Sie seine Formula nicht wieder her:

git -C homebrew-tap revert --no-edit <formula-commit>

Prüfen Sie die Konvergenz danach mit dem Homebrew-Smoke-Job (.github/workflows/install-matrix-smoke.yml) gegen die wiederhergestellte Version.

4. Winget-Manifeste zurücksetzen

Winget-Manifeste werden von Betreuern bei microsoft/winget-pkgs aus dem Manifest-ZIP eingereicht, das der GitHub-Veröffentlichung beigefügt ist. Wenn die fehlerhafte Version bereits angenommen wurde, öffnen Sie einen PR, der diese Manifestdateien zurücksetzt. Wenn er noch in Prüfung ist, schließen Sie den PR. Der Upload --clobber auf der Veröffentlichung ersetzt nur das beigefügte ZIP, nie das veröffentlichte Paket.

5. Mitteilen

Veröffentlichen Sie eine kurze Notiz in der Release-Diskussion und in jedem Supportkanal: betroffene Versionen, die wiederhergestellte Version und Anweisungen zur Neuinstallation:

• Homebrew: brew update && brew upgrade ax-code (oder brew uninstall ax-code && brew install ax-code).
• Windows und andere: Führen Sie das festgehaltene Installationsprogramm von der vorherigen Release-Seite erneut aus. Das Installationsprogramm scheitert bei einer Signaturabweichung geschlossen und richtet ein festgehaltenes, per SHA-256 geprüftes minisign ein.

6. Den wiederhergestellten Zustand prüfen

1. Bestätigen Sie, dass die GitHub-Veröffentlichung latest auf den vorherigen Tag zeigt und jedes Asset geprüft wird:

   gh release download "vX.Y.(Z-1)" --repo defai-digital/ax-code -p '*.zip' -p '*.minisig'
   minisign -V -p docs/release/ax-minisign.pub -m ax-code-darwin-arm64.zip -x ax-code-darwin-arm64.zip.minisig

2. Bestätigen Sie, dass die Homebrew-Formula die wiederhergestellte Version ausliefert und auf einem sauberen Runner sauber installiert (der Smoke-Ablauf der Installationsmatrix tut das).

3. Bestätigen Sie, dass ax-code --version auf einer frischen Installation die wiederhergestellte Version meldet und ax-code doctor besteht.

7. Nachbetrachtung

Zeichnen Sie auf, was die Release-Schranken bestanden hat und dennoch defekt ausgeliefert wurde, und reichen Sie Korrekturen gegen .github/workflows/release.yml ein (Validierung, Smoke-Abdeckung), bevor die nächste Veröffentlichung kommt. Aktualisieren Sie dieses Runbook, wenn ein Schritt nicht wie beschrieben funktioniert hat.