Progressive rollouts

このプラグインのインストールステップと完全なマークダウンガイドを含むセットアッププロンプトをコピーする

進行的ロールアウトはチャンネルの 安定したバンドル を保持し、制御されたデバイスのサブセットに別の ロールアウト対象 を配信します。全チャンネルを一度に切り替えることなく、実際の生産検証を行いたい場合に便利です。

Progressive rollout controls in a Capgo channel — Configure the rollout target, percentage, cache duration, and auto-pause policy from a channel’s Information tab.

進行的ロールアウトのしくみ

安定したバンドル

— チャンネルに割り当てられている通常のバンドル 進行的ロールアウトはチャンネルの
ロールアウト対象 — 逐次リリースされる候補バンドルのこと。

ロールアウトには安定したバンドルが必要です。ダッシュボードで、安定したバンドルを選択する前に、パブリックAPIで既存のチャネルが提供する version と rolloutVersion 同じPOSTリクエスト内で。Capgoは各エリジブルデバイスに対してランダムに決定し、デバイスIDとロールアウトIDのハッシュを使用してキャッシュします。その結果、コホートは指定されたキャッシュ期間で固定的になり、更新チェックごとに変更されなくなります。

パーセンテージの変化

Capgoは既存の決定を保存します。

パーセンテージを増加する — すでに選択されたデバイスは選択され続けます。以前選択されていなかったデバイスのランダムなサブセットのみが追加されます。
割合を下げる — 選択されたコホートのランダムなサブセットが安定バンドルに戻ります。
割合を0%に設定 — 新しいデバイスは選択されません。有効なロールアウトのターゲットを実行しているデバイスは、そのターゲットを受け続けます。有効化、ロールバック、またはターゲットの変更を実行するまで。
一時停止 — 新しいデバイスがエントリするのを止めますが、すでに有効なターゲットを実行しているデバイスはそのターゲットを受け続けます。
無効化 — ロールアウトのターゲットを解決するのを止めます。アップデートのチェックは安定バンドルを使用します。

ロールアウトを実行

テスト済みのバンドルをアップロードして、チャンネルの安定バンドルとして割り当てます。
__CAPGO_KEEP_0__
チャンネルの情報タブを開き、候補者をターゲットに設定し、小さなパーセンテージを選択し、ロールアウトを有効にします。 ロールアウトの進行状況を観察
ログインサイト、チャンネル履歴で確認し、コホートが健康であることを確認したらパーセンテージを増やします。, ロールアウトが完了したら、ターゲットを安定化します。健康でない場合は、停止またはロールバックします。__CAPGO_KEEP_0__
例

CLI example

バンドルに対してロールアウトを開始する 1.3.0 5%:

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

既に選択されているデバイスを再設定せずに増加する:

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

チャンネルがすでに安定バンドルを持っている場合、1 つのステップでアップロードコマンドを使用してアップロードをロールアウトのターゲットとして設定できます:

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

詳細を参照してくださいチャンネル CLI リファレンスとバンドル CLI リファレンスすべてのロールアウトオプションに対して

一時停止、ロールバック、またはプロモート

アクション	機能
一時停止	新しいデバイスがロールアウトに参加するのを停止します。既に有効なターゲットにいるデバイスはそのままです。
再開	新しいエリジブルデバイスが再び参加できるようにします。
無効化	ロールアウトのターゲットを解決し、安定バンドルを使用します。
ロールバック	ターゲットをクリアし、ロールアウトを無効化し、パーセンテージを0%にリセットし、デバイスを安定状態に戻します。
プロモート	コンテキスト: Capgo マーケティングウェブサイト。役割: セクションまたはページヘッダー。見られる場所: ページ affiliate.astro。メッセージキー `affiliate_step2_title` (Affiliate Step2 Title)。

ロールアウトのターゲットを安定バンドルに設定し、ロールアウトの状態をクリアします。

# 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

コピー

ターゲットバンドルを使用するまでに、プロモートまたはロールバックするまで保護されます。安定バンドルまたはロールアウトのターゲットとしてリンクされたバンドルは削除から保護されます。

Capgoは、5分ごとに有効なロールアウトを評価し、失敗信号が閾値を超えたときに行動することができます。ロールアウトの対象となるチャンネルと時間枠でインストール数と失敗数を測定し、ウィルソン信頼下限を使用して単純な失敗率のみではなく、信頼できる失敗率を算出します。

自動停止はデフォルトで無効になっています。チャンネルの情報セクションまたは channel set:

失敗率閾値 で指定します (5% = 5)。閾値はポリシーをトリガーするために必要です。500 時間枠
(デフォルト: 60)。 信頼度
の間と 0 and 1 (default:) 0.95).
オプションの最小試行回数と失敗回数を設定して、サンプルが小さすぎる場合にアクションを実行しないようにします。
Cooldown 分 (default: 60) ごとに、繰り返しアクションを防止します。
アクション: pause, rollback, または notify.

pause 新しいロールアウトの公開を停止し、ターゲットをクリアし、安定状態に戻し、ロールアウトの警告を送信します。 rollback ターミナルウィンドウ notify コピー

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 and dashboard controls

同じ機能を管理するにはパブリックチャンネルAPI またはダッシュボードを使用します:

アプリを開きます、次に チャンネル.
コンテキスト:Capgoのリリースチャンネルの機能名。ページ/エリア:Capgoのソリューションマーケティングページ。ロール:短いUIラベルまたはナビゲーションアイテム。見られる場所:ページソリューション/ホワイトラベル.astro。メッセージキー`solutions_white_label_visual_cell2_value` (ソリューション・ホワイトラベル・ビジュアル・セル2・バリュー)。
チャンネルを選択します。開く.
情報 使用する 進歩的なロールアウト

一般チャンネルルーティングとデバイスの優先順位についてはチャンネル緊急のバンドル回復のために進行中のロールアウト外で、ライブアップデートのロールバック.