gitea/docs/actions-runner.md

Gitea Actions e runner

Gitea Actions (compatibile con workflow GitHub Actions) è abilitato di default da 1.21 ([actions] ENABLED=true). Lo stack attuale non include un runner: senza di esso i job restano in coda.

Passi

1. Abilitare Actions nel repo: Impostazioni → "Abilita Actions del repository" (disattivo per default).
2. Ottenere un token di registrazione:
   • istanza: <url>/-/admin/actions/runners
   • organizzazione: <url>/<org>/settings/actions/runners
   • repo: <url>/<owner>/<repo>/settings/actions/runners
   • CLI: gitea actions generate-runner-token [--scope owner/repo]
3. Registrare e avviare il runner (binario "Gitea Runner", prima act_runner):

gitea-runner register --no-interactive --instance <URL> --token <TOKEN>
gitea-runner daemon

L'istanza deve essere raggiungibile da runner e container dei job: non localhost/127.0.0.1; usare l'URL pubblico o un indirizzo LAN. Il file .runner creato non va modificato a mano. 4. Il runner usa Docker per isolare i job (daemon Docker necessario; montare /var/run/docker.sock se containerizzato — implica privilegi elevati sull'host). 5. Workflow in .gitea/workflows/*.yaml (anche .github/workflows):

name: demo
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - run: echo "ciao"

runs-on deve corrispondere a un'etichetta (label) registrata dal runner.

Config server

[actions]: DEFAULT_ACTIONS_URL (github), log retention 365g, artifact 90g, timeout task zombie 10m / endless 3h / abandoned 24h. Segreti e variabili: Impostazioni repo/org → Actions.

Non verificati qui (consultare docs.gitea.com/usage/actions): compose del runner, variabili d'ambiente, formato label.