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:
Generierte Dateien
Speichern als
Anleitung: GitHub-Actions-Workflow-Generator
- Wähle deinen Projekttyp: Node.js, Python, Go, Java, Rust, .NET, Docker-Image oder statische Website.
- Lege die Trigger fest: Branches für Push und Pull Requests, optionale Tags wie v*, einen Cron-Zeitplan und manuelle Läufe.
- Konfiguriere die Matrix aus Sprachversionen und Betriebssystemen und bearbeite die Befehle für Installation, Lint, Test und Build.
- Wähle ein Deploy-Ziel (GitHub Pages oder ein Docker-Image auf GHCR) und Extras wie Caching und Artefakte.
- Kopiere oder lade den Workflow herunter, speichere ihn als
.github/workflows/ci.ymlin deinem Repository und pushe. Der Lauf erscheint im Tab Actions.
Aufbau der Workflow-Datei
| Schlüssel | Beispiel | Bedeutung |
|---|---|---|
on | push, pull_request, schedule und workflow_dispatch | Events, die den Workflow starten |
permissions | contents: read | Berechtigungsumfang des automatischen GITHUB_TOKEN |
concurrency | group: ${{ github.workflow }}-${{ github.ref }} | Nur ein Lauf pro Gruppe; ältere PR-Läufe werden abgebrochen |
jobs.<id>.runs-on | ubuntu-latest | Runner-Image für den Job |
strategy.matrix | node: ['22', '24'] | Job einmal pro Kombination ausführen |
steps[].uses | actions/checkout@v5 | Eine veröffentlichte Action in einer bestimmten Version ausführen |
steps[].run | npm test | Einen Shell-Befehl ausführen |
needs | needs: test | Zuerst auf den Erfolg eines anderen Jobs warten |
if | github.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.
| Action | Verwendet für |
|---|---|
actions/checkout@v5 | Repository in den Runner klonen |
actions/setup-node@v5, setup-python@v6, setup-go@v6, setup-java@v5 und setup-dotnet@v4 | Die Laufzeitumgebung der Sprache installieren, mit integriertem Caching |
pnpm/action-setup@v4 | pnpm vor setup-node installieren |
dtolnay/rust-toolchain und Swatinem/rust-cache@v2 | Rust-Toolchain und Cargo-Cache |
actions/upload-artifact@v4 | Build-Ausgabe zum Download aufbewahren |
actions/configure-pages@v5, upload-pages-artifact@v4 und deploy-pages@v4 | Auf GitHub Pages veröffentlichen |
docker/setup-buildx-action@v3, login-action@v3, metadata-action@v5 und build-push-action@v6 | Container-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.