Skip to main content
Enterprise 環境の設定は、組織内のすべてのチームに必要なインフラストラクチャを対象としています。たとえば、VPN 接続、CA 証明書、プロキシ設定、DNS オーバーライドなどです。このページでは、Enterprise 固有の概念について説明します。一般的な環境設定については、環境設定 ガイドを参照してください。

Enterprise レベルに含めるもの

Enterprise Settings > Environment に移動します (または、任意の org の Environment Settings ページから “Enterprise-wide setup” をクリックします) 。YAML の形式は org および repo レベルの設定と同一で、initializemaintenanceknowledge の各セクションが同じように適用されます。
ユースケースEnterpriseOrg-wideRepo-level
VPN / ネットワークアクセス
CA 証明書
プロキシ設定
DNS オーバーライド
GPG commit 署名
共有 language runtimes
Org-wide CLI ツール
非公開 registry 認証
repo の dependencies
repo 固有の test/lint
Enterprise の変更は影響範囲が大きくなります。 保存すると、すべての 組織でビルドがトリガーされます。Enterprise レベルで適用する前に、まず単一の org で (org-wide 設定を利用して) インフラ関連のコマンドをテストしてください。
Enterprise レベルの設定では repositories をクローンできません。リポジトリのクローンには org レベルのアクセスが必要です。Enterprise 設定は共有インフラストラクチャ (VPN、証明書、ツール) にのみ利用してください。repo のクローンは org レベルで自動的に処理されます。
VPN、CA 証明書、プロキシ、プライベートレジストリ の使用例については、Configuration Examples ページの Enterprise の使用例 を参照してください。

Enterprise の権限

操作必要なロール
Enterprise 設定の閲覧 / 編集Enterprise Admin
org 設定の閲覧 / 編集Org Admin または Enterprise Admin
repo 設定の閲覧任意の org メンバー
repo 設定の編集ManageOrgSnapshots 権限を持つメンバー

ビルドの連鎖

Enterprise の設定を変更すると:
  1. すべての 組織で新しいビルドがトリガーされます
  2. 各組織のビルドには、Enterprise の設定 → 組織の設定 → すべての repo の設定が含まれます
  3. ビルドは組織ごとに独立して実行されるため、ある組織の失敗が他の組織に影響することはありません
  4. 各組織には専用のマシンイメージが割り当てられます
Enterprise の initialize ステップでは順序が重要です。 最初に VPN (内部ホストに到達できるようにするため) 、次に DNS (名前解決できるようにするため) 、その次に証明書 (HTTPS を機能させるため) 、次にプロキシ (トラフィックを正しくルーティングするため) 、最後に内部ソースからダウンロードするツールを配置する必要があります。

複数組織の管理

推奨される設定順序:
  1. まず Enterprise 設定 — 共有インフラストラクチャ (VPN、証明書、プロキシ) を設定します
  2. 次にorg-wide 設定 — 各 org の管理者が共有ツールとレジストリへのアクセスを設定します
  3. 最後にリポジトリ固有の設定 — 各チームがそれぞれのリポジトリを設定します
各 org には専用のマシンイメージが割り当てられます。Enterprise 設定は共有され、追加的に適用されますが、org レベルおよび repo レベルの設定にはスコープがあります。つまり、Org A の設定が Org B に影響することはなく、ある org で ビルド が失敗しても他の org には影響しません。org 構造の詳細については、組織の仕組みを理解するを参照してください。 設定の階層 (Enterprise → Org → Repo) は厳密に追加方式です。各レベルのコマンドは、1 つ上のレベルの処理が完了した後に順番に実行されます。下位レベルでは、上位レベルで設定された内容を上書きしたり変更したりすることはできません。

Enterprise の移行

レガシーな対話型セットアップから宣言型構成に移行する Enterprise 向け:
  1. まず Enterprise レベルの YAML を設定します — VPN、証明書、プロキシ設定などの共有インフラストラクチャを対象とします。
  2. org は 1 つずつ移行します。 各 org にはそれぞれ「レガシーのマシンスナップショットを利用する」トグルがあるため、ほかのチームに影響を与えずに段階的に移行できます。
  3. テスト用 org を検討します。 大規模な Enterprise では、本番 org に展開する前に宣言型構成を検証するため、専用のテスト組織を作成してください。
  4. 大規模展開には Devin を利用します。 Devin は並列セッションで repo を設定できます。repo ごとに 1 つのセッションを起動すると、Devin が設定案を自動生成します。これは 10〜100 以上の repo を導入する場合に適しています。
完全な移行ガイド (ステップごとのワークフローとテスト方法を含む) については、Migrating from interactive setupを参照してください。

次のステップ