従来の環境セットアップから宣言的な構成へ Enterprise を移行することは、大きな変更です。Rollout ページでは、Enterprise 管理者がこの移行をきめ細かく制御できます。少数のパイロット org で blueprint を有効にし、自社のペースで対象を広げ、問題が発生した場合は即座にロールバックできます。Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
Enterprise のロールアウト状態
| 状態 | 意味 | 組織への影響 |
|---|---|---|
| 未有効 | Enterprise では、まだ宣言的環境が有効になっていません | どの組織にも環境ページは表示されません。すべての組織で従来のセットアップが使われます。有効にするには、Cognition 管理者にお問い合わせください。 |
| テスト中 | 手動で有効にした組織だけが宣言的環境を利用します | Enterprise 管理者が Rollout ページから各組織を個別に有効化します。それ以外の組織は引き続き従来のセットアップのままで、変更は表示されません。 |
| 利用可能 | 組織管理者に移行プロンプトが表示され、自分で切り替えられます | 従来のセットアップを利用している組織管理者には、Machine Configuration ページに移行の案内が表示されます。Enterprise 管理者の介入なしに、自分で移行できます。 |
| デフォルトで有効 | 新しい組織では宣言的環境がデフォルトになります | 新しい組織はすべて最初からブループリントが適用されます。リポジトリがあり、従来のセットアップを利用していた既存の組織には、自動的に classic オーバーライドが適用されます。 |
Testing mode の詳細
Available モードの詳細
組織ごとのオーバーライド
- In Testing or Available mode: 特定の組織でブループリントを有効にします。これらの組織は、従来のセットアップから宣言的構成にすぐに切り替わります。
- In Enabled by default mode: 特定の組織でブループリントを無効にし、従来のセットアップに戻します。これらの組織は、引き続き従来の構成を使用します。
classic オーバーライドの自動適用
推奨される移行プレイブック
フェーズ 1: 分離環境で構築・検証する (Testing)
- Enterprise 向けに 宣言的環境を有効化します。Cognition 管理者がこの機能を有効にすると、Enterprise は Testing モードになります。
- 環境設定のテスト用に、専用のテスト 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 管理者向けのオプトインを有効にする (Available)
- 社内で周知する: org 管理者に対して、宣言的な構成が利用可能になり、利用の準備が整っていることを知らせます。
- Available モードに切り替える: Rollout mode のドロップダウンを Testing から Available に変更します。従来のセットアップを利用している org 管理者には、移行を促す案内が表示されるようになります。
- org 管理者は自分の組織を移行できるようになります。enterprise blueprint がすでにベースレイヤー (ランタイム、ツール、証明書、レジストリ) を提供しているため、org 管理者は自分たちの Team や repo に固有の内容だけを構成すれば十分です。
フェーズ 3: 展開とクリーンアップ (デフォルトで有効)
- ほとんどの組織が blueprints に移行したら、Enabled by default を有効化します。これは永続的な操作です — repo を含む classic setup を使用していた組織には、自動的に classic override が適用されるため、影響はありません。
- この時点以降に作成される新しい組織は、デフォルトで blueprints から開始します。
- すべての組織の build の健全性を確認するため、Rollout ページを監視します。まだ移行していない組織を確認するには、“Classic” で絞り込みます。
- 残っている組織管理者と連携して、未移行の組織を移行します。migration assistant を使えば、この作業はスムーズに進められます。
- すべての組織が blueprints 上で確認できたら、classic override を削除します。
Classic configuration は常に保持されます。組織が blueprints に切り替わっても、何も削除されません。問題が発生した場合は、Enterprise 管理者が
per-org override を使用して Rollout ページから任意の組織を classic setup に戻せます。
移行を加速する戦略
- Testing mode で開始します (各組織を個別にオプトインできるようにするためです) 。
- まず enterprise blueprint を設定します。 admins に、共有ランタイム、ツール、証明書、registry の設定を含む enterprise blueprint をセットアップしてもらいます。これはすべての組織が継承するベースレイヤーです。
- Available mode に切り替えます。 これにより migration nudge が有効になり、組織 admins に Machine Configuration ページ上の案内が表示され、自分で移行できるようになります。
- 社内の各種チャネルでドキュメントを広く周知します。 利用可能な社内チャネル (Slack、メール、wiki) を通じて案内し、組織 admins に自分でオプトインするよう促します。migration assistant により、組織 admins はセルフサービスで移行できます。
- 現在設定済みのリポジトリが 0 の組織では自動的に有効化します。 これらの組織には移行対象がないためです。保持すべき既存の従来のセットアップがないので、ブループリントに切り替えてもリスクはありません。
- 残りの組織は 1 つずつ段階的に移行します。 enterprise blueprint がすでに設定されていれば、各組織の移行では、その上に組織固有およびリポジトリ固有の設定を追加するだけで済みます。これはゼロから移行するよりもはるかに簡単です。
- ほとんどの組織の移行が完了したら、Enabled by default を有効にします。 以後に作成される新しい組織では、ブループリントが有効な状態で開始されます。
ロールバック
org ごとのロールバック
- org は 即座に切り替わり、従来のセットアップのスナップショットを使用します。
- 従来の設定は 保持されます。org を blueprints に切り替えても失われるものはないため、元に戻しても安全です。
- アクティブなセッションには影響しません。変更は次のセッションから有効になります。
モードのロールバック
ロールバックしても、ブループリントや従来の構成が削除されることはありません。どのモードがアクティブでも両方とも保持されるため、作業内容を失うことなく Testing と Available の間を切り替えられます。
ロールアウトの健全性を監視する
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 モードの変更 (Testing → Available、「デフォルトで有効」の有効化、など)
- org ごとのオーバーライド変更 (org がオプトイン、org がオプトアウト、オーバーライドの削除)
- どの Admin がいつ変更を行ったか