コンテンツにジャンプ
Capgo - Capacitor アプリ向けのライブアップデート Capgo

Progressive rollouts

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

Progressive rollout controls in a Capgo channel
進行的ロールアウトの制御は__CAPGO_KEEP_0__チャンネル

ロールアウトの対象、割合、キャッシュ期間、自動停止ポリシーをチャンネルの情報タブから設定します。

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

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

  • 各チャンネルには2つのバンドルリンクがあります: 安定したバンドル
  • ロールアウト対象 — 逐次リリースされる候補バンドルのこと。

ロールアウトには安定したバンドルが必要です。ダッシュボードで、安定したバンドルを選択する前に、対象を割り当てます。Public API では、既存のチャネルが提供できます。 version と 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.

デフォルトのロールアウト決定キャッシュ期間は 30 日間です。期限切れ後、デバイスは再び選択できます。ロールアウト対象を変更すると、新しいロールアウト ID が生成され、新しいコホートが開始されます。キャッシュ期間を 60 秒から 365 日まで設定できます。

パーセンテージの変化

Capgo preserves existing decisions when it can:

  • __CAPGO_KEEP_0__ は、可能な限り既存の決定を保存します:パーセンテージを増やす — すでに選択されたデバイスは選択状態が維持されます。以前選択されていなかったデバイスのランダムなサブセットのみが追加されます。
  • 選択率を下げる — 選択されたコホートのランダムなサブセットが安定バンドルに戻ります。
  • 選択率を0%に設定 — 新しいデバイスは選択されません。有効なロールアウトターゲットを実行しているデバイスは、そのターゲットを受け続けます。ロールバック、またはターゲットを変更するまで。
  • ロールアウトを停止 — 新しいデバイスがロールアウトターゲットに追加されなくなる。すでにロールアウトターゲットを実行しているデバイスはそのターゲットを受け続ける。
  • ロールアウトを無効化 — ロールアウトターゲットの解決が停止され、更新チェックは安定バンドルを使用します。

ロールアウトを実行

タイトル:ロールアウトを実行
  1. テスト済みのバンドルをアップロードして、チャンネルの安定バンドルとして割り当てます。
  2. __CAPGO_KEEP_0__
  3. チャンネルの 情報 ターゲット 設定小さな割合を選択し、ロールアウトを有効にします。
  4. ロールアウトの進行状況を 観察, ログインサイトとチャンネル履歴で確認し、コホートが健康であることを確認したらのみ割合を増やします。
  5. ロールアウトが準備できたら、ターゲットを安定化してください。健康でない場合は、停止またはロールバックしてください。

CLIの例

CLI の例

バンドルを対象にロールアウトを開始する 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

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

ターミナル画面
npx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production \
  --rollout 5

詳細を参照する チャンネル CLI リファレンス ページ内で使用される短いUIラベルやナビゲーションアイテム バンドル CLI リファレンス すべてのロールアウトオプションに対して

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

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

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

1 つのターミナル アクションを使用するときは次のとおりです:
# 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 コピー

__CAPGO_KEEP_0__ とダッシュボードのコントロール
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とダッシュボードのコントロール

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

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

一般チャンネルルーティングとデバイスの優先順位については チャンネルページ/エリア: Capgoのソリューションマーケティングページ。ロール: 短いUIラベルまたはナビゲーションアイテム。見つける場所: page solutions/white-label.astro。メッセージキー `solutions_white_label_visual_cell2_value` (ソリューション・ホワイト・ラベル・ビジュアル・セル2値)。 緊急のバンドル回復のために、進行中のロールアウト外で、.