GitHub Actions in Blueprints

Anstatt Shell-Skripte zum Installieren von Tools zu schreiben, können Sie GitHub Actions direkt im Abschnitt initialize Ihres Blueprints angeben. Devin lädt die Action während des Snapshot-Builds herunter und führt sie aus – genauso wie die CI-Runner von GitHub Actions Actionschritte ausführen. Das ist besonders nützlich für Actions zum Einrichten von Sprachen wie setup-python, setup-node und setup-go, die Versionsverwaltung und PATH-Konfiguration automatisch übernehmen.

Syntax

Fügen Sie im Abschnitt initialize Ihres Blueprints einen uses-Schritt hinzu:

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

Feld	Typ	Beschreibung
`name`	string (optional)	Menschenlesbare Bezeichnung, die in Build-Logs angezeigt wird
`uses`	string	GitHub Action-Referenz (siehe Format unten)
`with`	map (optional)	Eingabeparameter, die an die Action übergeben werden
`env`	map (optional)	Zusätzliche Umgebungsvariablen für den Schritt

Ein Schritt muss entweder run (ein Shell-Befehl) oder uses (eine Action) angeben, nicht beides.

uses-Schritte werden in maintenance nicht unterstützt. Ein maintenance-Schritt mit uses lässt den Snapshot-Build mit 'uses' steps are not supported in maintenance sections ... Actions can only run during initialize. fehlschlagen. Platzieren Sie Actions in initialize und beschränken Sie maintenance auf run-Schritte. post-build-Schritte auf Organisations- und Enterprise-Ebene können ebenfalls Actions verwenden.

Format für Aktionsreferenzen

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

Sowohl das Präfix github.com/ als auch das Suffix @<ref> sind erforderlich. Die Ref ist in der Regel ein Versions-Tag wie v5. Beispiele:

Referenz	Worauf sie verweist
`github.com/actions/setup-python@v5`	`actions/setup-python` mit Tag `v5`
`github.com/actions/setup-node@v4`	`actions/setup-node` mit Tag `v4`
`github.com/gradle/actions/setup-gradle@v4`	Repo `gradle/actions`, Unterverzeichnis `setup-gradle`, Tag `v4`

Eingaben übergeben

Verwenden Sie das Feld with, um Eingaben an die Action zu übergeben. Alle Werte werden als Strings behandelt, entsprechend dem Verhalten von GitHub Actions:

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

Versionsnummern in with-Werten immer in Anführungszeichen setzen. YAML interpretiert 3.10 ohne Anführungszeichen als Fließkommazahl 3.1 – und das ist nicht gewollt. Schreiben Sie stattdessen python-version: "3.10".

Umgebungsvariablen festlegen

Verwenden Sie das Feld env, um Umgebungsvariablen festzulegen, die auf einen einzelnen Aktionsschritt beschränkt sind:

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

Von einer Aktion gesetzte Umgebungsvariablen (über GITHUB_ENV oder GITHUB_PATH) werden automatisch an die nachfolgenden Schritte im Blueprint weitergegeben.

Beispiele

Python-Projekt mit einer bestimmten Python-Version

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

Mehrsprachiges Projekt

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"

Actions mit Shell-Befehlen kombinieren

Actions und Shell-Befehle können im selben Abschnitt beliebig kombiniert werden:

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

Java-Projekt mit Gradle

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 vs. Shell-Skripte

Sie müssen keine Actions verwenden — normale Shell-Befehle funktionieren genauso gut. Actions sind praktisch, wenn das entsprechende Shell-Skript lang oder fehleranfällig wäre.

Mit GitHub Actions
Entsprechendes Shell-Skript

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

Wie es funktioniert

Wenn Devin während eines Snapshot-Builds auf einen uses-Schritt stößt:

