Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Yayın geri alma çalışma kitabı

Durum: Etkin Kapsam: herkese açık, güncel durum Son inceleme: 2026-09-03 Sahip: AX Code yayın mühendisliği

Bu çalışma kitabı, yayımlanmış kararlı (latest kanalı) bir AX Code CLI yayınını geri çekmeyi ve bir öncekini geri yüklemeyi anlatır. Ön yayın (beta kanalı) yayınları Homebrew tap’ine veya winget’e dokunmaz; onları geri almak yalnızca aşağıdaki GitHub yayın adımını gerektirir.

İşlevsel hatalar için ileri düzeltme (vX.Y.Z+1 göndermek) yeğlenir. Yalnızca yayın bütünlüğü hatalarında geri alın: bozuk veya yanlış imzalı yapıtlar, bozulmuş bir kurulumcu, bir kanal/etiket hatası (örneğin latest üzerine yayımlanmış bir ön yayın etiketi) veya hızlı düzeltmesi olmayan ciddi bir gerileme.

1. Kanalı dondurun

Geri alma tamamlanana kadar sonraki yayınları ve postpublish_only sürdürmelerini duraklatın. Yayın iş akışı zaten yayımlanmış bir yayındaki varlıkları değiştirmeyi reddeder; bu yüzden eşzamanlı bir yeniden çalıştırma geri alınan durumu üzerine yazamaz.

2. GitHub yayınını yeniden yönlendirin

latest önceki etikete çözülsün diye kötü yayını ön yayın olarak işaretleyin ve üzerine yazıldıysa önceki sürüm notlarını geri yükleyin:

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

Kötü yayının varlıkları bozuk veya yanlış imzalıysa, hiçbir kurulumcu onları çekemesin diye onları da silin:

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

Yapıtları incelenene kadar yayın nesnesinin kendisini silmeyin; imzalı varlıklar ve iş akışı günlükleri olay sonrası incelemenin kanıtıdır.

3. Homebrew tap'ini geri alın

bash .github/scripts/update-homebrew.sh paylaşılan defai-digital/homebrew-tap deposuna bir formül commit’i itti. brew upgrade ax-code önceki sürümü yeniden sunsun diye bu commit’i geri alın. Eski defai-digital/homebrew-ax-code deposu yalnızca geçiş üst verisi içerir; formülünü geri yüklemeyin:

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

Ardından geri yüklenen sürüme karşı Homebrew duman işiyle (.github/workflows/install-matrix-smoke.yml) yakınsamayı doğrulayın.

4. winget bildirimlerini geri alın

Winget bildirimleri, GitHub yayınına eklenen bildirim ZIP’inden microsoft/winget-pkgs adresine bakımcı tarafından gönderilir. Kötü sürüm zaten kabul edildiyse bu bildirim dosyalarını geri alan bir PR açın. Hâlâ incelemedeyse PR’ı kapatın. Yayındaki --clobber yüklemesi yalnızca ekli ZIP’i değiştirir; yayımlanmış paketi asla değiştirmez.

5. Duyurun

Yayın tartışmasında ve destek kanallarında kısa bir not paylaşın: etkilenen sürümler, geri yüklenen sürüm ve yeniden kurulum yönergeleri:

• Homebrew: brew update && brew upgrade ax-code (veya brew uninstall ax-code && brew install ax-code).
• Windows/diğer: önceki yayın sayfasındaki sabitlenmiş kurulumcuyu yeniden çalıştırın; kurulumcu imza uyuşmazlığında kapalı biçimde başarısız olur ve sabitlenmiş, SHA-256 denetimli bir minisign önyükler.

6. Geri yüklenen durumu doğrulayın

1. GitHub latest yayınının önceki etiketi gösterdiğini ve her varlığın doğrulandığını onaylayın:

   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. Homebrew formülünün geri yüklenen sürümü sunduğunu ve temiz bir çalıştırıcıda temiz kurulduğunu onaylayın (kurulum matrisi duman iş akışı bunu yapar).

3. Taze bir kurulumda ax-code --version komutunun geri yüklenen sürümü bildirdiğini ve ax-code doctor denetimini geçtiğini onaylayın.

7. Olay sonrası inceleme

Yayın kapılarından geçip yine de bozuk gönderilen şeyi kaydedin ve sonraki yayından önce .github/workflows/release.yml (doğrulama, duman kapsamı) için düzeltmeler açın. Bir adım yazıldığı gibi çalışmadıysa bu çalışma kitabını güncelleyin.