前提条件: このガイドは、宣言的な環境構成に関する知識があることを前提としています。概要については、宣言的な環境構成を参照してください。
ブループリントの階層
Devinの環境設定は、3層の階層構造になっています。各層は、その上位の層を土台として構成されます。
この関係は累積的です。org およびリポジトリのブループリントは Enterprise ブループリントの上に積み重なる形で適用され、置き換えるものではありません。ビルドのたびに、まず Enterprise ブループリントが実行され、ベースラインが確立されます。次にorg のブループリントが実行され、チーム固有の設定が追加されます。最後に、各リポジトリのブループリントが実行され、プロジェクト固有のセットアップが適用されます。
org およびリポジトリのブループリントの関係については、Blueprint のスコープを参照してください。
Enterprise ブループリントの設定
Enterprise ブループリントを定義するには、Enterprise Settings > Environments に移動し、Blueprint タブを開きます。形式は 組織 および リポジトリ のブループリントと同じで、initialize、maintenance、knowledge の各セクションで構成されます。Enterprise および 組織 ブループリントは、すべてのリポジトリのクローンとセットアップが完了した後に実行されるコマンド用の post-build セクションにも対応しています。
Enterprise ブループリントは、組織 および リポジトリ のブループリントより前に、すべてのビルド で最初に実行されます。つまり、Enterprise レベルでインストールされたツールやランタイムは、後続のすべてのブループリントで利用できます。
Enterprise ブループリントに含めるもの
Enterprise ブループリントには、すべての組織で必要となるツールや設定を含めます。一般的な利用例は次のとおりです。標準的な言語ランタイム
Enterprise 全体で言語のバージョンを固定し、すべてのチームが同じツールチェーンで作業できるようにします:セキュリティツールとコンプライアンススキャン
すべてのプロジェクトで利用が必須のスキャナーと監査ツールをインストールします:社内向けCLIツールとユーティリティ
社内専用のツールをすべての環境に配布します:共有パッケージレジストリ設定
パッケージマネージャーが社内レジストリを参照するよう設定します。社内プロキシと証明書の設定
社内CA証明書をインストールし、プロキシ設定を行います。ティアの連携
ビルド中は、各ティアのステップが決まった順序で実行されます。前のティアの出力は後のティアで利用できます。Enterprise レベルでインストールされたツールは、再インストールしなくても 組織 や リポジトリ のブループリントですぐに利用できます。 ビルドでは、次の順序で新しいスナップショットが作成されます。post-build ステップは、すべての リポジトリ のクローンとセットアップが完了した後に実行されるため、完全に構成された環境を検証できます。post-build ステップがゼロ以外の終了コードを返すと、ビルドは失敗し、スナップショットは生成されません。詳しくは、ブループリントリファレンスの post-build を参照してください。
ティアは累積的です。リポジトリ ブループリントでは、組織 または enterprise ブループリントにインストールされたツールを利用できます。下位のティアで上位のティアが設定した内容を上書きすることはできません。ビルドには通常 5~15 分かかります。各コマンドは 3 時間でタイムアウトします。
すべてのティアのknowledgeアイテムが収集され、Devin で利用できるようになります。複数のティアで同じ名前の knowledge アイテムが定義されている場合は、それらがすべて含まれます。互いに上書きされることはありません。
Enterprise シークレット
Enterprise 管理者は、Enterprise レベルでシークレットを定義できます。これらのシークレットは、ビルド専用としてマークされていない限り、Enterprise、組織、リポジトリ のブループリントステップを問わず、すべての組織にわたるすべてのビルドとすべてのセッションで、環境変数として利用できます。 Enterprise シークレットは、会社全体で共有する認証情報に使用してください。- 社内パッケージレジストリのトークン
- 社内プロキシ認証
- 社内サービス用の共有 APIキー
- Enterprise 向けツールのライセンスキー
Enterprise シークレットの管理には、ManageAccountResources 権限が必要です。
ビルド専用の 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全体の再ビルドでは、各組織のビルドキューが尊重されます。ある組織ですでにビルドが進行中の場合、Enterpriseによってトリガーされた再ビルドはその後ろにキューされます。すでにビルドがキューされている場合は、それはキャンセルされ、
Enterpriseによってトリガーされたものに置き換えられます。
組織全体のロールアウトを管理する
ロールアウトページでは、組織ごとの環境の健全性とブループリントの適用状況をEnterprise全体で確認できます。ブループリントがない組織や、ビルドが失敗または滞留している組織を特定する際に利用します。 段階的なブループリント導入のプレイブックとビルドの健全性に関するガイダンスについては、ロールアウトの健全性を参照してください。関連ページ
- シナリオ: ACME Corpの成長に合わせて — 会社の成長に合わせてティアを選ぶ実践的な使用例

