Introduction
Dans ce laboratoire, vous ferez vos premiers pas dans le contrôle de version avec Git. Vous apprendrez à transformer un répertoire standard en dépôt Git afin de suivre les modifications apportées à vos fichiers au fil du temps.
C’est le moment où un dossier ordinaire devient un projet versionné. Git y parvient en créant un répertoire caché .git, qui stocke l’historique, les métadonnées et les références.
Ce répertoire caché constitue la base de données interne du dépôt. Les fichiers visibles sont le contenu de votre projet, tandis que .git contient les mécanismes utilisés par Git pour mémoriser les versions et les relations entre les commits.
Le processus comporte trois étapes principales :
- Initialisation : configurer le dépôt.
- Préparation : préparer les fichiers à enregistrer.
- Commit : enregistrer un instantané de vos fichiers dans l’historique du dépôt.
À la fin de ce laboratoire, vous disposerez d’un dépôt Git local contenant votre premier fichier enregistré.
Créer le répertoire de projet project_x
Dans cette étape, vous allez créer un nouveau répertoire pour contenir les fichiers de votre projet. Avec Git, un dépôt se trouve généralement dans un répertoire unique.
Commencez par ouvrir votre terminal. Vous vous trouvez actuellement dans le répertoire /home/labex/project. Vous allez créer un nouveau répertoire nommé project_x à l’aide de la commande mkdir.
Exécutez la commande suivante :
mkdir project_x
Accédez ensuite à ce nouveau répertoire à l’aide de la commande cd :
cd project_x
Vous devez vous trouver dans le répertoire où vous souhaitez initialiser Git. Vérifiez votre emplacement actuel avec la commande pwd :
pwd
La sortie doit être /home/labex/project/project_x.
Initialiser Git à l’intérieur avec git init
Dans cette étape, vous allez transformer votre répertoire ordinaire en dépôt Git. Ce processus s’appelle l’« initialisation ».
Exécutez la commande suivante dans votre répertoire project_x :
git init
Vous devriez obtenir une sortie similaire à celle-ci :
Initialized empty Git repository in /home/labex/project/project_x/.git/
Cette commande crée un sous-répertoire caché nommé .git. Ce répertoire contient toutes les métadonnées et la base de données d’objets nécessaires à Git pour suivre votre projet. Vous n’avez pas besoin de modifier quoi que ce soit dans .git, mais il est utile de savoir qu’il existe.
Ainsi, git init ne « téléverse » rien et ne crée pas d’historique à lui seul. La commande prépare simplement le répertoire pour que Git puisse commencer à suivre localement les futurs instantanés.
Vérifiez que le répertoire existe en affichant tous les fichiers, y compris les fichiers cachés :
ls -a
.git doit apparaître dans la liste.
Créer le fichier readme.txt
Dans cette étape, vous allez créer un fichier à suivre. Un dépôt vide n’est pas très utile ; ajoutons donc du contenu.
Vous allez créer un fichier texte simple nommé readme.txt. Vous pouvez utiliser la commande echo pour créer le fichier et y ajouter du texte en une seule opération.
Exécutez la commande suivante :
echo "This is my first git project" > readme.txt
Cette commande crée readme.txt avec le contenu "This is my first git project".
Vérifiez que le fichier a bien été créé :
ls
readme.txt doit apparaître dans la liste.
Vérifier l’état du dépôt avec git status
Dans cette étape, vous allez vérifier l’état de votre dépôt. Git ne suit pas automatiquement tous les fichiers que vous créez : vous devez le lui indiquer.
La commande git status est l’une des commandes les plus utiles de Git. Elle indique quels fichiers sont suivis, lesquels sont modifiés et lesquels sont préparés pour un commit.
Exécutez la commande :
git status
Vous devriez obtenir une sortie similaire à celle-ci :
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
readme.txt
nothing added to commit but untracked files present (use "git add" to track)
Notez que readme.txt apparaît sous Untracked files. Cela signifie que Git voit le fichier, mais ne suit pas encore ses modifications.
Cette situation met en évidence une distinction importante dans Git : un fichier peut exister dans votre répertoire de travail sans faire partie du contrôle de version. Git en a connaissance, mais il n’a pas encore été inclus dans l’historique du dépôt.
Ajouter le fichier à la zone de préparation avec git add
Dans cette étape, vous allez déplacer votre fichier vers la « zone de préparation » (également appelée index). Cette zone permet de préparer un instantané d’un ensemble de modifications avant de les enregistrer dans l’historique officiel.
La zone de préparation est l’un des concepts les plus importants de Git. Elle se situe entre votre répertoire de travail et l’historique du dépôt et vous permet de choisir précisément les modifications qui feront partie du prochain commit.
Pour commencer à suivre readme.txt et le préparer, utilisez la commande git add :
git add readme.txt
Vérifiez maintenant de nouveau l’état du dépôt pour voir le résultat :
git status
La sortie doit maintenant ressembler à ceci :
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: readme.txt
Notez que readme.txt apparaît désormais sous Changes to be committed. Cela signifie qu’il est préparé et prêt à être enregistré dans un commit.
C’est pourquoi Git est souvent décrit comme un flux de travail à trois états : les fichiers dans l’arborescence de travail, les modifications dans la zone de préparation et les instantanés dans l’historique des commits.
Enregistrer le fichier avec git commit -m
Dans cette étape, vous allez enregistrer de manière permanente dans l’historique du dépôt les modifications actuellement présentes dans la zone de préparation. Cette action s’appelle un « commit ».
Un commit enregistre un instantané du projet et nécessite un message décrivant les modifications effectuées. Nous utilisons l’option -m pour fournir directement ce message sur la ligne de commande.
Exécutez la commande suivante pour enregistrer vos modifications :
git commit -m "Initial commit"
Vous devriez obtenir une sortie confirmant le commit :
[master (root-commit) 1a2b3c4] Initial commit
1 file changed, 1 insertion(+)
create mode 100644 readme.txt
Vérifiez ensuite une dernière fois l’état du dépôt :
git status
La sortie doit indiquer :
On branch master
nothing to commit, working tree clean
Cela signifie que votre répertoire de travail correspond au dernier commit du dépôt. Vous avez enregistré votre première version avec succès !
Résumé
Dans ce laboratoire, vous avez initialisé avec succès un dépôt Git local. Vous avez appris à :
- Créer un répertoire de projet.
- Initialiser Git avec
git init. - Créer un nouveau fichier.
- Vérifier l’état du dépôt avec
git status. - Préparer un fichier avec
git add. - Enregistrer le fichier dans l’historique du dépôt avec
git commit.
Voici les commandes fondamentales que vous utiliserez quotidiennement avec Git. Vous pouvez désormais suivre les modifications, enregistrer des versions et gérer l’historique de votre projet.
