• COMMIT

Contribution dans un projet GIT. Regroupement d’une ou plusieurs modifications, identifié par une série unique de caractères alphanumériques (SHA). Ce commit représentera une « version » du projet.

• BRANCH

Par commodité, c’est le nom donné à une série de commits. C’est aussi et surtout une référence pour positionner le projet sur le dernier commit d’une série. La branche GIT par défaut s’appelle « master » et devrait correspondre à l’état de la production.

• MASTER

C’est le nom donné à la branche par défaut par GIT. Elle fait généralement office de référence pour l’ensemble des contributeurs, et peut donc aussi correspondre à l’état du projet en production.

• REPOSITORY (OU « DÉPÔT »)

C’est le nom d’un projet GIT. Il peut être local (sur son poste), ou distant (sur un serveur) et référencé par une remote.

• REMOTE

Référence à un projet GIT distant. Ce projet distant doit être hébergé sur un serveur accessible par l’ensemble des contributeurs. La remote par défaut est appelée « origin ».

• INDEX (HEAD)

C’est le nom donné à l’état courant du projet et qui constituera le prochain commit. On parle « d’ajouter des fichiers dans l’index » lorsqu’on souhaite créer un commit avec ceux-ci.

• MERGE/PULL REQUEST

Ce n’est pas une opération propre à GIT à proprement parler, mais cette opération enrichit fortement l’aspect collaboratif de l’outil. Il s’agit de la procédure par laquelle une nouvelle branche sera soumise à vérification et acceptation de la part de l’équipe, et donc mergée dans le tron commun du projet. Elle cible la branche master, ou toute autre branche commune à l’ensemble des contributeurs. Le terme « Merge » est utilisé par l’outil interne Gitlab, alors que le terme « Pull » vient des collaborations publiques sur Github (équivalent public de Gitlab).

• GIT STATUS

Donne l’état du projet : quels sont les fichiers ajoutés dans l’index, ceux qui sont modifiés mais pas encore ajoutés, et ceux qui n’ont encore jamais été ajoutés dans le projet (« untracked files »). Permet également de savoir si la branche courante est en avance ou en retard par rapport à l’état connu de la branche distante (cf « GIT fetch »). Donne aussi d’autres informations en cas de situation « anormale » (conflits lors d’un merge par exemple). A utiliser autant que nécessaire !

• GIT ADD {/path/to/file(s)}

C’est l’ajout d’un fichier ou dossier dans l’index. En d’autres termes, il s’agit d’ajouter ce qui sera contenu dans le prochain commit.

• GIT COMMIT

Valide l’ensemble des modifications contenues dans l’index pour en faire un commit. Cette commande ouvre un éditeur de texte pour renseigner le commentaire du commit. Dans cet éditeur, des informations en commentaire (préfixées par un #) permettent de voir ce qui sera contenu dans le commit. Ces commentaires n’apparaîtront pas dans le message du commit.

• GIT CHECKOUT {ref/to/commit}

Permet de basculer d’un commit à un autre. La référence d’un commit peut être son SHA (identifiant), le nom d’une branche ou un tag (« étiquette » marquant un commit en particulier).

• GIT FETCH {origin}

Prend connaissance des modifications opérées sur le dépôt distant (référencé par le nom de la remote correspondante).

• GIT MERGE {branche à merger} {branche de destination}

Consiste à récupérer les commits d’une branche pour les ajouter sur une autre. Deux cas d’usage :

• le merge d’une branch d’évolutions vers prod ou preprod (à faire sur Gitlab par l’intermédiaire d’une Merge Request)
• le merge de la branche distante dans la branche courante (eg : GIT merge origin/master) permet de mettre à jour la
  branche locale (celle du poste) avec les développements réalisés par d’autres collaborateurs.

• GIT PUSH {origin} {branche}

Envoie les derniers commits de la branche mentionnée sur le dépôt distant.

• GIT BRANCH {nom branche}

Crée une nouvelle branche à partir du commit courant.

• GIT BRANCH –d {nom branche}

Permet de supprimer la branche spécifiée, pour peu que celle-ci ait déjà été mergée complètement dans une autre branche. GIT empêche la suppression si ça n’est pas le cas.

• GIT CHECKOUT –b {branch}

Permet de basculer sur une nouvelle branche sans avoir à la créer au préalable. C’est la combinaison des commandes suivantes : git branch [branch] + git checkout [branch]

• GIT PULL {origin} {branch}

Permet de prendre connaissance des modifications distantes sur une branche et les merger sur la branche courante. C’est la combinaison des commandes suivantes : git fetch [origin] + git merge [origin/branch]. À noter qu’ici, il est implicitement prévu que la branche à merger est la branche distante correspondant à la branche courante.

• GIT FETCH {origin} –prune

Oublie les branches qui ont été supprimées sur le dépôt distant. Cela permet de « nettoyer » le projet GIT et d’éviter la suggestion de branches obsolètes lors de l’autocomplétion des commandes dans le terminal.Valide l’ensemble des modifications contenues dans l’index pour en faire un commit. Cette commande ouvre un éditeur de texte pour renseigner le commentaire du commit. Dans cet éditeur, des informations en commentaire (préfixées par un #) permettent de voir ce qui sera contenu dans le commit. Ces commentaires n’apparaîtront pas dans le message du commit.

• GIT BRANCH –D {branch}

La mise en majuscule de l’option « d » permet de supprimer une branche même si celle-ci n’a pas été mergée dans une autre branche (master par exemple). Cela veut dire que les commits de cette branche qui ne sont pas dans une autre branche ne seront plus référencés simplement. Attention donc, il est ainsi possible de perdre tout son travail.

• GIT ADD .

Plutôt que de cibler un fichier ou un dossier, cette commande cible le répertoire courant et ajoutera tous les fichiers du projets dans l’index. Attention aux fichiers de tests ou produits par le code (exports, css générés, sprites, js générés…) et qui n’étaient pas encore connu de GIT : ils seront ajoutés également à l’index.

• GIT COMMIT –a

Ajoute tous les fichiers modifiés et déjà connus par GIT dans l’index, pour le prochain commit. Attention aux fichiers de code qui n’ont pas été au moins une fois explicitement ajoutés par git add.