Introduction
Dans cet atelier, vous allez découvrir les commandes fondamentales pour gérer un dépôt Git local dans un environnement Linux. Vous commencerez par initialiser un nouveau dépôt à l'aide de git init et par configurer votre identité utilisateur avec git config. Ce sont les premières étapes indispensables pour tout projet utilisant Git comme système de contrôle de version.
Après cette configuration initiale, vous pratiquerez le cycle de travail principal de Git. Cela inclut la création d'un nouveau fichier, sa mise en index (staging) pour le suivi avec git add, et son enregistrement dans l'historique du dépôt avec git commit. Vous modifierez ensuite le fichier, validerez les changements et apprendrez à consulter l'historique complet des modifications via la commande git log afin de comprendre l'évolution du projet.
Initialiser un dépôt Git et configurer les paramètres utilisateur
Dans cette étape, vous allez commencer par initialiser un nouveau dépôt Git et configurer vos informations utilisateur. Un dépôt Git est un répertoire dans lequel Git suit les modifications apportées aux fichiers de votre projet. L'initialisation d'un dépôt est la toute première étape de l'utilisation de Git pour le contrôle de version.
Votre répertoire de travail actuel est /home/labex/project. Nous allons utiliser ce dossier pour créer notre dépôt Git.
Tout d'abord, exécutez la commande git init. Cette commande crée un nouveau dépôt Git vide dans le répertoire courant. Pour ce faire, elle génère un sous-répertoire caché nommé .git qui contient tous les fichiers nécessaires au fonctionnement du dépôt.
git init
Vous devriez voir un message confirmant qu'un dépôt vide a été initialisé :
Initialized empty Git repository in /home/labex/project/.git/
Maintenant que le dépôt est créé, l'étape suivante consiste à configurer votre identité utilisateur. Git utilise ces informations pour associer votre nom et votre adresse e-mail à chaque validation (commit) que vous effectuez. C'est crucial pour savoir qui a apporté quelles modifications dans un projet collaboratif.
Nous utiliserons la commande git config avec l'option --global. L'option --global garantit que cette configuration s'applique à tous les dépôts Git sur lesquels vous travaillerez sur ce système pour l'utilisateur labex.
Exécutez les commandes suivantes pour définir votre nom d'utilisateur et votre adresse e-mail. Pour cet atelier, nous utiliserons labex comme nom et labex@example.com comme e-mail.
git config --global user.name "labex"
git config --global user.email "labex@example.com"
Ces commandes ne produisent aucune sortie si elles réussissent. Pour vérifier que la configuration a été correctement enregistrée, vous pouvez lister tous les paramètres Git de votre utilisateur :
git config --list
La sortie affichera une liste de tous les paramètres, y compris le user.name et le user.email que vous venez de configurer :
user.name=labex
user.email=labex@example.com
...
Vous avez maintenant initialisé avec succès un dépôt Git et configuré votre identité. Vous êtes prêt à commencer à ajouter des fichiers et à suivre les modifications.
Créer et valider le premier fichier avec git add et git commit
Dans cette étape, vous allez créer votre premier fichier et le valider dans le dépôt Git. La validation (commit) est le processus consistant à enregistrer un instantané de vos modifications indexées dans l'historique du dépôt. Ce processus repose sur deux commandes principales : git add et git commit.
Tout d'abord, créons un simple fichier README.md. Il s'agit d'un fichier courant dans les projets qui fournit des informations sur le contenu du dépôt. Nous utiliserons la commande echo pour créer le fichier et y ajouter du texte. Toutes les commandes doivent être exécutées dans votre répertoire actuel, /home/labex/project.
echo "Hello, Git" > README.md
Maintenant que vous avez créé un fichier, vous pouvez vérifier l'état de votre dépôt à l'aide de la commande git status. Cette commande vous montre l'état du répertoire de travail et de la zone d'index (staging area).
git status
Le résultat ressemblera à ceci :
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
README.md
nothing added to commit but untracked files present (use "git add" to track)
Ce message vous indique que README.md est un "untracked file" (fichier non suivi). Cela signifie que Git voit le fichier, mais qu'il ne fait pas encore partie de l'historique des versions du dépôt.
Pour commencer à suivre ce nouveau fichier, vous devez l'ajouter à la zone d'index. La zone d'index est une étape intermédiaire où vous préparez un ensemble de modifications avant de les valider. Utilisez la commande git add pour indexer README.md.
git add README.md
Cette commande ne produit aucune sortie. Pour voir ce qui s'est passé, lancez à nouveau git status.
git status
Le message a maintenant changé :
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: README.md
Le fichier est désormais répertorié sous "Changes to be committed" (modifications à valider), ce qui signifie qu'il est dans la zone d'index et prêt pour la prochaine validation.
Enfin, pour enregistrer cet instantané dans l'historique de votre projet, utilisez la commande git commit. Il est recommandé d'inclure un message descriptif à chaque validation en utilisant l'option -m. Ce message explique les modifications apportées.
git commit -m "Initial commit: Added README.md"
Après avoir exécuté la commande, vous verrez un message de confirmation résumant la validation :
[master (root-commit) <commit_hash>] Initial commit: Added README.md
1 file changed, 1 insertion(+)
create mode 100644 README.md
Vous avez réussi votre première validation ! Le fichier README.md fait désormais officiellement partie de l'historique de votre dépôt Git.
Modifier un fichier et valider les changements
Dans cette étape, vous apprendrez à suivre les modifications apportées à un fichier existant. L'une des fonctionnalités clés du contrôle de version est la possibilité de voir comment les fichiers évoluent au fil du temps. Cela se fait en validant les changements chaque fois qu'un fichier est mis à jour.
Nous allons continuer à travailler sur le fichier README.md dans le répertoire /home/labex/project. Ajoutons une nouvelle ligne de texte. Nous utiliserons à nouveau la commande echo, mais cette fois avec l'opérateur >>, qui ajoute du contenu à la fin du fichier au lieu de l'écraser.
echo "This is a new line." >> README.md
Maintenant que le fichier est modifié, vérifions l'état du dépôt avec git status.
git status
Git signalera que le fichier README.md a été modifié :
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
La sortie affiche modified: README.md sous "Changes not staged for commit". Cela signifie que Git a détecté le changement, mais qu'il n'a pas encore été ajouté à la zone d'index pour la prochaine validation.
Comme pour un nouveau fichier, vous devez utiliser git add pour indexer les modifications. Cela indique à Git que vous souhaitez inclure ces changements spécifiques dans votre prochaine validation.
git add README.md
Encore une fois, cette commande ne produit aucune sortie. Lançons git status une dernière fois pour confirmer que la modification a été indexée.
git status
La sortie montre maintenant le fichier sous "Changes to be committed" :
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: README.md
Maintenant que les modifications sont indexées, vous pouvez les valider dans l'historique du dépôt. Utilisez git commit avec un message clair décrivant la mise à jour.
git commit -m "Added a new line to README.md"
Vous verrez un message de confirmation pour la validation :
[master <commit_hash>] Added a new line to README.md
1 file changed, 1 insertion(+)
Vous avez maintenant modifié un fichier et validé les changements avec succès. Ce cycle de travail — modifier, indexer et valider — est le cycle fondamental que vous utiliserez de manière répétée avec Git.
Consulter l'historique des validations avec git log
Dans cette dernière étape, vous apprendrez à consulter l'historique des validations de votre dépôt. La commande git log est un outil puissant qui vous permet de voir une liste chronologique de toutes les validations effectuées. C'est essentiel pour comprendre comment un projet a évolué.
Depuis votre répertoire /home/labex/project, exécutez la commande git log :
git log
Cette commande affichera une liste détaillée des validations que vous avez faites, la plus récente apparaissant en premier. Le résultat ressemblera à ceci :
commit <commit_hash_2> (HEAD -> master)
Author: labex <labex@example.com>
Date: <commit_date_2>
Added a new line to README.md
commit <commit_hash_1>
Author: labex <labex@example.com>
Date: <commit_date_1>
Initial commit: Added README.md
Analysons les informations fournies pour chaque validation :
commit: Un hachage SHA-1 unique de 40 caractères qui sert d'identifiant pour la validation.Author: Le nom et l'e-mail de la personne qui a effectué la validation, basés sur votre configuration Git.Date: L'horodatage indiquant quand la validation a été effectuée.- Message de validation : Le texte en retrait est le message que vous avez fourni avec l'option
-m, expliquant le but de la validation.
L'historique s'affiche dans un programme de lecture (comme less). Vous pouvez faire défiler vers le haut ou vers le bas à l'aide des touches fléchées. Pour quitter la vue de l'historique et revenir à votre invite de terminal, appuyez simplement sur la touche q.
Pour une vue plus compacte de l'historique, vous pouvez utiliser l'option --oneline. C'est très utile pour obtenir un aperçu rapide.
git log --oneline
La sortie sera beaucoup plus courte, affichant uniquement le hachage court et le message de validation sur une seule ligne pour chaque entrée :
<short_hash_2> (HEAD -> master) Added a new line to README.md
<short_hash_1> Initial commit: Added README.md
Félicitations ! Vous avez maintenant appris le cycle de travail de base : initialiser un dépôt Git, ajouter et valider des fichiers, et consulter l'historique du projet.
Résumé
Dans cet atelier, vous avez appris les étapes fondamentales pour gérer un dépôt Git local dans un environnement Linux. Vous avez commencé par initialiser un nouveau dépôt dans un répertoire de projet à l'aide de la commande git init. Après l'initialisation, vous avez configuré les paramètres utilisateur essentiels, à savoir votre nom d'utilisateur et votre e-mail, avec la commande git config --global pour garantir que toutes les futures validations soient correctement attribuées. Le cycle de travail principal du contrôle de version a ensuite été mis en pratique en créant un nouveau fichier, en l'indexant pour la prochaine validation avec git add, puis en enregistrant de manière permanente les modifications dans l'historique du dépôt via git commit.
De plus, vous avez pratiqué le processus itératif de modification et de suivi des changements. Cela a impliqué la modification d'un fichier existant, puis la répétition du cycle d'indexation et de validation avec git add et git commit pour sauvegarder la nouvelle version. Enfin, vous avez appris à consulter l'historique du projet en utilisant la commande git log, qui affiche une liste chronologique de toutes les validations, incluant leurs identifiants uniques, auteurs, dates et messages de validation. Cela offre une vue d'ensemble claire des évolutions apportées au dépôt au fil du temps.
