ブループリントでのGitHub Actions

ツールのインストール用にシェルスクリプトを書く代わりに、ブループリントのinitializeセクションでGitHub Actionsを直接参照できます。Devinはスナップショットのビルド時にそのアクションをダウンロードして実行します。これは、GitHubのCIランナーがアクションのステップを実行するのと同じ仕組みです。これは、setup-python、setup-node、setup-goのような言語セットアップ用アクションで特に便利です。これらは、バージョン管理やPATHの設定を自動的に処理します。

構文

ブループリントの initialize セクションに uses ステップを追加します:

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

フィールド	型	説明
`name`	string (optional)	ビルドログに表示される、人が理解しやすいラベル
`uses`	string	GitHub Action の参照 (形式は以下の書式を参照)
`with`	map (optional)	アクションに渡す入力パラメータ
`env`	map (optional)	ステップ用の追加の環境変数

ステップでは、run (シェルコマンド) または uses (アクション) のいずれか一方を指定する必要があり、両方は指定できません。

uses ステップは maintenance ではサポートされていません。uses を含む maintenance ステップは、'uses' steps are not supported in maintenance sections ... Actions can only run during initialize. というエラーでスナップショットのビルドが失敗します。アクションは initialize に配置し、maintenance には run ステップのみを記述してください。組織レベルおよび Enterprise レベルの post-build ステップでもアクションを利用できます。

アクションの参照形式

github.com/<owner>/<repo>@<ref>
github.com/<owner>/<repo>/<subpath>@<ref>

github.com/ プレフィックスと @<ref> サフィックスは、どちらも必須です。ref は通常、v5 のようなバージョンタグです。 使用例:

リファレンス	解決先
`github.com/actions/setup-python@v5`	タグ `v5` の `actions/setup-python`
`github.com/actions/setup-node@v4`	タグ `v4` の `actions/setup-node`
`github.com/gradle/actions/setup-gradle@v4`	`gradle/actions` リポジトリ、`setup-gradle` サブディレクトリ、タグ `v4`

入力の指定

アクションに入力を渡すには、with フィールドを使用します。すべての値は、GitHub Actions の動作に合わせて文字列として扱われます。

initialize:
  - uses: github.com/actions/setup-java@v4
    with:
      java-version: "21"
      distribution: "temurin"

with の値では、必ずバージョン番号を引用符で囲んでください。YAML は引用符のない 3.10 を浮動小数点数 3.1 として解釈してしまうため、意図した動作になりません。代わりに python-version: "3.10" と記述してください。

環境変数の設定

env フィールドを利用して、1 つのアクションステップのみに適用される環境変数を設定します。

initialize:
  - uses: github.com/actions/setup-node@v4
    with:
      node-version: "20"
    env:
      RUNNER_DEBUG: "1"

アクションによって設定された環境変数 (GITHUB_ENV または GITHUB_PATH 経由) は、ブループリント内の以降のステップにも自動的に引き継がれます。

使用例

特定のバージョンを指定した Python プロジェクト

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

maintenance: |
  pip install -r requirements.txt

knowledge:
  - name: test
    contents: pytest

多言語プロジェクト

initialize:
  - name: Install Node.js
    uses: github.com/actions/setup-node@v4
    with:
      node-version: "20"
  - name: Install Python
    uses: github.com/actions/setup-python@v5
    with:
      python-version: "3.12"
  - name: Install Go
    uses: github.com/actions/setup-go@v5
    with:
      go-version: "1.22"

アクションとシェルコマンドを組み合わせる

アクションとシェルコマンドは、同じセクション内で自由に組み合わせて使えます。

initialize:
  - name: Install Python
    uses: github.com/actions/setup-python@v5
    with:
      python-version: "3.12"
  - name: Install project tools
    run: pip install ruff pytest
  - name: Install Node.js
    uses: github.com/actions/setup-node@v4
    with:
      node-version: "20"
  - name: Install frontend deps
    run: npm install -g pnpm

Gradle を使用する Java プロジェクト

initialize:
  - name: Install JDK 21
    uses: github.com/actions/setup-java@v4
    with:
      java-version: "21"
      distribution: "temurin"
  - name: Install Gradle
    uses: github.com/gradle/actions/setup-gradle@v4

maintenance: |
  ./gradlew dependencies

knowledge:
  - name: build
    contents: ./gradlew build
  - name: test
    contents: ./gradlew test

Actions とシェルスクリプト

