Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Buku panduan pengembalian rilis

Status: Aktif Cakupan: publik, kondisi terkini Terakhir ditinjau: 2026-09-03 Pemilik: rekayasa rilis AX Code

Buku panduan ini menjelaskan cara menarik rilis CLI AX Code stabil (kanal latest) yang sudah diterbitkan dan memulihkan yang sebelumnya. Rilis pra-rilis (kanal beta) tidak menyentuh tap Homebrew atau winget, jadi mengembalikannya hanya membutuhkan langkah rilis GitHub di bawah.

Utamakan hotfix ke depan (kirim vX.Y.Z+1) untuk bug fungsional. Kembalikan hanya untuk kegagalan integritas rilis: artefak rusak atau salah tanda tangan, pemasang yang korup, kesalahan kanal/tag (misalnya tag pra-rilis yang diterbitkan ke latest), atau regresi parah tanpa perbaikan cepat.

1. Bekukan kanal

Jeda rilis selanjutnya dan kelanjutan postpublish_only sampai pengembalian selesai. Alur kerja rilis menolak mengganti aset pada rilis yang sudah diterbitkan, jadi tidak ada jalankan ulang bersamaan yang dapat menimpa keadaan yang sedang dikembalikan.

2. Arahkan ulang rilis GitHub

Tandai rilis buruk sebagai pra-rilis agar latest terselesaikan ke tag sebelumnya, dan pulihkan catatan rilis sebelumnya jika ditimpa:

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

Jika aset rilis buruk korup atau salah tanda tangan, hapus juga agar tidak ada pemasang yang dapat mengambilnya:

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

Jangan menghapus objek rilis itu sendiri sampai artefaknya diselidiki; aset bertanda tangan dan log alur kerja adalah bukti untuk postmortem.

3. Kembalikan tap Homebrew

bash .github/scripts/update-homebrew.sh mendorong komit formula ke repositori bersama defai-digital/homebrew-tap. Kembalikan komit itu agar brew upgrade ax-code menyajikan versi sebelumnya lagi. Repositori lama defai-digital/homebrew-ax-code hanya berisi metadata migrasi; jangan pulihkan formulanya:

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

Verifikasi konvergensi setelahnya dengan pekerjaan asap Homebrew (.github/workflows/install-matrix-smoke.yml) terhadap versi yang dipulihkan.

4. Kembalikan manifes winget

Manifes winget dikirim pengelola ke microsoft/winget-pkgs dari ZIP manifes yang dilampirkan pada rilis GitHub. Jika versi buruk sudah diterima, buka PR yang mengembalikan berkas manifes itu. Jika masih dalam tinjauan, tutup PR. Unggahan --clobber pada rilis hanya mengganti ZIP terlampir, tidak pernah paket yang diterbitkan.

5. Komunikasikan

Kirim catatan pendek di diskusi rilis dan kanal dukungan apa pun: versi yang terpengaruh, versi yang dipulihkan, dan petunjuk pasang ulang:

Homebrew: brew update && brew upgrade ax-code (atau brew uninstall ax-code && brew install ax-code).
Windows/lainnya: jalankan ulang pemasang yang disematkan dari halaman rilis sebelumnya; pemasang gagal tertutup pada ketidakcocokan tanda tangan dan mem-bootstrap minisign yang disematkan serta diperiksa SHA-256.

6. Verifikasi keadaan yang dipulihkan

Pastikan rilis GitHub latest menunjuk ke tag sebelumnya dan setiap aset terverifikasi:

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

Pastikan formula Homebrew menyajikan versi yang dipulihkan dan terpasang dengan bersih pada runner yang bersih (alur kerja asap matriks pemasangan melakukan ini).
Pastikan ax-code --version pada pemasangan baru melaporkan versi yang dipulihkan dan lulus ax-code doctor.

7. Postmortem

Catat apa yang lulus gerbang rilis tetapi tetap terkirim dalam keadaan rusak, dan ajukan perbaikan terhadap .github/workflows/release.yml (validasi, cakupan asap) sebelum rilis berikutnya. Perbarui buku panduan ini jika ada langkah yang tidak bekerja seperti tertulis.