Migration vers Gitea & mise en place des outils (Bloc 3)

Ce guide décrit la mise en place de Gitea comme plateforme unique de versioning, de gestion des tickets (maintenance) et d'intégration continue (Gitea Actions), ainsi que le raccordement au déploiement continu Coolify. Il sert de support à la démonstration de soutenance.

Instance utilisée : Gitea auto-hébergée. Dépôt cible : https://<instance-gitea>/adam/cesizen.

1. Migrer le dépôt GitHub → Gitea

Option A — Migration assistée (recommandée, conserve issues & historique)

Se connecter à Gitea → + → Nouvelle migration → GitHub.
URL source : https://github.com/AzmogEx/CesiZen.git.
Cocher : Éléments à migrer → dépôt Git, Issues, Pull requests, Releases, Labels, Milestones.
Renseigner un jeton d'accès GitHub (lecture) si le dépôt est privé. Lancer.

Option B — Push manuel (miroir du code seul)

cd /chemin/vers/CesiZen
git remote add gitea https://<instance-gitea>/adam/cesizen.git
git push gitea --all      # toutes les branches
git push gitea --tags     # tous les tags/releases
# Faire de Gitea le dépôt de référence :
git remote set-url origin https://<instance-gitea>/adam/cesizen.git

Vérifier ensuite que .gitea/ (workflows + gabarits d'issues) est bien présent à la racine.

2. Activer l'intégration continue (Gitea Actions)

Côté serveur Gitea : Actions doit être activé (app.ini → [actions] ENABLED = true).

Enregistrer un runner (une fois) :

# Récupérer le jeton dans Gitea → Administration → Actions → Runners
act_runner register --instance https://<instance-gitea> --token <TOKEN> \
    --name cesizen-runner --labels ubuntu-latest:docker://node:20-bookworm
act_runner daemon

Le workflow .gitea/workflows/ci.yml se déclenche alors à chaque push / pull request et exécute les 3 jobs : backend (PHPUnit + Pint), frontend (ESLint + Vitest), mobile (Jest).
Une pastille verte/rouge s'affiche sur chaque commit et chaque PR (démo).

3. Configurer le ticketing (maintenance)

Labels à créer (Issues → Labels → « Créer un label »)

Label	Couleur	Usage
`type/incident`	rouge	Anomalie (maintenance corrective) — posé automatiquement par le gabarit
`type/évolution`	bleu	Nouvelle fonctionnalité (maintenance évolutive)
`gravité/bloquant`	#C8102E	Service inutilisable
`gravité/majeur`	#E4801C	Service dégradé, contournement possible
`gravité/mineur`	#F0C808	Altération mineure
`priorité/critique` · `priorité/forte` · `priorité/normale`	dégradé	Ordonnancement
`statut/à-qualifier` · `statut/en-cours` · `statut/en-revue` · `statut/résolu`	gris→vert	Suivi Kanban
`module/comptes` · `module/informations` · `module/tracker` · `module/infra`	vert	Domaine

Les gabarits d'issues sont déjà versionnés dans .gitea/issue_template/ (incident.yaml, evolution.yaml) : ils apparaissent automatiquement au clic sur « Nouvelle issue ».

Milestones (= versions)

Créer un jalon par version livrée : v1.0, v1.1, … Chaque issue/PR est rattachée à un jalon → suivi de l'avancement par version.

Tableau de bord Kanban (pilotage)

Onglet Projects → Nouveau projet (type Board) avec les colonnes : À qualifier → À faire → En cours → En revue (PR) → Résolu. Les issues glissent d'une colonne à l'autre ; les labels de statut sont synchronisés.

4. Raccorder le déploiement continu (Coolify)

Coolify build les images depuis le dépôt Git et redéploie à chaque nouveau commit sur main :

Dans Coolify → application CESIZen → Source : pointer sur le dépôt Gitea (main).
Activer le webhook de déploiement : Coolify fournit une URL de type https://<coolify>/api/v1/deploy?uuid=…&force=false.
Dans Gitea → dépôt → Paramètres → Webhooks → Ajouter : coller l'URL, événement Push, branche main.
Résultat : merge sur main → CI verte → webhook → Coolify build + déploie en production (cesizen.cleanows.fr / api.cesizen.cleanows.fr), avec migrations, seed et génération des secrets automatisés par backend/docker/entrypoint.sh.

5. Script de démonstration (soutenance)

Versioning : montrer l'arbre des commits Gitea, les branches, un tag de version.
CI : ouvrir une PR triviale → montrer les 3 jobs qui tournent → pastille verte.
Ticketing : créer une issue via le gabarit incident, la qualifier (labels + jalon), la déplacer sur le board Kanban.
CD : merger la PR → montrer le déploiement Coolify déclenché → rafraîchir le site en ligne.

4.8 KiB Raw Permalink Blame History