# 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à) :

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

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

   ```bash
   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.