Lädt das Action-Repo herunter (flacher Klon der angepinnten Ref)
Liest die action.yml-Metadaten der Action, um den Action-Typ (runs.using) und die Einstiegspunkte zu bestimmen
Erstellt die Ausführungsumgebung mit den Variablen INPUT_*, GITHUB_* und RUNNER_*
Führt die Action je nach Typ aus:
- Node.js-Actions — führt das pre-Skript (falls definiert) und anschließend main aus
- Composite-Actions — führt jeden Schritt in runs.steps der Reihe nach aus, einschließlich verschachtelter run- und uses-Schritte
- Docker-Actions — erstellt das Image aus dem Dockerfile der Action (oder lädt ein docker://-Image) und startet dann den Container, einschließlich pre-entrypoint, falls definiert
Überträgt Nebeneffekte — alle Einträge, die die Action in GITHUB_PATH oder GITHUB_ENV schreibt, werden auf nachfolgende Blueprint-Schritte angewendet

Actions werden außerhalb eines echten GitHub-Workflows ausgeführt. Kontextvariablen wie github.repository werden mit Platzhalterwerten befüllt. Actions, die Live-Zugriff auf die GitHub-API erfordern (z. B. Kommentare zu Pull Requests oder das Erstellen von Releases), funktionieren in Blueprints nicht.

Einschränkungen

Unterstützte Action-Typen — Blueprints unterstützen diese Action-Typen (runs.using):
Action-Typ Unterstützt
Node.js (node16, node20, node24) Ja
Komposit (composite) Ja
Docker (docker) Nur Linux-Builds. Nicht unterstützt bei Windows-Builds.
Nicht in maintenance — uses-Schritte laufen in initialize und post-build, können aber nicht in maintenance ausgeführt werden. Siehe Syntax.
Kein post-Lebenszyklus — Devin führt die Schritte pre und main aus (sowie pre-entrypoint einer Docker-Action), überspringt aber post-Bereinigungsschritte (post und post-entrypoint), da Builds in kurzlebigen VMs ausgeführt werden.
GitHub-Kontext als Platzhalter — Actions, die auf GitHub-API-Aufrufe, Workflow-Ereignisdaten oder Repository-Kontext angewiesen sind, funktionieren möglicherweise nicht korrekt, da diese Werte in der Build-Umgebung nur Platzhalter sind.
Versionen anpinnen — Verwenden Sie für reproduzierbare Builds immer ein bestimmtes Versions-Tag (z. B. @v5) statt eines Branchnamens.

Devin Desktop

Agent Command Center

Releases

Windsurf Plugins

Accounts

Security

GitHub Actions in Blueprints

Syntax

Format für Aktionsreferenzen

Eingaben übergeben

Umgebungsvariablen festlegen

Beispiele

Python-Projekt mit einer bestimmten Python-Version

Mehrsprachiges Projekt

Actions mit Shell-Befehlen kombinieren

Java-Projekt mit Gradle

Actions vs. Shell-Skripte

Wie es funktioniert

Einschränkungen

Action-Typ	Unterstützt
Node.js (`node16`, `node20`, `node24`)	Ja
Komposit (`composite`)	Ja
Docker (`docker`)	Nur Linux-Builds. Nicht unterstützt bei Windows-Builds.

​Syntax

​Format für Aktionsreferenzen

​Eingaben übergeben

​Umgebungsvariablen festlegen

​Beispiele

​Python-Projekt mit einer bestimmten Python-Version

​Mehrsprachiges Projekt

​Actions mit Shell-Befehlen kombinieren

​Java-Projekt mit Gradle

​Actions vs. Shell-Skripte

​Wie es funktioniert

​Einschränkungen

​Verwandte Seiten

Syntax

Format für Aktionsreferenzen

Eingaben übergeben

Umgebungsvariablen festlegen

Beispiele

Python-Projekt mit einer bestimmten Python-Version

Mehrsprachiges Projekt

Actions mit Shell-Befehlen kombinieren

Java-Projekt mit Gradle

Actions vs. Shell-Skripte

Wie es funktioniert

Einschränkungen

Verwandte Seiten