Pengaturan Rollout Progressif

Copy sebuah prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Aktivitas pergeseran progresif menjaga saluran’s Saluran yang stabil tetap di tempat sementara mengirimkan target pergeseran separat ke bagian kontrol dari perangkat. Itu berguna ketika Anda ingin validasi produksi nyata tanpa mengganti saluran seluruhnya sekaligus.

Pengendalian pergeseran progresif di dalam saluran Capgo — Konfigurasi target pergeseran, persentase, durasi cache, dan kebijakan berhenti otomatis dari tab Informasi saluran.

Bagaimana pergeseran progresif bekerja

Setiap saluran dapat memiliki dua tautan bundle:

Saluran yang stabil – bundle normal yang ditugaskan ke saluran.
Rollout target — kandidat paket yang dirilis secara bertahap.

Sebuah rollout memerlukan paket stabil. Di dashboard, alokasikan paket stabil sebelum memilih target; dengan Publik API, paket saluran yang ada dapat version dan rolloutVersion di permintaan POST yang sama. Capgo membuat keputusan acak untuk setiap perangkat yang layak, kemudian menyimpannya menggunakan hash ID perangkat dan ID rollout. Hal itu membuat kelompok kohort tetap untuk durasi cache yang dikonfigurasi daripada berubah setiap kali periksa update.

Perubahan persentase

Capgo mempertahankan keputusan yang ada ketika bisa:

Meningkatkan persentase — perangkat yang sudah dipilih tetap dipilih; hanya sebagian kecil perangkat yang belum dipilih sebelumnya yang ditambahkan.
Turunkan persentase — sebagian kecil dari kelompok yang dipilih kembali ke bundle stabil.
Setel persentase ke 0% — tidak ada perangkat baru yang dipilih. Perangkat yang sudah menjalankan target rollout yang diaktifkan terus menerima target tersebut sampai Anda menonaktifkan, mengembalikan, atau mengubah target.
Berhenti — menghentikan perangkat baru dari memasuki sementara perangkat yang sudah menjalankan target yang diaktifkan tetap menjalankannya.
Nonaktifkan — menghentikan penyelesaian target rollout; periksa update menggunakan bundle stabil.

Jalankan rollout

Unggah dan tentukan bundle yang sudah diuji sebagai bundle stabil channel.
Muatkan paket kandidat tanpa menggantikan paket stabil.
Terbuka saluran’s Info tab, tetapkan kandidat sebagai Target, pilih persentase kecil, dan aktifkan peluncuran.
Pantau peluncuran di Amati, Log Insights, dan riwayat saluran. Tingkatkan persentase hanya setelah kohort sehat.
Ketika sudah siap, promosikan target ke stabil. Jika tidak sehat, berhentikan atau gulir kembali.

CLI contoh

Mulai peluncuran untuk bundle 1.3.0 di 5%:

npx @capgo/cli@latest channel set production com.example.app \
  --rollout-bundle 1.3.0 \
  --rollout-percentage 5 \
  --rollout-enable

Perbesar tanpa me-reseating perangkat yang sudah dipilih:

npx @capgo/cli@latest channel set production com.example.app \
  --rollout-percentage 25

Perintah unggah bundle dapat menetapkan unggahan sebagai target peluncuran dalam satu langkah ketika channel sudah memiliki bundle stabil:

npx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production \
  --rollout 5

Lihat seluruh saluran CLI referensi dan bundle CLI referensi untuk setiap opsi peluncuran.

Paus, kembali, atau promosikan

Aksi	Apakah yang dilakukan
Paus	Menghentikan perangkat baru dari memasuki peluncuran. Perangkat yang sudah ada di target yang diaktifkan tetap berada di sana.
Mulai kembali	Mengizinkan perangkat yang layak lagi memasuki.
Mengaktifkan	Menghentikan penyelesaian target rollout dan menggunakan bundle stabil.
Mengalihkan	Menghapus target, mengaktifkan ulang rollout, mengatur persentase kembali ke 0%, dan mengembalikan perangkat ke versi stabil.
Mengpromosikan	context

Halaman/area: Situs web pemasaran Capgo. Peran: Judul bagian atau halaman. Dilihat di: halaman affiliate.astro. Pesan kunci `affiliate_step2_title` (Judul Langkah 2 Affiliate).

# Stop adding devices while you investigate
npx @capgo/cli@latest channel set production com.example.app --rollout-pause

# Make the candidate stable for everyone
npx @capgo/cli@latest channel set production com.example.app --rollout-promote

# Discard the candidate and return to stable
npx @capgo/cli@latest channel set production com.example.app --rollout-rollback

Jendela terminal

Menggunakan ke dalam clipboard

Capgo dapat mengevaluasi peluncuran yang diaktifkan setiap lima menit dan bertindak ketika signal gagalnya melintasi ambang batas Anda. Ini mengukur instalasi dan gagalnya untuk target peluncuran di saluran yang dipilih dan jendela waktu, kemudian menggunakan batas kepercayaan Wilson daripada tingkat gagal yang mentah sendiri.

Auto-pause dinonaktifkan secara default. Konfigurasi bidang-bidang ini di tab saluran’s Pengenalan tab atau dengan channel set:

Batuan tingkat gagal dalam basis poin (500 = 5%). Batuan diperlukan untuk kebijakan untuk mengaktifkan.
Jendela dalam menit (default: 60).
Ketepatan antara 0 dan 1 Jangka waktu (default: 0.95).
Jangka waktu minimum percobaan dan gagal, untuk menghindari tindakan pada sampel kecil.
Kurang Tertimpa dalam menit (default: 60), yang mencegah aksi yang berulang.
Aksi: pause, rollback, atau notify.

pause menghentikan paparan rollout baru, rollback mengosongkan target dan kembali ke stabil, dan notify mengirimkan peringatan rollout tanpa mengubah pengiriman rollout.

npx @capgo/cli@latest channel set production com.example.app \
  --auto-pause-enabled \
  --auto-pause-failure-rate-bps 500 \
  --auto-pause-window-minutes 60 \
  --auto-pause-confidence 0.95 \
  --auto-pause-min-attempts 100 \
  --auto-pause-min-failures 5 \
  --auto-pause-action pause \
  --auto-pause-cooldown-minutes 120

API dan kontrol dashboard

Kamu bisa mengelola fitur yang sama melalui Saluran Publik API atau dashboard:

Buka aplikasi, kemudian Saluran.
context
Pilih saluran. Pilih.
Informasi Pilih Gunakan bagian "Rollout Progresif" untuk memilih target, persentase, durasi cache, dan kebijakan berhenti otomatis.

Untuk pengaturan saluran umum dan prioritas perangkat, lihat Salurancontext Untuk pemulihan paket darurat di luar roll-out progresif, lihat.