Enterprise のロールアウト状態
| State | What it means | Effect on organizations |
|---|---|---|
| Disabled | Enterprise でブループリントが有効になっていません | どの組織にも環境ページは表示されません。すべての組織で従来のセットアップが利用されます。 |
| Default Off | ブループリントは利用可能ですが、デフォルトではありません | Enterprise 管理者は組織ごとに個別に有効化できます。新しい組織は従来のセットアップで開始されます。 |
| Default On | ブループリントがすべての組織でデフォルトになります | 明示的に従来のセットアップへ切り替えない限り、すべての組織でブループリントが利用されます。新しい組織はブループリントで開始されます。 |
デフォルトオフの詳細
組織ごとのオーバーライド
- In Default Off: 特定の組織で blueprints を有効にします。これらの組織は、従来のセットアップから宣言的構成にすぐに切り替わります。
- In Default On: 特定の組織で blueprints を無効にし、従来のセットアップに戻します。これらの組織は、引き続き従来の構成を使用します。
classic オーバーライドの自動適用
推奨される移行プレイブック
フェーズ 1: 分離環境で構築・検証する (Default Off)
- Enterprise レベルで blueprints を有効化 し、Disabled から Default Off に切り替えます。
- 環境設定のテスト用に、専用のテスト org を作成します。この org は、blueprints の検証専用です。
- このテスト org でのみ、宣言的構成を有効化します (Rollout ページの org ごとの上書き設定を使用) 。
- Enterprise blueprint を設定します。共有の language runtimes、セキュリティ ツール、社内証明書、内部 CLI、プロキシ設定、registry 認証をすべてインストールします。これは、すべての org が継承するベース レイヤーです。
- テスト org 用に、org レベルのツールや registry 設定を含む org blueprint を設定します。
- 代表的な一連のリポジトリに対して repository blueprints を追加します。最も一般的な技術スタックをカバーするリポジトリを選んでください。
- エンドツーエンドで検証します。これらのリポジトリで Devin セッションを開始し、すべてが正しく動作することを確認します。リポジトリがクローンされ、依存関係がインストールされ、lint/test/build コマンドが正しく実行され、すべてのツールが想定どおりのバージョンであることを確認してください。
フェーズ 2: org 管理者向けのオプトインを有効にする
- 社内で周知する: org 管理者に対して、宣言的な構成が利用可能になり、利用の準備が整っていることを知らせます。
- 移行の促しを有効にする: 「Show migration nudge to all organizations」をオンにして、従来のセットアップを利用している org 管理者に、移行を促す案内が表示されるようにします。
- org 管理者は自分の組織を移行できるようになります。enterprise blueprint がすでにベースレイヤー (ランタイム、ツール、証明書、レジストリ) を提供しているため、org 管理者は自分たちの Team や repo に固有の内容だけを構成すれば十分です。
フェーズ 3: 展開とクリーンアップ
- ほとんどの組織が blueprints に移行したら、Default On に切り替えます。repo を含む classic setup を使用していた組織には、自動的に classic override が適用されるため、影響はありません。
- この時点以降に作成される新しい組織は、デフォルトで blueprints から開始します。
- すべての組織の build の健全性を確認するため、Rollout ページを監視します。まだ移行していない組織を確認するには、“Classic” で絞り込みます。
- 残っている組織管理者と連携して、未移行の組織を移行します。migration assistant を使えば、この作業はスムーズに進められます。
- すべての組織が blueprints 上で確認できたら、classic override を削除します。
Classic configuration は常に保持されます。組織が blueprints に切り替わっても、何も削除されません。問題が発生した場合は、Enterprise 管理者が
Rollout ページから任意の組織を即座に classic setup に戻せます。
ロールバック
org ごとのロールバック
- org は 即座に切り替わり、従来のセットアップのスナップショットを使用します。
- 従来の設定は 保持されます。org を blueprints に切り替えても失われるものはないため、元に戻しても安全です。
- アクティブなセッションには影響しません。変更は次のセッションから有効になります。
Enterprise 全体のロールバック
- 明示的なブループリントのオーバーライドが設定されていた org は、その設定が維持されます。引き続きブループリントが適用されます。
- オーバーライドがなく、デフォルトでブループリントを使用していた org は、従来のセットアップに戻ります。
- これは安全な操作です。どちらの方向でも設定データが失われることはありません。
ロールバックしても、ブループリントや従来の構成が削除されることはありません。どのモードがアクティブでも両方とも保持されるため、作業内容を失うことなく切り替えられます。
ロールアウトの健全性を監視する
KPI 行
- Blueprint orgs: 現在ブループリントを使用している組織数
- Rollout percentage: 全組織に占める、ブループリントを使用している組織の割合
- Build health: ブループリントを使用している組織全体のビルドの総合的な状態
組織別テーブル
| Column | Description |
|---|---|
| Organization | 組織名 |
| State | 現在のモード: Blueprints または Classic |
| Override | 組織の状態が Enterprise のデフォルトではなく、明示的に上書きされているかどうか |
| Classic repos | Classic の設定があるリポジトリ数 |
| Blueprint repos | Blueprints があるリポジトリ数 |
| Latest build | 直近のビルドのステータス (成功、一部成功、失敗など) |
フィルタリング
- All: Enterprise 内のすべての org
- Blueprints: 現在 Blueprints を使用している org
- Classic: 現在 Classic セットアップを使用している org
- Overrides: 状態が明示的にオーバーライドされている org (いずれの方向も含む)
同時実行時の安全性
監査ログ
- Enterprise の状態変更 (無効 → デフォルトでオフ、デフォルトでオフ → デフォルトでオン、など)
- org ごとのオーバーライド変更 (org がオプトイン、org がオプトアウト、オーバーライドの削除)
- どの Admin がいつ変更を行ったか