76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
|
# 10 — Travailler depuis votre ordinateur
|
||
|
|
|
||
|
|
🌍 [English](../../en/10-clone-and-tokens/readme.md) · [Türkçe](../../tr/10-clone-and-tokens/readme.md) · [Deutsch](../../de/10-clone-and-tokens/readme.md) · **Français** · [Русский](../../ru/10-clone-and-tokens/readme.md)
|
||
|
|
|
||
|
|
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.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git clone https://forge.kabaforce.com/proprietaire/projet.git
|
||
|
|
cd projet
|
||
|
|
```
|
||
|
|
|
||
|
|
## La boucle quotidienne
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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 :
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
|
||
|
|
| Besoin | Commande |
|
||
|
|
|--------|----------|
|
||
|
|
| Voir l'historique | `git log --oneline --graph` |
|
||
|
|
| Annuler les modifications locales d'un fichier | `git restore fichier.md` |
|
||
|
|
| Changer de branche | `git switch nom-de-branche` |
|
||
|
|
| Créer une branche | `git switch -c nouvelle-branche` |
|
||
|
|
|
||
|
|
## Automatisation
|
||
|
|
|
||
|
|
Les dépôts peuvent aussi être lus et écrits via l'API KabaForge avec le même jeton :
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
⬅ [Précédent: 09 — Branches et demandes de fusion](../09-branches-and-pull-requests/readme.md) · 📚 [Sommaire](../README.md)
|