14 — Dépôt vide et démarrage avec git
Si vous avez créé le dépôt sans cocher Initialiser le dépôt, vous arrivez sur un dépôt vide accompagné d'un guide rapide. Ce chapitre reprend cet écran en entier.
Vos adresses
En haut de la page d'un dépôt vide figurent deux adresses :
HTTPS https://forge.kabaforce.com/proprietaire/projet.git
SSH [email protected]:proprietaire/projet.git
HTTPS fonctionne avec un jeton, SSH avec une clé (chapitre 10). Les deux mènent au même dépôt, et vous pourrez changer plus tard.
Un dépôt tout neuf
S'il n'y a pas encore de dépôt git sur votre machine :
mkdir projet && cd projet
git init
git switch -c main
echo "# projet" > readme.md
git add readme.md
git commit -m "premier commit"
git remote add origin https://forge.kabaforce.com/proprietaire/projet.git
git push -u origin main
-u n'est nécessaire qu'au premier envoi ; ensuite git push suffit.
Envoyer un dépôt local existant
Si votre dossier contient déjà un .git, ne recommencez pas de zéro :
cd projet-existant
git remote add origin https://forge.kabaforce.com/proprietaire/projet.git
git push -u origin main
Si votre branche s'appelle master, envoyez-la telle quelle ou renommez-la d'abord :
git branch -m master main
Changer l'adresse distante
Après un déplacement, ou pour passer de HTTPS à SSH :
git remote -v # vers où pointe-t-il
git remote set-url origin [email protected]:proprietaire/projet.git
Pourquoi un dépôt initialisé est plus simple
Cocher Initialiser le dépôt crée le premier commit avec un README.md : vous clonez et travaillez immédiatement.
git clone https://forge.kabaforce.com/proprietaire/projet.git
L'écran de création propose aussi un modèle de .gitignore et une licence — ajoutables à la main plus tard, mais les choisir tout de suite fait gagner une étape.
Si le premier envoi échoue
| Message | Cause |
|---|---|
Authentication failed | Vous avez saisi un mot de passe ; en HTTPS il faut un jeton (chapitre 10) |
Permission denied (publickey) | Votre clé SSH n'est pas enregistrée sur le compte |
src refspec main does not match any | Aucun commit encore — faites git commit |
failed to push some refs | Le distant a des commits que vous n'avez pas — git pull puis réessayez |