> ## 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 全体で宣言的な環境設定を段階的にロールアウトするためのガイド: ロールアウト状態、org ごとの上書き、段階的な移行プレイブック、モニタリング。

従来の環境セットアップから宣言的な構成へ Enterprise を移行することは、大きな変更です。Rollout ページでは、Enterprise 管理者がこの移行をきめ細かく制御できます。少数のパイロット org で blueprint を有効にし、自社のペースで対象を広げ、問題が発生した場合は即座にロールバックできます。

<div id="enterprise-rollout-states">
  ## Enterprise のロールアウト状態
</div>

Rollout ページには、組織でブループリントをどのように利用できるかを制御する **Rollout mode** セレクターがあります。モードは 3 つあり、これに加えて、宣言的環境が有効になる前の初期状態があります。

| 状態           | 意味                               | 組織への影響                                                                                         |
| ------------ | -------------------------------- | ---------------------------------------------------------------------------------------------- |
| **未有効**      | Enterprise では、まだ宣言的環境が有効になっていません | どの組織にも環境ページは表示されません。すべての組織で従来のセットアップが使われます。有効にするには、Cognition 管理者にお問い合わせください。                   |
| **テスト中**     | 手動で有効にした組織だけが宣言的環境を利用します         | Enterprise 管理者が Rollout ページから各組織を個別に有効化します。それ以外の組織は引き続き従来のセットアップのままで、変更は表示されません。               |
| **利用可能**     | 組織管理者に移行プロンプトが表示され、自分で切り替えられます   | 従来のセットアップを利用している組織管理者には、Machine Configuration ページに移行の案内が表示されます。Enterprise 管理者の介入なしに、自分で移行できます。 |
| **デフォルトで有効** | 新しい組織では宣言的環境がデフォルトになります          | 新しい組織はすべて最初からブループリントが適用されます。リポジトリがあり、従来のセットアップを利用していた既存の組織には、自動的に classic オーバーライドが適用されます。      |

移行の流れは **テスト中 → 利用可能 → デフォルトで有効** です。**テスト中** と **利用可能** の間は、**Rollout mode** ドロップダウンを使って自由に切り替えられます。ただし、**デフォルトで有効** は恒久的な操作であり、Cognition 管理者に依頼しない限り元に戻せません。

<Warning>
  **デフォルトで有効は恒久的です。** このモードを有効にすると、Cognition 管理者に連絡しない限り、テスト中または利用可能には戻せません。このモードを有効にする前に、enterprise blueprint が十分に検証されており、ほとんどの組織がブループリントに移行していることを確認してください。
</Warning>

<div id="testing-mode-details">
  ### Testing mode の詳細
</div>

Testing mode の状態では、オプトインしていない組織は引き続き従来のセットアップを利用し、利用体験に変更はありません。Enterprise 管理者は、Rollout ページから個別の org をオプトインできます。宣言的構成に切り替わるのは、それらの org のみです。これは、Enterprise で宣言的環境が最初に有効化される際のベースライン モードです。

<div id="available-mode-details">
  ### Available モードの詳細
</div>

Available モードでは、移行の案内が追加されます: まだ従来のセットアップを利用している org 管理者に対して、Machine Configuration ページに宣言的構成への移行を促すコールアウトが表示されます。これによってセットアップが変更されたり、完全な環境構成ページへのアクセスが与えられたりすることはありません。これは、blueprints が利用可能であることを知らせ、自分でオプトインするための導線を提供するだけです。これは、周知を進めるとともに、org 管理者がそれぞれのペースで移行できるようにするのに役立ちます。

<div id="per-org-overrides">
  ## 組織ごとのオーバーライド
</div>

Enterprise 管理者は、Rollout ページの組織ごとのテーブルから、個別の組織のロールアウト状態を直接オーバーライドできます。

* **In Testing or Available mode**: 特定の組織でブループリントを**有効に**します。これらの組織は、従来のセットアップから宣言的構成にすぐに切り替わります。
* **In Enabled by default mode**: 特定の組織でブループリントを**無効に**し、従来のセットアップに戻します。これらの組織は、引き続き従来の構成を使用します。

オーバーライドは永続的です。モードが変わっても維持されます。Testing mode の間に組織でブループリントを有効にした場合、その組織は Available または Enabled by default に移行してもブループリントのままです。

<div id="automatic-classic-overrides">
  ### classic オーバーライドの自動適用
</div>

**Enabled by default** を有効化する際は、安全機構によって影響の発生を防ぎます。現在 classic setup を使用しており、**リポジトリが設定されている** org には、自動的に明示的な classic オーバーライドが適用されます。つまり、この移行によって classic setup をアクティブに利用している org の動作が変わることはありません。これらの org は、明示的に移行するまで現在の状態が維持されます。

リポジトリがない org (またはすでに blueprints を使用している org) は、この保護の対象外です。

<div id="recommended-migration-playbook">
  ## 推奨される移行プレイブック
</div>

最適な進め方は、org 管理者に公開する前に、独立した環境で設定を構築し、検証することです。一気に移行するのではなく、まずは限定的に開始し、確認したうえで段階的に拡大してください。

