Gitea : premier workflow Gitea Actions

Gitea Actions exécute des workflows YAML compatibles avec la syntaxe GitHub Actions, déclenchés sur événements Git.

Prérequis

• Gitea avec Actions activé ([actions] ENABLED = true dans app.ini).
• Un runner act_runner installé sur une machine d’exécution.

1. Activer Actions pour le dépôt

Dépôt → Paramètres → Avancé → cocher Activer Actions.

2. Enregistrer un runner

Sur la machine d’exécution :

act_runner register \
  --instance https://git.exemple.fr \
  --token <JETON_RUNNER> \
  --name runner-ci \
  --labels ubuntu-latest:docker://node:20-bookworm

Le jeton se récupère dans Administration du site → Actions → Runners. Démarrer :

act_runner daemon

3. Créer le workflow

Ajouter .gitea/workflows/ci.yaml :

name: CI
on:
  push:
    branches: [ main ]
  pull_request:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Installer les dépendances
        run: npm ci
      - name: Lancer les tests
        run: npm test

4. Pousser et déclencher

git add .gitea/workflows/ci.yaml
git commit -m "Ajoute le workflow CI"
git push

Vérification

Onglet Actions du dépôt : l’exécution CI apparaît. Cliquer dessus affiche les journaux par étape. Un job réussi affiche une coche verte.

Dépannage

• Aucun job déclenché : Actions désactivé au niveau site ou dépôt ; vérifier app.ini et les paramètres du dépôt.
• « no runner available » : aucun runner avec le label ubuntu-latest ; comparer les --labels du runner et runs-on.
• Runner hors ligne : relancer act_runner daemon, vérifier l’accès réseau vers git.exemple.fr.
• Étape checkout échoue : version d’action incompatible ; épingler actions/checkout@v4.