Rollout Progresif

A roll-out progresif menjaga paket stabil sebuah saluran Paket stabil A roll-out progresif mengirimkan target roll-out yang terpisah Target roll-out ke sebuah subset perangkat yang dikendalikan. Ini berguna ketika Anda ingin validasi produksi nyata tanpa mengganti saluran secara keseluruhan sekaligus.

Konfigurasi target roll-out, persentase, durasi cache, dan kebijakan pause otomatis dari tab Informasi saluran.

Bagaimana roll-out progresif bekerja

Setiap saluran dapat memiliki dua tautan paket:

• Paket stabil — paket normal yang ditugaskan ke saluran.
• Target Rilis --- paket kandidat yang dirilis secara bertahap.

Sebuah rilis memerlukan paket stabil. Di dashboard, alokasikan paket stabil sebelum memilih target; dengan Publik API, sebuah saluran yang ada dapat menyediakan version dan rolloutVersion in the same POST request. Capgo makes a random decision for each eligible device, then caches it using a hash of the device ID and the rollout ID. That makes the cohort sticky for the configured cache duration instead of changing on every update check.

Tidak berarti permanen

Tidak berarti permanen

Durasi cache keputusan rilis default adalah 30 hari. Setelah itu habis, perangkat dapat dipilih lagi. Mengubah target rilis membuat ID rilis baru dan memulai kelompok baru. Anda dapat mengatur durasi cache dari 60 detik hingga 365 hari.

Capgo preserves existing decisions when it can:

• __CAPGO_KEEP_0__ mempertahankan keputusan yang ada ketika bisa: — perangkat yang sudah dipilih tetap dipilih; hanya sebagian acak dari perangkat yang belum dipilih sebelumnya yang ditambahkan.
• Turunkan persentase — sebagian acak 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

1. Unggah dan asingkan bundle yang sudah diuji sebagai bundle stabil channel.
2. Muatkan paket kandidat tanpa menggantikan paket stabil.
3. Terbuka saluran’s Info tab, tetapkan kandidat sebagai Sasaran, pilih persentase kecil, dan aktifkan roll-out.
4. Monitor roll-out di Amati, Log Insights, dan riwayat saluran. Tingkatkan persentase hanya setelah kohort sehat.
5. Ketika sudah siap, promosikan sasaran ke stabil. Jika tidak sehat, berhenti 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

Naikkan tanpa me-reseat perangkat yang sudah dipilih:

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

Perintah unggah bundle dapat menetapkan unggahannya 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 untuk memasuki peluncuran. Perangkat yang sudah ada di target yang diaktifkan tetap ada.
Mulai Lagi	Mengizinkan perangkat baru yang layak untuk memasuki lagi.
Matikan	Menghentikan penyelesaian target rollout dan menggunakan bundle stabil.
Mundur	Menghapus target, mematikan rollout, mengatur persentase kembali ke 0%, dan mengembalikan perangkat ke stabil.
Promosikan	Membuat target rollout menjadi bundle stabil, kemudian menghapus status rollout.

Gunakan satu aksi terminal pada satu waktu:

# 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

Tahan bundle target sampai Anda mempromosikannya atau mengembalikannya. Bundle yang terkait sebagai bundle stabil atau target rollout dilindungi dari penghapusan.

Kebijakan otomatis pause

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

Auto-pause dimatikan secara default. Konfigurasi lapangan-lapangan ini di tab saluran’s Pengumuman tab atau dengan channel set:

• Batuan gagal di dasar poin (%)500 (= 5%). Batuan diperlukan untuk kebijakan untuk mengaktifkan.
• Waktu 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.
• Cooldown 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:

1. Buka aplikasi, kemudian Saluran.
2. context
3. Nama fitur saluran Capgo. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Visual Putih Label Solusi). Pilih saluran..
4. Buka Informasi Pilihlah ‘__CAPGO_KEEP_0__’ untuk menggunakan fitur ini.

Untuk pengaturan saluran umum dan keutamaan perangkat, lihat Salurancontexts:Capgo saluran rilis fitur nama. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Visual Putih Label Solusi). . Untuk pemulihan bundle darurat di luar roll-out progresif, lihat.