Files
veille-ia-gen/doc2sveltekit-transition/GITEA.md
T
cyber-mawonaj dc6bf1bbde chore : import initial du dossier de travail (PRD, guides, recommandations doc2sveltekit)
Inclut SPECS_SVELTE.md : conventions Svelte 5/SvelteKit pour veille-ia,
consolidées depuis doc2sveltekit-transition (playbook, charte OKI, best practices).
2026-08-01 09:18:27 -04:00

57 lines
2.5 KiB
Markdown

# 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.