<div id="phase-1-build-and-verify-in-isolation-testing">
  ### フェーズ 1: 分離環境で構築・検証する (Testing)
</div>

まず、Enterprise を **Testing** モードで開始します。org は独自にオプトインできないため、完全に制御できます。

1. Enterprise 向けに **宣言的環境を有効化**します。Cognition 管理者がこの機能を有効にすると、Enterprise は Testing モードになります。
2. 環境設定のテスト用に、**専用のテスト org** を作成します。この org は、blueprints の検証専用です。
3. このテスト org でのみ、**宣言的構成**を有効化します (Rollout ページの org ごとの上書き設定を使用) 。
4. **Enterprise blueprint を設定**します。共有の language runtimes、セキュリティ ツール、社内証明書、内部 CLI、プロキシ設定、registry 認証をすべてインストールします。これは、すべての org が継承するベース レイヤーです。
5. テスト org 用に、org レベルのツールや registry 設定を含む **org blueprint** を設定します。
6. 代表的な一連のリポジトリに対して **repository blueprints** を追加します。最も一般的な技術スタックをカバーするリポジトリを選んでください。
7. **エンドツーエンドで検証**します。これらのリポジトリで Devin セッションを開始し、すべてが正しく動作することを確認します。リポジトリがクローンされ、依存関係がインストールされ、lint/test/build コマンドが正しく実行され、すべてのツールが想定どおりのバージョンであることを確認してください。

<Tip>
  ビルドの成功だけを確認してはいけません。ビルドがグリーンでも、環境が正しく機能しているとは限りません。PATH エントリの不足、ツールのバージョン違い、registry 認証の不足は見逃されることがあります。必ず実際の Devin セッションを
  実行して確認してください。
</Tip>

<div id="phase-2-enable-opt-in-for-org-admins-available">
  ### フェーズ 2: org 管理者向けのオプトインを有効にする (Available)
</div>

enterprise → org → repo の blueprint スタックが正しく組み合わさり、動作する Environment が生成されることを確認したら、次の手順を実施します。

1. **社内で周知する**: org 管理者に対して、宣言的な構成が利用可能になり、利用の準備が整っていることを知らせます。
2. **Available モードに切り替える**: Rollout mode のドロップダウンを Testing から Available に変更します。従来のセットアップを利用している org 管理者には、移行を促す案内が表示されるようになります。
3. **org 管理者は自分の組織を移行できるようになります**。enterprise blueprint がすでにベースレイヤー (ランタイム、ツール、証明書、レジストリ) を提供しているため、org 管理者は自分たちの Team や repo に固有の内容だけを構成すれば十分です。

各 org 管理者は、**migration assistant** を利用してこの作業を簡単に進められます。Devin は org の既存の snapshot を確認し、同等の blueprint 構成を自動生成できます。手順の詳細は、[宣言的な構成への移行](/ja/onboard-devin/environment/migration) を参照してください。

一般的によく使われる技術スタック (Node.js、Python、Java、Go、複数言語のモノレポ) 向けに template blueprint のライブラリを作成し、org 管理者がゼロから始めなくて済むよう社内で共有してください。[Template library](/ja/onboard-devin/environment/templates) は、その出発点として適しています。

<div id="phase-3-expand-and-clean-up-enabled-by-default">
  ### フェーズ 3: 展開とクリーンアップ (デフォルトで有効)
</div>

1. ほとんどの組織が blueprints に移行したら、**Enabled by default を有効化**します。これは永続的な操作です — repo を含む classic setup を使用していた組織には、自動的に classic override が適用されるため、影響はありません。
2. この時点以降に作成される**新しい組織**は、デフォルトで blueprints から開始します。
3. すべての組織の build の健全性を確認するため、**Rollout ページを監視**します。まだ移行していない組織を確認するには、"Classic" で絞り込みます。
4. **残っている組織管理者と連携して**、未移行の組織を移行します。migration assistant を使えば、この作業はスムーズに進められます。
5. すべての組織が blueprints 上で確認できたら、**classic override を削除**します。

<Info>
  Classic configuration は常に保持されます。組織が blueprints に切り替わっても、何も削除されません。問題が発生した場合は、Enterprise 管理者が
  per-org override を使用して Rollout ページから任意の組織を classic setup に戻せます。
</Info>

<div id="accelerated-migration-strategy">
  ### 移行を加速する戦略
</div>

迅速に移行したい Enterprise 向けに、組織ごとの移行負担を最小限に抑える進め方を紹介します。

