Roll-out progresif

Copy untuk AI Sudah siap untuk dipasang sambil menjalankan versi terpisah target untuk dirollout ke dalam subset perangkat yang dikendalikan. Ini berguna ketika Anda ingin validasi produksi nyata tanpa mengganti saluran seluruhnya sekaligus.

Konfigurasi target dirollout, persentase, durasi cache, dan kebijakan berhenti otomatis dari tab Informasi saluran.

Bagaimana cara kerja dirollout yang progresif

Setiap saluran dapat memiliki dua tautan bundle:

• Bundle stabil — bundle normal yang ditugaskan ke saluran.
• Target dirollout — bundle kandidat yang dirilis secara bertahap.

Sebuah peluncuran memerlukan sebuah bundle stabil. Di dashboard, alokasikan bundle stabil sebelum memilih target; dengan Publik API, sebuah saluran yang ada dapat menyediakan version dan rolloutVersion dalam permintaan POST yang sama. Capgo membuat keputusan acak untuk setiap perangkat yang layak, kemudian menyimpannya menggunakan hash dari ID perangkat dan ID peluncuran. Itu membuat kelompok itu menempel selama durasi cache yang disesuaikan bukan berubah setiap kali cek pembaruan.

Sticky tidak berarti permanen

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

Perubahan persentase

Capgo mempertahankan keputusan yang ada ketika bisa:

• Meningkatkan persentase — perangkat yang sudah dipilih tetap dipilih; hanya sebuah subset acak dari perangkat yang belum dipilih sebelumnya yang ditambahkan.
• Mengurangi 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.
• Paus — menghentikan perangkat baru dari memasuki sementara perangkat yang sudah menjalankan target yang diaktifkan tetap menjalankannya.
• Nonaktifkan — menghentikan resolusi target rollout; periksa update menggunakan bundle stabil.

Lakukan rollout

1. Unggah dan asosiasikan bundle yang telah diuji sebagai bundle stabil kanal.
2. Unggah bundle kandidat tanpa menggantikan bundle stabil.
3. Buka kanal’s Informasi tab, tentukan kandidat sebagai Target, pilih persentase kecil, dan aktifkan peluncuran.
4. Monitor peluncuran di Amati, Log Insight, dan riwayat saluran. Tingkatkan persentase hanya setelah kohort sehat.
5. Ketika sudah siap, promosikan target ke stabil. Jika tidak sehat, berhenti atau gulung 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

Tingkatkan 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 rollout 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 rincian referensi channel CLI dan bundle CLI referensi untuk setiap opsi peluncuran.

Tangguh, kembali, atau promosikan

Aksi	Apa yang dilakukan
Tangguh	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 kembali.
Matikan	Menghentikan penyelesaian target peluncuran dan menggunakan bundle stabil.
Kembali ke versi sebelumnya	Menghapus target, mematikan peluncuran, mengatur persentase kembali ke 0%, dan mengembalikan perangkat ke versi stabil.
Promosikan	Membuat target peluncuran menargetkan bundle stabil, kemudian menghapus status peluncuran.

Hanya 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

Jaga bundle target tersedia sampai Anda mempromosikannya atau mengembalikannya ke versi sebelumnya. Bundle yang terhubung sebagai bundle stabil atau target peluncuran dilindungi dari penghapusan.

Kebijakan otomatis pause

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

Otomatis pause dimatikan secara default. Konfigurasi lapangan-lapangan ini di saluran’s Informasi dengan tombol tab atau channel set:

• Frekuensi gagal ambang batas dalam basis poin (500 = 5%). Ambang batas diperlukan untuk mengaktifkan kebijakan.
• Jendela dalam menit (default: 60).
• Ketepatan antara 0 dan 1 (default: 0.95).
• Jumlah minimum upaya dan gagal, untuk menghindari bertindak pada contoh kecil.
• Masa tunggu dalam menit (default: 60), yang mencegah aksi yang sama berulang.
• Aksi: pause, rollback, atau notify.

pause menghentikan penayangan rollout baru, rollback membersihkan 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

Anda dapat mengelola fitur yang sama melalui Saluran Publik API atau dashboard:

1. Buka aplikasi, kemudian Saluran.
2. Pilih saluran.
3. Buka Informasi.
4. Gunakan Rollout Progresif bagian untuk memilih target, persentase, durasi cache, dan kebijakan pause otomatis.

Untuk routing saluran umum dan keutamaan perangkat, lihat Saluran. Untuk pemulihan bundle darurat di luar proses rollout berkelanjutan, lihat Mengembalikan update hidup.