4NK_template/runner/README.md

Runner Gitea (act_runner)

Ce dossier contient une configuration prête à l'emploi pour exécuter un runner Gitea via Docker Compose.

Prérequis

• Hôte Linux avec Docker et Docker Compose
• URL de l'instance Gitea et un token d'enregistrement (repo/org/instance)

Configuration

1. Créez un fichier .env depuis l’exemple:
   • INSTANCE_URL: ex. https://git.4nkweb.com
   • REGISTRATION_TOKEN: token d'enregistrement
   • (optionnel) RUNNER_NAME, RUNNER_LABELS (par défaut self-hosted,linux)
2. Le montage du docker.sock est déjà configuré pour exécuter les jobs en conteneurs.

Démarrage

cd runner
docker compose up -d

Le runner s'enregistre automatiquement et apparaît dans Settings → Actions → Runners.

Arrêt / Mise à jour

docker compose down
# Mise à jour d'image
docker compose pull && docker compose up -d

Mode éphémère (optionnel)

Activez GITEA_RUNNER_EPHEMERAL=1 dans docker-compose.yml pour des runners jetables.

Réf: Gitea Act Runner — https://docs.gitea.com/usage/actions/act-runner