Actions を使う必要はありません。通常のシェルコマンドで十分です。Actions は、同等のシェルスクリプトが長くなったり、ミスしやすくなったりする場合に便利です。

GitHub Actions を使う場合
同等のシェルスクリプト

initialize:
  - uses: github.com/actions/setup-go@v5
    with:
      go-version: "1.23"

initialize: |
  GO_VERSION=1.23.5
  ARCH=$(dpkg --print-architecture)
  curl -fsSL "https://go.dev/dl/go${GO_VERSION}.linux-${ARCH}.tar.gz" \
    | sudo tar -xz -C /usr/local
  echo 'export PATH="/usr/local/go/bin:$HOME/go/bin:$PATH"' \
    | sudo tee /etc/profile.d/golang.sh > /dev/null

仕組み

Devinは、スナップショットのビルド中にusesステップを検出すると、次の処理を行います。

アクションのリポジトリをダウンロードします (ピン留めされた ref の shallow clone)
アクションのaction.ymlメタデータを読み取り、アクションの種類 (runs.using) とエントリポイントを特定します
INPUT_*、GITHUB_*、RUNNER_*変数を使って実行環境を構築します
種類に応じてアクションを実行します:
- Node.jsアクション — preスクリプト (定義されている場合) を実行し、その後mainを実行します
- コンポジットアクション — runs.stepsの各ステップを順に実行します。ネストされたrunおよびusesステップも含まれます
- Dockerアクション — アクションのDockerfileからイメージをビルド (またはdocker://イメージをプル) し、その後コンテナを実行します。定義されている場合はpre-entrypointも実行します
副作用を引き継ぎます — アクションがGITHUB_PATHまたはGITHUB_ENVに書き込んだエントリは、後続のブループリントのステップに適用されます

Actionsは実際のGitHubワークフローの外で実行されます。github.repositoryのような前提情報変数にはスタブ値が設定されます。GitHub APIへのライブアクセスを必要とするActions (例: PRへのコメント、リリースの作成) は、ブループリントでは動作しません。

制限事項

サポートされるアクションの種類 — ブループリントは以下のアクションの種類 (runs.using) をサポートしています:
アクションの種類サポート
Node.js (node16、node20、node24) あり
コンポジット (composite) あり
Docker (docker) Linux ビルドのみ。Windows ビルドでは非対応。
maintenance では利用不可 — uses ステップは initialize と post-build で実行できますが、maintenance では実行できません。構文を参照してください。
post ライフサイクルなし — ビルドは使い捨ての VM 上で実行されるため、Devin は pre と main のステップ (および Dockerアクションの pre-entrypoint) は実行しますが、post のクリーンアップステップ (post と post-entrypoint) はスキップします。
GitHub 前提情報はスタブ — GitHub APIコール、ワークフローのイベントデータ、またはリポジトリの前提情報に依存する action は、これらの値がビルド環境ではプレースホルダーであるため、正しく動作しない場合があります。
バージョンを固定する — 再現可能なビルドのため、ブランチ名ではなく、必ず特定のバージョンタグ (例: @v5) を参照してください。

Get Started

Essential Guidelines

Onboarding Devin

Working with Devin

Product Guides

Integrations

Admin

Release Notes

ブループリントでのGitHub Actions

構文

アクションの参照形式

入力の指定

環境変数の設定

使用例

特定のバージョンを指定した Python プロジェクト

多言語プロジェクト

アクションとシェルコマンドを組み合わせる

Gradle を使用する Java プロジェクト

Actions とシェルスクリプト

仕組み

制限事項

アクションの種類	サポート
Node.js (`node16`、`node20`、`node24`)	あり
コンポジット (`composite`)	あり
Docker (`docker`)	Linux ビルドのみ。Windows ビルドでは非対応。

​構文

​アクションの参照形式

​入力の指定

​環境変数の設定

​使用例

​特定のバージョンを指定した Python プロジェクト

​多言語プロジェクト

​アクションとシェルコマンドを組み合わせる

​Gradle を使用する Java プロジェクト

​Actions とシェルスクリプト

​仕組み

​制限事項

​関連ページ

構文

アクションの参照形式

入力の指定

環境変数の設定

使用例

特定のバージョンを指定した Python プロジェクト

多言語プロジェクト

アクションとシェルコマンドを組み合わせる

Gradle を使用する Java プロジェクト

Actions とシェルスクリプト

仕組み

制限事項

関連ページ