10 — Travailler depuis votre ordinateur

Le navigateur suffit pour des documents. Pour le vrai travail — beaucoup de fichiers à la fois, ou exécuter le code — copiez le dépôt sur votre machine.

Obtenir une copie

Cliquez sur le bouton Cloner de la page du dépôt et copiez l'adresse.

git clone https://forge.kabaforce.com/proprietaire/projet.git
cd projet

La boucle quotidienne

git pull              # récupérer ce que les autres ont changé
# ... modifier les fichiers ...
git status            # qu'est-ce que j'ai changé ?
git add .             # préparer les modifications
git commit -m "ajouter les notes d'installation"
git push              # les envoyer à KabaForge

Si git push est refusé, c'est que quelqu'un a poussé avant vous : lancez git pull, résolvez ce qu'il signale, puis poussez de nouveau.

S'authentifier en ligne de commande

Le mot de passe de votre KabaForce ID ne fonctionne pas en HTTPS. Créez plutôt un jeton :

1. Avatar → Paramètres → Applications → Générer un nouveau jeton.
2. Donnez-lui un nom et seulement les permissions nécessaires (repo suffit en général).
3. Copiez-le une fois — il ne sera plus jamais affiché.
4. Quand git demande un mot de passe, collez le jeton.

Pour ne le saisir qu'une seule fois :

git config --global credential.helper store

SSH plutôt que des jetons

1. Créez une clé si vous n'en avez pas : ssh-keygen -t ed25519
2. Copiez ~/.ssh/id_ed25519.pub.
3. Avatar → Paramètres → Clés SSH → Ajouter une clé, collez-la.
4. Clonez avec l'adresse SSH affichée sous Cloner.

Plus aucune demande de mot de passe ensuite.

Compléments utiles

Automatisation

Les dépôts peuvent aussi être lus et écrits via l'API KabaForge avec le même jeton :

curl -H "Authorization: token VOTRE_JETON" \
  https://forge.kabaforce.com/api/v1/repos/proprietaire/projet/contents

Traitez les jetons comme des mots de passe : n'en mettez jamais un dans un fichier que vous commitez.