一般的な制約

すべての段階的導入構成に適用される一般的な制約事項を確認してください。 これらの制約により、正常な動作が保証され、他の機能との競合が防止されます。

• エンタープライズ・ティアが必要です ：プログレッシブロールアウトはEnterpriseティアのユーザーのみ利用可能です。
• 1 フラッグにつき1ロールアウト ：プログレッシブロールアウトは、1つの機能フラグにつき1回のみ許可される。 フラグレベルでもルールレベルでも設定できるが、両方同時に設定することはできない。
• 一度に一つのアクティブな配信戦略 ：実験がフラグで実行されている場合、プログレッシブ・ロールアウトを作成することはできない。 同様に、プログレッシブロールアウトが実行中の場合、そのフラグで実験を開始することはできない。
• パーセンテージの範囲 ：ロールアウトのパーセンテージは1%から100%の間でなければならない。

スコープ別のAPI要件

使用するAPIは、段階的展開の設定の範囲によって異なります。 ロールアウトの設定を行う場所に応じて、適切なAPIを選択してください。

• フラグレベルのプログレッシブロールアウト ：機能フラグAPIを使用して、ロールアウトを作成および更新します。
• ルールレベルのプログレッシブロールアウト ：ルールAPIを使用して、ロールアウトを作成および更新する。
• ロールアウトの停止 ：アクティブなプログレッシブ・ロールアウトを停止するには、stop rollout APIを使用する。

スコープ別の構成要件

段階的なロールアウトを設定する前に、フラグまたはルールで、継承された値ではなく、明示的なロールアウト値が使用されていることを確認してください。 この要件により、競合を防ぎ、段階的な展開を完全に管理できるようになります。

• フラッグレベルのプログレッシブロールアウトの場合 ：どのターゲティングルールも、フラッグから継承された rolloutPercentage。 すべてのターゲティングルールは、オーバーライドされたロールアウト値を使用しなければならない。
• ルールレベルのプログレッシブロールアウトの場合 ：ロールアウトを追加するターゲティングルールでは、フラグから継承した値を使用することはできません。 ルールはそれ自身の明示的な値を持たなければならない。

プログレッシブ・ロールアウト中のブロック操作

段階的なロールアウトが実行中の場合、ロールアウトの整合性を維持し、競合を防ぐために、特定の操作がブロックされます。

• 別のプログレッシブロールアウトを作成する ：プログレッシブロールアウトは、1つのフラグにつき1つだけ許可されます。
• 実験の開始実験は、すでにプログレッシブ・ロールアウトが実行されているフラッグでは実行できません。
• コレクションの削除 ：コレクションの削除: コレクションの削除は、関連する機能フラグが実行状態でプログレッシブロールアウトを持つ場合、ブロックされる。
• セグメントの更新または削除 ：セグメントの更新と削除は、関連するフィーチャーフラグが実行中の状態でプログレッシブロールアウトを持っている場合、ブロックされる。
• フラグまたはルール設定の変更フラグまたはロールアウトを使用するターゲティングルールの更新は、プログレッシブロールアウトが実行されていない場合にのみ許可されます。

ライフサイクル行動

ライフサイクルの挙動を理解することで、段階的な展開と他の機能との相互作用を適切に管理できるようになります。 App Configuration では、配信戦略間を厳格に分離しています。

• 実験が進行中であれば、プログレッシブ・ロールアウトを作成することはできない。
• プログレッシブ・ロールアウトが実行されている場合、同じフラグで実験を開始することはできない。
• ロールアウトを停止するには、専用のstop rollout APIを使用する必要がある。

フラグレベルのプログレッシブロールアウトの設定

プログレッシブロールアウトをフラグレベルで設定するには

