Enterprise 環境の概要

Enterprise 全体にわたる環境管理: ブループリント階層、Enterprise ブループリントの設定、シークレット、Enterprise 全体の再ビルド。

前提条件: このガイドは、宣言的な環境構成に関する知識があることを前提としています。概要については、宣言的な環境構成を参照してください。

環境を構成する前に、SCM プロバイダーが接続済みであること (Enterprise Settings > Integrations) 、および各組織に対象リポジトリへのアクセス権が付与されていること (Enterprise Settings > Repository Permissions) を確認してください。組織は、明示的にアクセス権が付与されるまで、環境にリポジトリを追加できません。詳しくは、Git Integrationsを参照してください。

Enterprise 管理者は、Enterprise 内のすべての組織に適用されるベース環境を定義できます。これにより、各組織やリポジトリがその上に独自の設定を重ねてカスタマイズできるようにしつつ、Devin が利用するツール、ランタイム、セキュリティインフラストラクチャを一元的に管理できます。

​

ブループリントの階層

Devinの環境設定は、3層の階層構造になっています。各層は、その上位の層を土台として構成されます。

+-----------------------------------------+
|  Enterprise Blueprint                   |
|  Python 3.12, Node 20, security tools   |
+-----------------------------------------+
|  Organization Blueprint                 |
|  private npm registry, team linting     |
+-----------------------------------------+
|  Repository Blueprint                   |
|  npm install, project-specific config   |
+-----------------------------------------+

ティア	Who manages it	Scope
Enterprise	Enterprise 管理者	すべての組織、すべてのリポジトリ
Organization	org 管理者	組織内のすべてのリポジトリ
Repository	org 管理者またはリポジトリ設定	単一のリポジトリ

この関係は累積的です。org およびリポジトリのブループリントは Enterprise ブループリントの上に積み重なる形で適用され、置き換えるものではありません。ビルドのたびに、まず Enterprise ブループリントが実行され、ベースラインが確立されます。次にorg のブループリントが実行され、チーム固有の設定が追加されます。最後に、各リポジトリのブループリントが実行され、プロジェクト固有のセットアップが適用されます。

org およびリポジトリのブループリントの関係については、Blueprint のスコープを参照してください。

​

Enterprise ブループリントの設定

Enterprise ブループリントを定義するには、Settings > Devin’s base environment に移動します。形式は org および repo のブループリントと同じで、initialize、maintenance、knowledge の各セクションで構成されます。Enterprise および org ブループリントは、すべてのリポジトリのクローンとセットアップが完了した後に実行されるコマンド用の post-build セクションにも対応しています。

Enterprise ブループリントは、org および repo のブループリントより前に、すべてのビルド で最初に実行されます。つまり、Enterprise レベルでインストールされたツールやランタイムは、後続のすべてのブループリントで利用できます。

​

Enterprise ブループリントに含めるもの

Enterprise ブループリントには、すべての組織で必要となるツールや設定を含めます。一般的な利用例は次のとおりです。

​

標準的な言語ランタイム

Enterprise 全体で言語のバージョンを固定し、すべてのチームが同じツールチェーンで作業できるようにします:

initialize:
  - name: "Install Python 3.12"
    uses: github.com/actions/setup-python@v5
    with:
      python-version: "3.12"

  - name: "Install Node.js 20"
    uses: github.com/actions/setup-node@v4
    with:
      node-version: "20"

  - name: "Install Go 1.22"
    uses: github.com/actions/setup-go@v5
    with:
      go-version: "1.22"

​

セキュリティツールとコンプライアンススキャン

すべてのプロジェクトで利用が必須のスキャナーと監査ツールをインストールします：

initialize:
  - name: "Install security tools"
    run: |
      npm install -g snyk
      pip install safety bandit
      curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh

​

社内向けCLIツールとユーティリティ

社内専用のツールをすべての環境に配布します:

initialize:
  - name: "Install internal CLI"
    run: |
      curl -L https://internal.example.com/cli/latest/linux-amd64 \
        -o /usr/local/bin/internal-cli
      chmod +x /usr/local/bin/internal-cli

​

共有パッケージレジストリ設定

パッケージマネージャーが社内レジストリを参照するよう設定します。

initialize:
  - name: "Configure internal registries"
    run: |
      npm config set registry https://npm.internal.example.com/
      pip config set global.index-url https://pypi.internal.example.com/simple/

​

社内プロキシと証明書の設定

社内CA証明書をインストールし、プロキシ設定を行います。

initialize:
  - name: "Install corporate certificates"
    run: |
      cp "$FILE_CORPORATE_CA_CERT" /usr/local/share/ca-certificates/corporate-ca.crt
      update-ca-certificates
      echo 'export NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/corporate-ca.crt' >> ~/.bashrc

