Guide pratique de Git - Partie 1

Ce guide regroupe les commandes de base pour de se servir de git, pour s'initier au versioning.

Il ne sera pas abordé les concepts de branches, tag, merge ou rebase, plus complexes, qui seront sans doute traités dans un prochain article.

Prérequis

Installation des outils nécessaires

Avant toute chose, il faut s'assurer que git est installé sur la machine que vous utilisez:

git --version
# par exemple peut afficher `git version 2.25.1` 

Si la commande n'est pas reconnue, suivez le guide d'installation selon votre système d'exploitation.

Avoir un compte sur une plateforme git

Le but de git est de partager ses projets, pour cela il faut avoir un endroit pour centraliser ses projets.

Il existe plusieurs sites dont les plus connus sont Github, Gitlab et Bitbucket, qui proposent tous une offre gratuite.

Configuration de l'utilisateur

Une fois installé, il faut configurer le nom et l'email de l'utilisateur.

Il n'y a aucun lien entre ces informations et vos identifiants sur les plateformes Github, Gitlab ou Bitbucket (en gros vous pouvez mettre ce que vous voulez ;) ).

# Configuration initiale (pour tous les projets)
git config --global user.name “John Doe”
git config --global user.email “johndoe@example.com”

# Il est également possible, depuis un dépôt, de faire une configuration spécifique au dépôt
# en retirant l'attribut --global
git config user.name “John Doe”
git config user.email “johndoe@example.com”

Le workflow de base

Créer en local (sur son ordinateur) un dépôt git créé sur Github (ou Gitlab ou Bitbucket)

Il est possible de créer directement le dépôt git sur sa machine, puis de le pousser vers github, mais l'inverse est plus simple.

Une fois le dépôt créé sur le site, des liens https et ssh sont fournis.

La méthode de récupération n'a pas beaucoup d'importance, c'est plus simple en https, mais plus sécurisé et professionnel en ssh.

Cependant pour faire le lien en ssh, vous devrez créer une paire de clés de sécurité puis enregistrer la clé publique dans votre compte (voir le guide github).

# git clone permet de créer une copie du répertoire distant sur son poste

# ssh
git clone git@github.com:user/repo.git
# https
git clone https://github.com/user/repo.git

Valider ses changements

Après avoir créé ou modifié des fichiers, il faut les valider pour que git les prenne en compte.

# valider tous les changements
git add .

# ou juste un dossier ou un fichier
git add mon-dossier
git add mon-fichier.html

Créer un commit

Permet de faire un "instantané" de tous les changements validés, avec le nom et l'email de l'utilisateur en cours, la date et heure et un message explicatif.

git commit -m "description des changements"

# on peut voir la liste des commits dans l'historique
git log

Mettre à jour le dépôt distant

Par défaut le nom du dépôt distant est "origin", et le nom de la branche par défaut "main" ou "master".

# Envoi des derniers commits vers le dépôt distant
git push origin main

Récupérer les derniers changements du dépôt distant en local

Git étant un système partagé, c'est une bonne idée de récupérer les modifications faites sur le dépôt distant régulièrement (en général avant de travailler sur le projet, le matin par exemple).

# Récupère les derniers changements vers le dépôt local
git pull

# équivalent de :
git fetch # récupère les changements
git merge # fusionne les changements dans le dépôt local

La suite prochainement !

A propos de l'auteur

Tanguy Dechiron

Développeur web fullstack (Symfony++).
Passionné de littérature fantasy, jeux de société.
Cycliste du dimanche.

Article précédent

Utiliser des UUID dans ses entités Symfony

Article suivant

Bonne année 2023