12 — Actions (CI) et versions

Utilisez Actions pour lancer des tests, construire des paquets ou publier des fichiers automatiquement à chaque commit.

Votre premier workflow

Ajoutez au dépôt un fichier nommé .gitea/workflows/test.yml :

name: test
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: echo "dépôt récupéré"
      - run: ./scripts/test.sh

L'exécution démarre dans l'onglet Actions dès que vous commitez. L'exécuteur enregistré sur ce serveur répond aux étiquettes ubuntu-latest, ubuntu-24.04 et ubuntu-22.04 ; runs-on doit être l'une d'elles.

Lire les journaux

Actions → exécution → job → étape : la sortie de chaque étape se déplie séparément. L'étape rouge indique où ça bloque ; en haut à droite, vous pouvez relancer l'exécution.

Quand doit-il s'exécuter

on:
  push:
    branches: [main]        # seulement sur les pushs vers main
  pull_request:              # à chaque demande de fusion
  schedule:
    - cron: '0 3 * * *'      # chaque nuit à 03:00

Secrets

N'écrivez jamais de mots de passe ni de jetons dans un fichier de workflow. Définissez-les dans Paramètres → Actions → Secrets et utilisez-les ainsi :

      - run: ./deploy.sh
        env:
          TOKEN: ${{ secrets.DEPLOY_TOKEN }}

Les secrets sont masqués dans les journaux.

Publier une version

Quand un travail est terminé, posez une étiquette et créez une version :

1. Versions → Nouvelle version.
2. Étiquette — par exemple v1.0.0. Elle est créée si elle n'existe pas.
3. Titre et notes — ce qui a changé ; la liste des commits aide.
4. Joignez installateurs, archives ou documents (Pièces jointes).
5. Enregistrez en brouillon, ou appuyez sur Publier la version.

Chaque version publiée propose automatiquement des archives du code source (.zip, .tar.gz) et des liens de téléchargement permanents.

Étiquette ou version ?

• Étiquette (tag) — un repère planté à un point de l'historique ; elle vit dans git.
• Version (release) — la face humaine de cette étiquette : notes, pièces jointes, compteur de téléchargements.

Paquets

L'onglet Paquets liste les registres de paquets rattachés à votre dépôt (npm, conteneurs, generic, etc.). Dès qu'un paquet est publié, il apparaît ici avec ses instructions d'installation.