2 Actions
frank edited this page 2026-10-29 13:44:45 +01:00

Forgejo Actions

forge workflow startet Workflows, forge run verwaltet deren Ausführungen. Die verfügbaren Endpunkte hängen von der Forgejo-Version ab.

Workflows

  • forge workflow list: Workflows auflisten, wenn die Instanz diesen Endpunkt anbietet.
  • forge workflow run <workflow> --ref <branch-oder-tag>: Workflow per workflow_dispatch starten.
forge workflow list --repo frank/forgecli
forge workflow run ci.yml --ref main --repo frank/forgecli

workflow list ist nicht im öffentlichen Forgejo-17-API-Schema enthalten und kann deshalb auf der Instanz mit einem API-Fehler enden. Ein Workflow benötigt den Trigger workflow_dispatch, um über workflow run gestartet zu werden.

Runs und Jobs

  • forge run list: Runs auflisten.
  • forge run view <run-id>: Details eines Runs anzeigen.
  • forge run watch <run-id> --interval 3s: Status bis zum Abschluss verfolgen, einschließlich cancelled und skipped.
  • forge run jobs <run-id>: Jobs eines Runs auflisten.
  • forge run job <job-id>: Einen Job einschließlich Schritten anzeigen (Forgejo 17+).
  • forge run cancel <run-id>: Einen wartenden oder laufenden Run abbrechen (Forgejo 16+).
  • forge run rerun <run-id> oder forge run rerun --job <job-id>: Einen abgeschlossenen Run oder Job erneut starten (Forgejo 17+).
  • forge run delete <run-id> --confirm: Einen abgeschlossenen Run samt Logs und Artefakten löschen (Forgejo 16+).
forge run list --repo frank/forgecli
forge run view 42 --repo frank/forgecli
forge run watch 42 --interval 3s --repo frank/forgecli
forge run jobs 42 --repo frank/forgecli

Logs und Artefakte

Actions: Logs und Artefakte dokumentiert die Logformate, Filter, Downloads und Löschbefehle mit Versionshinweisen.

forge run logs --job 123 --repo frank/forgecli
forge run logs 42 --output run-42-logs.zip --repo frank/forgecli
forge run artifact list 42 --repo frank/forgecli
forge run artifact download 456 --output test-results.zip --repo frank/forgecli

Run-, Job- und Artefakt-IDs bezeichnen unterschiedliche Ressourcen. Details: forge run <befehl> --help und forge run artifact <befehl> --help.