Agile Developer Hilfe-Center › Agile Git

CI-Workflows mit eigenem Runner

Pipelines als YAML im Repository anlegen und mit einem eigenen Runner ausführen.

So funktioniert es

Workflows sind YAML-Dateien im Ordner .forgejo/workflows Ihres Repositorys. Die Syntax ist kompatibel zur verbreiteten Actions-Syntax, viele vorhandene Workflows laufen unverändert.

Agile Git stellt keinen gemeinsamen Runner bereit. Die Jobs laufen auf einem eigenen Runner, den Sie auf einem Rechner Ihrer Wahl verbinden, etwa auf einem Server, Laptop oder in Ihrer Cloud. Ohne Runner bleiben Workflows stehen. Verwaltete Runner können Sie bei info@agiledeveloper.de anfragen.

Runner verbinden

  1. Installieren Sie Forgejo Runner auf Ihrem Rechner. Die Anleitung steht unter https://forgejo.org/docs/latest/admin/actions/runner-installation/.
  2. Öffnen Sie Einstellungen des Repositorys → Aktionen → Runner.
  3. Klicken Sie auf Neuen Runner erstellen, vergeben Sie einen Namen und klicken Sie auf Erstellen.
  4. Die nächste Seite zeigt Token und Befehle zum Einrichten. Kopieren Sie das Token sofort, es erscheint nur einmal.
  5. Starten Sie den Runner. Seine Labels legen Sie in der Konfiguration des Runners fest.
  6. Prüfen Sie unter Runner, ob als Status nicht mehr Offline steht, und notieren Sie die Labels.

Einen Runner für mehrere Repositorys richten Sie unter denselben Menüpunkten in den Einstellungen der Organisation oder Ihres Kontos ein.

Ein Runner führt den Code aus den Workflows auf Ihrem Rechner aus. Wählen Sie den Rechner entsprechend und seien Sie vorsichtig bei Repositorys, in die andere schreiben dürfen.

Erster Workflow

Legen Sie .forgejo/workflows/ci.yml an:

name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: docker
    container: node:22
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

Der Wert bei runs-on muss einem Label Ihres Runners entsprechen. Nach dem Push sehen Sie den Lauf im Reiter Actions.

Geheimnisse und Variablen

Unter Einstellungen des Repositorys → Aktionen finden Sie:

  • Geheimnisse: Werte wie Tokens, angelegt über Geheimnis hinzufügen. Sie werden an Workflows weitergegeben und lassen sich nicht anderweitig auslesen.
  • Variablen: weitere Werte für Ihre Workflows.

Beides gibt es auch für Organisationen und Ihr Konto.

Status im Pull Request

Die Ergebnisse erscheinen direkt im Pull Request. Über eine Branch-Schutzregel mit Statusprüfung aktivieren ist der Merge erst möglich, wenn die Checks grün sind.

Aufbewahrung

Protokolle der Jobs bleiben 365 Tage gespeichert, hochgeladene Artefakte 90 Tage. Artefakte zählen zu Ihrem Speicher.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 1. November 2026

Weitere Artikel zu Agile Git

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.