Commandes git

Les commandes git indispensables à connaître

Ce tutoriel comporte deux sections :

1. La section Comment faire qui donne la marche à suivre pour les opérations courantes,
2. La section Cheatsheet, un tableau récapitulant les commandes les plus utiles et leurs variations (notamment les options qu'il est important de connaître).

L'idée est donc de pouvoir utiliser ce tuto de deux façons : soit avec une idée de ce qu'on veut faire, obtenir les différentes commandes à utiliser ; soit pour se rafraîchir la mémoire sur une commande bien précise.

Comment faire ?

Récupérer (cloner) en local un projet existant

C'est aussi la façon la plus simple d'initialiser un projet github. Une fois le projet crée sur github

git clone <url>

<url> sera ce qui est copié depuis la page du projet :

Et aura deux formes :

• git@github.com:<USER>/<mon projet>.git. Si vous utilisez cette méthode,vous vous authentifierez avec vos clés ssh.
• par http : git remote add origin https://github.com/<USER>/<monprojet>.git. Si vous utilisez cette méthode vous vous authentifierez avec un token.

Initialiser un nouveau projet

En quatre étapes :

1. Création du répertoire sur Github
2. Création du répertoire en local
3. Initialisation de git
4. Les liaisons (pas dangereuse)

Création du répertoire sur Github

Pour cette première étape, opérez depuis un navigateur (tuto sur github) :

• donnez un nom à votre répertoire
• choisissez un répertoire public
• vous pouvez ensuite créer le répertoire en cliquant sur le bouton create repository

Une fois le dossier crée, github vous aide pour lier ce répertoire à un projet de votre ordinateur.

Création du répertoire en local

cd <là où on veut mettre le dossier>
mkdir <mon projet>

Initialisation de git

cd <mon projet>
git init

Liaisons

Si vous voulez vous connecter, il y a deux possibilités :

• par SSH : git remote add origin git@github.com:<USER>/<mon projet>.git. Si vous utilisez cette méthode,vous vous authentifierez avec vos clés ssh.
• par http : git remote add origin https://github.com/<USER>/<monprojet>.git. Si vous utilisez cette méthode vous vous authentifierez avec un token.

Votre premier push devra aussi définir la branche de l'origin : git push --set-upstream.origin main. Vous pourrez ensuite utiliser simplement git push

Travailler à plusieurs sur un projet

1. on sépare le travail à faire en tâche, et on s'arrange pour les taches à effectuer en même temps soient sur des parties différentes du code. Ceci pour éviter de se marcher sur les pieds et multiplier les conflits de fusion.
2. pour coder sa propre tâche, on crée une branche de développement qui lui nous est propre et sur laquelle vous pourrez travailler en local, voir la sauver sur le serveur. Comme vous êtes seul à travailler dessus, vous n'aurez pas de problème de fusion.
3. Une fois votre travail fini, vous fusionnerez votre branche local avec la branche principale du serveur distant, qui est souvent la branche main.
4. vous pouvez ensuite supprimer la branche qui vous a servi à coder la tâche et recommencer.

Récupérer en local les modifications effectuées sur le répertoire distant

git pull --rebase=merges

En général, l'url peut être trouvée sous le menu "Code" ou "Clone" sur la page principale d'un projet.

Créer une nouvelle branche

git checkout main
git branch ma_nouvelle_branche
git checkout ma_nouvelle_branche

git checkout main
git checkout -b ma_nouvelle_branche

L'option -b appliquée à la commande checkout permet en effet de créer la branche de destination si celle-ci n'existe pas.

Pousser une branche (nouvelle) locale sur le serveur distant

git checkout <branche>
git push --set-upstream origin <branche>

git checkout <branche>
git push -u origin <branche>

Pousser ses modifications sur le serveur

La fréquence d'ajout des modifications au git est variable suivant les développeurs. Certains aiment faire un gros ajout (commit) une fois de temps en temps, quand d'autres sont partisans de commits dits atomiques (pour chaque modification), quitte à retravailler ensuite l'historique ensuite pour le rendre plus concis si besoin.

Concernant la fréquence d'envoi sur le serveur (push), la seule règle vraiment importante est de bien avoir en tête que, tant que du code n'est pas poussé, il n'existe que sur votre ordinateur. Et si celui-ci est endommagé ou perdu ... Un push régulier est donc gage d'esprit léger !

Ajout des modifications

L'ajout des modifications au git se fait en plusieurs étapes : on ajoute d'abord les modifications qui nous intéressent au stage, puis on les commit. On peut voir le stage comme une sorte de bassine où l'on dépose tous les fichiers que l'on veut sauver.

En général, on a pris soin de placer les fichiers qu'on ne veut de toute façon pas voir dans git dans le fichier .gitignore. Donc, souvent, on va vouloir tout ajouter dans le stage pour tout commit :

git add .
git commit -am "<mon message décrivant le commit>"

git add fichier1.md fichier2.html
git commit -am "<mon message décrivant le commit>"

Pousser sur le serveur

Une fois qu'on a commit nos changements, que tout est testé (mais c'est un autre sujet), etc., on va pouvoir pousser notre code sur le serveur. Rien de plus simple :

git push

Si la branche sur laquelle on travaille existe aussi sur le serveur et que les deux branches sont liées, tout devrait bien se passer. Sinon, c'est qu'on a mal fait ça.

Fusionner une branche

Nous proposons ici une méthode consistant à utiliser git rebase conjointement à git merge pour obtenir un historique plus "propre" (i.e. plus linéaire). Pour plus détails, voir le tuto sur git rebase.

Ne garder aucune trace de la branche

Pour ne garder aucune trace de la branche (et obtenir ainsi un historique complètement linéaire, plat) :

git rebase main branche
git checkout main
git merge branche
git branch -d branche

Conserver une trace de la branche

Pour conserver une trace de la branche (par exemple parce qu'elle est signifiante) mais conserver une certaines linéarité (dans l'enchaînement des branches notamment) :

git rebase main branche
git checkout main
git merge branche --no-ff
git branch -d branche

Cheatsheet

Par ordre alphabétique ;)