Gitea : créer une release et publier des binaires

Une release Gitea associe une étiquette Git à des notes de version et des fichiers téléchargeables.

Prérequis

• Droit d’écriture sur le dépôt git.exemple.fr/equipe/projet.
• La branche cible à jour.

1. Créer l’étiquette

En local :

git tag -a v1.2.0 -m "Version 1.2.0"
git push origin v1.2.0

2. Ouvrir la release

Dépôt → onglet Releases → Nouvelle release.

• Étiquette : choisir v1.2.0 (existante) ou la créer ici.
• Cible : branche ou commit si l’étiquette n’existe pas encore.
• Titre : Version 1.2.0.
• Description : notes de version en Markdown.

3. Attacher des binaires

Dans la section Joindre des fichiers, glisser les artefacts (projet-linux-amd64, projet.exe, sommes de contrôle SHA256SUMS).

4. Marquer pré-version ou brouillon

• Ceci est une pré-version : signale une version non stable.
• Enregistrer comme brouillon : la release reste masquée jusqu’à publication.

Cliquer Publier la release.

5. Publier via l’API

curl -X POST https://git.exemple.fr/api/v1/repos/equipe/projet/releases \
  -H "Authorization: token <JETON>" \
  -H "Content-Type: application/json" \
  -d '{"tag_name":"v1.2.0","name":"Version 1.2.0","body":"Notes"}'

Vérification

L’onglet Releases liste Version 1.2.0 avec ses fichiers. L’URL de téléchargement directe :

https://git.exemple.fr/equipe/projet/releases/download/v1.2.0/projet-linux-amd64

Dépannage

• Étiquette absente du menu : push de l’étiquette oublié (git push origin v1.2.0).
• Fichier non téléchargeable : taille au-delà de [attachment] MAX_SIZE dans app.ini.
• Release invisible : statut Brouillon ; la publier.
• Erreur 403 sur l’API : jeton sans portée repo ou droits insuffisants.