Erste Schritte mit Pipelines

Zuletzt aktualisiert am 15. Mai 2026

STACKIT Pipelines ermöglichen es Ihnen, Build-, Test- und Deployment-Aufgaben direkt in Ihrem Git-Repository zu automatisieren. Durch die Definition von Workflows in Konfigurationsdateien werden Pipelines automatisch ausgeführt, wenn bestimmte Ereignisse eintreten, wie z. B. das Pushen von Code oder das Erstellen eines Pull-Requests.

Diese Anleitung führt in die Kernkonzepte von STACKIT Pipelines ein und zeigt, wie Sie Ihren ersten Workflow erstellen und ausführen.

Voraussetzungen

Bevor Sie Ihre erste Pipeline erstellen, stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind:

Sie verfügen über eine STACKIT Git-Instanz.
Sie haben ein Repository erstellt.
Sie können Commits in das Repository pushen.

Falls Sie noch kein Repository erstellt haben, folgen Sie der Anleitung: Erstellen Sie Ihren ersten Git-Service

Kernkonzepte

Um STACKIT Pipelines effektiv zu nutzen, ist es wichtig, die folgenden Komponenten zu verstehen.

Workflow

Ein Workflow ist ein automatisierter Prozess, der einen oder mehrere Jobs ausführt. Workflows werden in YAML-Dateien definiert und im Repository gespeichert.

Workflow-Dateien müssen sich im folgenden Verzeichnis befinden:

.forgejo/workflows/

Jeder Workflow definiert:

Wann er ausgeführt werden soll.
Welche Jobs ausgeführt werden sollen.
Welche Schritte (Steps) jeder Job ausführt.

Event

Ein Event (Ereignis) löst eine Workflow-Ausführung aus.

Typische Events sind:

push – wird ausgelöst, wenn Code in einen Branch gepusht wird.
pull_request – wird ausgelöst, wenn ein Pull-Request erstellt oder aktualisiert wird.
workflow_dispatch – manuell ausgelöster Workflow.

Job

Ein Job gruppiert eine Reihe von Schritten, die auf demselben Runner ausgeführt werden.

Wichtige Merkmale:

Jeder Job wird in seiner eigenen Laufzeitumgebung ausgeführt.
Jobs werden standardmäßig parallel ausgeführt.
Jobs können von anderen Jobs abhängig sein.

Schritt

Ein Schritt (Step) stellt eine einzelne Aufgabe dar, die innerhalb eines Jobs ausgeführt wird.

Schritte können:

Shell-Befehle ausführen.
Wiederverwendbare Actions ausführen.
Build- oder Testaufgaben durchführen.

Runner

Ein Runner ist die Umgebung, in der Jobs ausgeführt werden.

STACKIT Pipelines können ausgeführt werden auf:

Von STACKIT verwalteten Runnern.
Benutzerdefinierten Runnern, die von Ihnen gehostet werden.

Runner werden mithilfe von Labels ausgewählt.

Ihre erste Pipeline

In diesem Abschnitt erstellen Sie einen einfachen Workflow, der immer dann ausgeführt wird, wenn Code in das Repository gepusht wird.

Öffnen Sie Ihr lokales Repository.
Erstellen Sie das Workflow-Verzeichnis, falls es noch nicht existiert.
```
mkdir -p .forgejo/workflows
```
Erstellen Sie eine Workflow-Datei.
```
.forgejo/workflows/hello.yaml
```

Fügen Sie die folgende Workflow-Konfiguration hinzu.

name: Hello World

on: [push]

jobs:
my-first-job:
    runs-on: stackit-linux

    steps:
    - name: Say Hello
        run: echo "Willkommen bei STACKIT Pipelines"

Committen Sie die neue Workflow-Datei.

git add .forgejo/workflows/hello.yaml
git commit -m "Ersten Pipeline-Workflow hinzufügen"

Pushen Sie die Änderungen in Ihr Repository.
```
git push
```

Pipeline-Ausführung anzeigen

Nach dem Pushen der Workflow-Datei wird die Pipeline automatisch ausgelöst.

So zeigen Sie den Pipeline-Lauf an:

Öffnen Sie Ihr STACKIT Git-Repository.
Navigieren Sie zum Bereich Actions.
Wählen Sie den neuesten Workflow-Lauf aus.
Überprüfen Sie die Job-Logs und die ausgeführten Schritte.

Sie sollten die Meldung sehen:

Willkommen bei STACKIT Pipelines

Nächste Schritte

Nachdem Ihre erste Pipeline läuft, können Sie weitere fortgeschrittene Funktionen erkunden:

Konfigurieren Sie mehrere Jobs und Abhängigkeiten.
Führen Sie Pipelines auf benutzerdefinierten Runnern aus.
Integrieren Sie STACKIT-Services.