1. **Testing mode で開始します** (各組織を個別にオプトインできるようにするためです) 。
2. **まず enterprise blueprint を設定します。** admins に、共有ランタイム、ツール、証明書、registry の設定を含む enterprise blueprint をセットアップしてもらいます。これはすべての組織が継承するベースレイヤーです。
3. **Available mode に切り替えます。** これにより migration nudge が有効になり、組織 admins に Machine Configuration ページ上の案内が表示され、自分で移行できるようになります。
4. **社内の各種チャネルでドキュメントを広く周知します。** 利用可能な社内チャネル (Slack、メール、wiki) を通じて案内し、組織 admins に自分でオプトインするよう促します。migration assistant により、組織 admins はセルフサービスで移行できます。
5. **現在設定済みのリポジトリが 0 の組織では自動的に有効化します。** これらの組織には移行対象がないためです。保持すべき既存の従来のセットアップがないので、ブループリントに切り替えてもリスクはありません。
6. **残りの組織は 1 つずつ段階的に移行します。** enterprise blueprint がすでに設定されていれば、各組織の移行では、その上に組織固有およびリポジトリ固有の設定を追加するだけで済みます。これはゼロから移行するよりもはるかに簡単です。
7. **ほとんどの組織の移行が完了したら、Enabled by default を有効にします。** 以後に作成される新しい組織では、ブループリントが有効な状態で開始されます。

この方法では、まず enterprise blueprint の設定 (最も効果の大きい作業) を前倒しで行い、その後は各組織が最小限の労力でそれぞれのペースで移行できるようにします。

<div id="rolling-back">
  ## ロールバック
</div>

すべてが常に順調に進むとは限りません。ロールアウトシステムでは、あらゆるレベルでロールバックが可能です。

<div id="per-org-rollback">
  ### org ごとのロールバック
</div>

Enterprise 管理者は、Rollout ページから個々の org を従来のセットアップに戻せます。

* org は **即座に切り替わり**、従来のセットアップのスナップショットを使用します。
* 従来の設定は **保持されます**。org を blueprints に切り替えても失われるものはないため、元に戻しても安全です。
* アクティブなセッションには影響しません。変更は次のセッションから有効になります。

<div id="mode-rollback">
  ### モードのロールバック
</div>

Enterprise 管理者は、Rollout mode ドロップダウンを使用して **Testing** と **Available** を自由に切り替えることができます。これは、問題を調査している間、セルフサービスでの移行を一時停止したい場合に便利です。

<Warning>
  **Enabled by default** は Enterprise 管理者では元に戻せません。Enabled by default から戻す必要がある場合は、Cognition 管理者に連絡してください。org ごとのオーバーライドは引き続き使用でき、個々の org をいつでも従来のセットアップに戻せます。
</Warning>

<Info>ロールバックしても、ブループリントや従来の構成が削除されることはありません。どのモードがアクティブでも両方とも保持されるため、作業内容を失うことなく Testing と Available の間を切り替えられます。</Info>

<div id="monitoring-rollout-health">
  ## ロールアウトの健全性を監視する
</div>

ロールアウトページには、Enterprise 全体における移行の進捗を追跡するためのダッシュボードが用意されています。

<div id="kpi-row">
  ### KPI 行
</div>

ページ上部のサマリー指標で、ロールアウトの状況をすばやく把握できます。

* **Blueprint orgs**: 現在ブループリントを使用している組織数
* **Rollout percentage**: 全組織に占める、ブループリントを使用している組織の割合
* **Build health**: ブループリントを使用している組織全体のビルドの総合的な状態

<div id="per-org-table">
  ### 組織別テーブル
</div>

KPI の下に、各組織の詳細を示すテーブルがあります。

| Column              | Description                                   |
| ------------------- | --------------------------------------------- |
| **Organization**    | 組織名                                           |
| **State**           | 現在のモード: Blueprints または Classic                |
| **Override**        | 組織の状態が Enterprise のデフォルトではなく、明示的に上書きされているかどうか |
| **Classic repos**   | Classic の設定があるリポジトリ数                          |
| **Blueprint repos** | Blueprints があるリポジトリ数                          |
| **Latest build**    | 直近のビルドのステータス (成功、一部成功、失敗など)                   |

<div id="filtering">
  ### フィルタリング
</div>

次の条件でテーブルを絞り込みます:

* **All**: Enterprise 内のすべての org
* **Blueprints**: 現在 Blueprints を使用している org
* **Classic**: 現在 Classic セットアップを使用している org
* **Overrides**: 状態が明示的にオーバーライドされている org (いずれの方向も含む)

<div id="concurrency-safety">
  ## 同時実行時の安全性
</div>

状態遷移は、同時に行われる変更から保護されています。ページを読み込んでから変更を送信するまでの間に別の管理者が Enterprise の状態を変更した場合、そのリクエストは競合エラーとして拒否されます。

これにより、複数の Enterprise 管理者が同時に操作したときの意図しない上書きを防げます。変更が拒否された場合は、ページを更新して現在の状態を確認し、必要に応じて再送信してください。

<div id="audit-logging">
  ## 監査ログ
</div>

ロールアウト状態のすべての遷移は、監査ログに記録されます。

* Enterprise モードの変更 (Testing → Available、「デフォルトで有効」の有効化、など)
* org ごとのオーバーライド変更 (org がオプトイン、org がオプトアウト、オーバーライドの削除)
* どの Admin がいつ変更を行ったか

これらのログは、お使いの Enterprise の標準的な監査ログインターフェースから確認できます。