1. App Configuration、 Feature flagsに移動する。
2. フィーチャーフラグを含む環境を選択します。
3. 設定したい機能フラグをクリックします。
4. Feature rollout セクションで、 Progressiveをロールアウトタイプとして選択する。
5. ロールアウトの設定を行う：
   • 持続時間のプリセット ：あらかじめ定義されたテンプレート ( 1hr, 12hr, 24hr, 48hr ) から選択するか、 カスタムを選択します
   • フェーズ ：各フェーズをパーセンテージと期間で定義する
   • 後でスケジュールする （オプション）：このオプションを切り替えると、ロールアウトの開始時刻をUTCで指定できます。 有効になっていなければ、ロールアウトは直ちに開始される。
6. 保存 をクリックします。

プログレッシブロールアウトは、設定された開始時刻に自動的に開始される。

ルールレベルのプログレッシブロールアウトの設定

ターゲティングルールレベルでプログレッシブロールアウトを構成するには：

1. App Configuration、 Feature flagsに移動する。
2. フィーチャーフラグを含む環境を選択します。
3. 設定したい機能フラグをクリックします。
4. [ ターゲティング ] セクションで、設定したいルールを選択します。
5. ルールにオーバーライド値があることを確認する。
6. ルールのロールアウト・ セクションで、ロールアウト・タイプとしてプログレッシブを選択する。
7. ロールアウトの設定を行う：
   • 持続時間のプリセット ：あらかじめ定義されたテンプレート ( 1hr, 12hr, 24hr, 48hr ) から選択するか、 カスタムを選択します
   • フェーズ ：各フェーズをパーセンテージと期間で定義する
   • 後でスケジュールする （オプション）：このオプションを切り替えると、ロールアウトの開始時刻をUTCで指定できます。 有効になっていなければ、ロールアウトは直ちに開始される。
8. 保存 をクリックします。

フェーズ構成

段階的な導入の各フェーズについて、割合と期間を定義してください。 各フェーズは、展開の進捗を管理する2つの主要な要素で構成されています。

各段階には以下のようなものがある：

• パーセンテージ ：有効な値を受け取るユーザーの割合 (1-100%)
• 期間 ：このフェーズの継続時間 (例: " 8h ", " 30m ", " 2d ")

最終段階は完了状態を表すため、期間は必要ない。

フェーズの例

さまざまなシナリオにおける段階的導入フェーズの構成例を確認してください。

例1：段階的な24時間展開

{
  "phases": [
    { "percentage": 5, "duration": "6h" },
    { "percentage": 25, "duration": "6h" },
    { "percentage": 50, "duration": "6h" },
    { "percentage": 100, "duration": "6h" }
  ]
}

例2：1時間の迅速なロールアウト

{
  "phases": [
    { "percentage": 10, "duration": "15m" },
    { "percentage": 50, "duration": "15m" },
    { "percentage": 100, "duration": "30m" }
  ]
}

例3：保守的な48時間のロールアウト

{
  "phases": [
    { "percentage": 5, "duration": "12h" },
    { "percentage": 10, "duration": "12h" },
    { "percentage": 25, "duration": "12h" },
    { "percentage": 100, "duration": "12h" }
  ]
}

ロールアウト内

段階的な展開の各段階において、 App Configuration は各ユーザーに対する割り当てを一貫して維持し、すべてのフェーズを通じて安定した利用体験を確保します。

• entity_id によると、ランダム化は決定論的である。
• 同じ entity_id には、常に同じ代入が行われます。
• フェーズ1で有効化された値を受け取ったユーザーは、その後のフェーズでも引き続きその値を受け取ります。
• 割合が増加するにつれて、新規ユーザーが追加されます。

ロールアウト

同じフラグで新しい段階的展開を開始すると、 App Configuration は、ユーザーごとの露出パターンを変えられるよう、新しい配布を生成します。

• 新しいランダムな分布が生成されます。
• 同じ entity_id に対して、異なる代入が行われる場合があります。
• これにより、異なるユーザーグループを、それぞれ異なる展開サイクルで公開することが可能になります。