​

ティアの連携

ビルド中は、各ティアのステップが決まった順序で実行されます。前のティアの出力は後のティアで利用できます。Enterprise レベルでインストールされたツールは、再インストールしなくても org や repo のブループリントですぐに利用できます。

ビルドでは、次の順序で新しいスナップショットが作成されます。

1. Enterprise blueprint (runs in ~):
   a. initialize
   b. maintenance
2. Organization blueprint (runs in ~):
   a. initialize
   b. maintenance
3. Clone all repositories (up to 10 concurrent)
4. For each configured repo, in the order shown in Settings
   (runs in ~/repos/<repo-name>):
   a. initialize
   b. maintenance
5. post-build (org- and enterprise-level; runs in ~)
6. ヘルスチェック後、スナップショットを保存

post-build ステップは、すべての repo のクローンとセットアップが完了した後に実行されるため、完全に構成された環境を検証できます。post-build ステップがゼロ以外の終了コードを返すと、ビルドは失敗し、スナップショットは生成されません。詳しくは、Blueprintリファレンスの post-build を参照してください。

ティアは累積的です。repo ブループリントでは、org または enterprise ブループリントにインストールされたツールを利用できます。下位のティアで上位のティアが設定した内容を上書きすることはできません。ビルドには通常 5～15 分かかります。各コマンドは 1 時間でタイムアウトします。

すべてのティアのknowledgeアイテムが収集され、Devin で利用できるようになります。複数のティアで同じ名前の knowledge アイテムが定義されている場合は、それらがすべて含まれます。互いに上書きされることはありません。

​

Enterprise シークレット

Enterprise 管理者は、Enterprise レベルでシークレットを定義できます。これらのシークレットは、ビルド専用としてマークされていない限り、Enterprise、org、repo のブループリントステップを問わず、すべての組織にわたるすべてのビルドとすべてのセッションで、環境変数として利用できます。

Enterprise シークレットは、会社全体で共有する認証情報に使用してください。

• 社内パッケージレジストリのトークン
• 社内プロキシ認証
• 社内サービス用の共有 APIキー
• Enterprise 向けツールのライセンスキー

Enterprise シークレットは、Enterprise ブループリントエディタ内の Secrets タブで管理します。ブループリント設定とあわせて Enterprise 全体のシークレットを管理するには、Settings > Devin’s base environment に移動し、Secrets タブに切り替えてください。

Enterprise シークレットの管理には、ManageAccountResources 権限が必要です。

org のシークレットが Enterprise シークレットと同じ名前の場合は、org のシークレットが優先されます。これにより、必要に応じて各組織で Enterprise 全体のデフォルトを上書きできます。

​

ビルド専用の Enterprise シークレット

Enterprise シークレット を追加するときに Build only を有効にすると、その secret の用途は environment setup のみに限定されます。ビルド専用の secret は、スナップショットのビルド中に enterprise ブループリントと org ブループリントのステップからのみ利用できます。リポジトリがクローンされる前に削除されるため、repo ブループリントのステップや post-build ステップからは読み取れず、Devin セッションでも一切利用できません。この設定を有効にした secret には、secret の一覧に Build only バッジが表示されます。

​

Enterprise全体の再ビルド

Enterprise管理者は、すべての組織に対して連鎖的に適用される再ビルドをトリガーできます。これは次のような場合に役立ちます。

• Enterpriseブループリントを更新した場合 (例: Python を 3.11 から 3.12 にアップグレード)
• Enterpriseシークレットをローテーションした場合
• セキュリティパッチ適用後にすべての環境を更新する必要がある場合

Enterprise全体の再ビルドは、Settings > Devin’s base environment からトリガーします。各組織のビルドは、更新後のEnterpriseブループリントを使用して実行され、その後に各組織固有のorgブループリントとrepoブループリントが続きます。

Enterprise全体の再ビルドでは、各orgのビルドキューが尊重されます。あるorgですでにビルドが進行中の場合、Enterpriseによってトリガーされた再ビルドはその後ろにキューされます。すでにビルドがキューされている場合は、それはキャンセルされ、 Enterpriseによってトリガーされたものに置き換えられます。

​

組織全体のロールアウトを管理する

ロールアウトページでは、組織ごとの環境の健全性とブループリントの適用状況をEnterprise全体で確認できます。ブループリントがない組織や、ビルドが失敗または滞留している組織を特定する際に利用します。

段階的なブループリント導入のプレイブックとビルドの健全性に関するガイダンスについては、ロールアウトの健全性を参照してください。

​

関連ページ

• シナリオ: ACME Corpの成長に合わせて — 会社の成長に合わせてティアを選ぶ実践的な使用例

• ロールアウトの健全性
• ベストプラクティス
• Blueprintリファレンス
• 宣言的環境構成