veille-ia-gen/doc2sveltekit-transition/GITEA.md

Pousser un projet sur Gitea (labola.o-k-i.net)

Mémo rédigé le 2026-07-19 après la mise en ligne de gwada-sirius. À relire avant de pousser un autre projet sur https://labola.o-k-i.net/cyber-mawonaj.

Prérequis déjà en place (setup unique, fait)

• Instance Gitea : https://labola.o-k-i.net, namespace cyber-mawonaj.

• Clé SSH dédiée : ~/.ssh/id_ed25519_gitea (sans passphrase), enregistrée dans Gitea → Paramètres → Clés SSH (https://labola.o-k-i.net/user/settings/keys).

• Entrée dans ~/.ssh/config pour utiliser cette clé automatiquement :

  Host labola.o-k-i.net
      IdentityFile ~/.ssh/id_ed25519_gitea
      IdentitiesOnly yes
  

• ⚠️ id_rsa (et les autres clés du compte) ont une passphrase et ne fonctionnent pas en non-interactif (pas d'agent SSH). Toujours utiliser id_ed25519_gitea.

• Test de connexion : ssh -T git@labola.o-k-i.net doit répondre Hi there, cyber-mawonaj! ...

Procédure pour un nouveau projet

1. Créer le dépôt vide sur Gitea (interface web) :

   • Aller sur https://labola.o-k-i.net/repo/create
   • Propriétaire : cyber-mawonaj ; nom : celui du projet
   • ⚠️ Décocher « Initialiser le dépôt » (pas de README/licence/.gitignore), sinon le premier push est refusé (historiques différents).

2. Côté local, dans le dossier du projet :

   • Vérifier l'état : git status (commits présents, copie propre).
   • Vérifier que .gitignore exclut node_modules/, les builds (_site/, dist/…), .env.

3. Ajouter le remote (garder origin si un remote GitHub existe déjà) :

   git remote add gitea git@labola.o-k-i.net:cyber-mawonaj/<nom-du-projet>.git
   

4. Pousser (demander confirmation à l'utilisateur avant) :

   git push -u gitea main   # ou master, vérifier avec `git branch --show-current`
   

5. Vérifier : git ls-remote gitea main doit afficher le même hash que git rev-parse main.

Effets de bord à connaître

• Après git push -u gitea main, la branche suit gitea/main : un simple git push ira vers Gitea. Pour GitHub : git push origin main explicite.
• Si la clé SSH est refusée (Permission denied (publickey)) : vérifier que la clé est bien enregistrée dans Gitea et que l'entrée Host labola.o-k-i.net existe dans ~/.ssh/config.
• Alternative à l'interface web pour créer le dépôt : l'API Gitea avec un token (POST /api/v1/orgs/cyber-mawonaj/repos), non utilisée ici.