Startseite › Entwickler-Tools › GitHub-Actions-Workflow-Generator

GitHub-Actions-Workflow-Generator

Wähle deinen Stack und erhalte eine commit-fertige .github/workflows-Datei: Trigger für Push, Pull Request, Tags und Zeitplan, eine Versions- und OS-Matrix, Caching von Abhängigkeiten, Lint-, Test- und Build-Schritte sowie optional ein Deploy auf GitHub Pages oder in die GitHub Container Registry. Minimale Berechtigungen und eine passende dependabot.yml sind enthalten.

Zuletzt aktualisiert:

Workflow
Trigger
Build-Matrix
Betriebssysteme
Schritte
Deploy & Extras

Generierte Dateien

Speichern als

    Anzeige
    Anzeige

    Anleitung: GitHub-Actions-Workflow-Generator

    1. Wähle deinen Projekttyp: Node.js, Python, Go, Java, Rust, .NET, Docker-Image oder statische Website.
    2. Lege die Trigger fest: Branches für Push und Pull Requests, optionale Tags wie v*, einen Cron-Zeitplan und manuelle Läufe.
    3. Konfiguriere die Matrix aus Sprachversionen und Betriebssystemen und bearbeite die Befehle für Installation, Lint, Test und Build.
    4. Wähle ein Deploy-Ziel (GitHub Pages oder ein Docker-Image auf GHCR) und Extras wie Caching und Artefakte.
    5. Kopiere oder lade den Workflow herunter, speichere ihn als .github/workflows/ci.yml in deinem Repository und pushe. Der Lauf erscheint im Tab Actions.

    Aufbau der Workflow-Datei

    SchlüsselBeispielBedeutung
    onpush, pull_request, schedule und workflow_dispatchEvents, die den Workflow starten
    permissionscontents: readBerechtigungsumfang des automatischen GITHUB_TOKEN
    concurrencygroup: ${{ github.workflow }}-${{ github.ref }}Nur ein Lauf pro Gruppe; ältere PR-Läufe werden abgebrochen
    jobs.<id>.runs-onubuntu-latestRunner-Image für den Job
    strategy.matrixnode: ['22', '24']Job einmal pro Kombination ausführen
    steps[].usesactions/checkout@v5Eine veröffentlichte Action in einer bestimmten Version ausführen
    steps[].runnpm testEinen Shell-Befehl ausführen
    needsneeds: testZuerst auf den Erfolg eines anderen Jobs warten
    ifgithub.ref == 'refs/heads/main'Einen Job oder Schritt nur ausführen, wenn die Bedingung wahr ist

    Vom Generator verwendete Actions

    Hauptversionen mit Stand 2025-2026. Das Festlegen auf einen Haupt-Tag liefert Fehlerbehebungen automatisch; für maximale Sicherheit der Lieferkette kannst du stattdessen auf einen vollständigen Commit-SHA festlegen und Dependabot ihn aktualisieren lassen.

    ActionVerwendet für
    actions/checkout@v5Repository in den Runner klonen
    actions/setup-node@v5, setup-python@v6, setup-go@v6, setup-java@v5 und setup-dotnet@v4Die Laufzeitumgebung der Sprache installieren, mit integriertem Caching
    pnpm/action-setup@v4pnpm vor setup-node installieren
    dtolnay/rust-toolchain und Swatinem/rust-cache@v2Rust-Toolchain und Cargo-Cache
    actions/upload-artifact@v4Build-Ausgabe zum Download aufbewahren
    actions/configure-pages@v5, upload-pages-artifact@v4 und deploy-pages@v4Auf GitHub Pages veröffentlichen
    docker/setup-buildx-action@v3, login-action@v3, metadata-action@v5 und build-push-action@v6Container-Images bauen, taggen und pushen

    Tipps für schnelle, zuverlässige CI

    • Verwende saubere Installationen (npm ci, pnpm install --frozen-lockfile), damit CI fehlschlägt, wenn die Lock-Datei veraltet ist, statt stillschweigend neue Versionen aufzulösen.
    • Halte die Matrix klein für Pull Requests; jedes OS und jede Version zu testen vervielfacht die Minuten. Teste die älteste und die neueste unterstützte Version.
    • Nutze paths-ignore für reine Doku-Änderungen, aber denk daran, dass ein erforderlicher Statuscheck, der nie läuft, den Merge blockiert.
    • Speichere Zugangsdaten als Secrets (Settings → Secrets and variables → Actions) und verweise darauf mit ${{ secrets.NAME }}; gib sie nie in Logs aus.
    • Validiere lokal mit einem YAML-Validator oder führe Workflows vor dem Pushen auf deinem Rechner mit einem Tool wie act aus.

    Häufige Fragen

    Wo lege ich die Workflow-Datei ab?

    Speichere sie in deinem Repository unter .github/workflows/ mit der Endung .yml oder .yaml, zum Beispiel .github/workflows/ci.yml, und pushe sie zu GitHub. Zeitgesteuerte Workflows laufen vom Standard-Branch, bei push- und pull_request-Events vom gepushten Branch. Die Datei dependabot.yml kommt direkt in .github/.

    Was macht die Matrix?

    strategy.matrix führt denselben Job einmal für jede Kombination von Werten aus, zum Beispiel ergeben Node.js 22 und 24 auf Ubuntu und Windows vier parallele Jobs. Setze fail-fast auf false, damit die anderen Kombinationen weiterlaufen, wenn eine fehlschlägt, so siehst du alle defekten Versionen auf einmal.

    Wie funktioniert das Caching von Abhängigkeiten?

    Die offiziellen Setup-Actions (setup-node, setup-python, setup-java, setup-go) können den Download-Ordner des Paketmanagers cachen, verschlüsselt mit dem Hash deiner Lock-Datei, sodass spätere Läufe ihn wiederverwenden, statt alles neu herunterzuladen. Dafür ist eine committete Lock-Datei wie package-lock.json oder requirements.txt nötig. Rust verwendet Swatinem/rust-cache und .NET actions/cache für den NuGet-Ordner.

    Warum permissions: contents: read setzen?

    Das automatische GITHUB_TOKEN erhält nur die Berechtigungen, die du vergibst. Nur-Lese-Zugriff auf contents reicht zum Auschecken des Codes und begrenzt den Schaden, falls ein Schritt oder eine Abhängigkeit kompromittiert wird. Jobs, die mehr brauchen, fordern es ausdrücklich an: packages: write zum Pushen von Images, pages: write und id-token: write für das Deploy auf GitHub Pages.

    Wie deploye ich eine Website mit Actions auf GitHub Pages?

    Wähle Auf GitHub Pages deployen, lege den Build-Ausgabeordner fest und stelle in den Repository-Einstellungen Pages → Source auf GitHub Actions. Der Build-Job lädt den Ordner mit actions/upload-pages-artifact hoch, und ein Deploy-Job veröffentlicht ihn mit actions/deploy-pages in der Umgebung github-pages.

    Welche Cron-Syntax verwendet der Zeitplan?

    Standard-POSIX-Cron mit 5 Feldern in UTC: Minute, Stunde, Tag des Monats, Monat, Wochentag. Zum Beispiel läuft 0 6 * * 1 jeden Montag um 06:00 UTC. Das kürzeste Intervall ist alle 5 Minuten, und geplante Läufe können sich bei hoher Auslastung verzögern.

    Welche Action-Versionen werden verwendet?

    Aktuelle Hauptversionen mit Stand 2025-2026, zum Beispiel actions/checkout@v5, actions/setup-node@v5, actions/setup-python@v6 und actions/setup-go@v6. Hauptversionen ändern sich mit der Zeit, daher prüft die generierte dependabot.yml das github-actions-Ökosystem wöchentlich und öffnet Pull Requests, wenn neue Versionen erscheinen.

    Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

    Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

    Ähnliche Tools

    Alle Code-Generatoren & Builder ansehen →