Les trois espaces de Git : working directory, staging area, repository
Fondamental : Espaces principaux
Git s'organise en trois espaces (logiques) principaux :
Le working directory (ou répertoire de travail)
Le staging area (zone de préparation)
Le repository (ou dépôt)
Définition : Working directory
Le working directory correspond à l'état actuel du répertoire Git :
les nouveaux fichiers qui ne sont pas encore suivis,
les fichiers modifiés depuis la dernière version.
C'est ce que l'on voit dans le système de fichier à un instant t.
Définition : Staging area
La staging area est la zone intermédiaire entre le working directory et le repository.
Elle contient les modifications effectuées dans le working directory que Git va ajouter au repository lors du prochain commit.
Définition : Repository
Le repository (ou dépôt) correspond aux fichiers dans l'état de la dernière validation effectuée (commit).
Visualiser les changements dans le working directory
Rappel : Working directory
Syntaxe :
git statusExemple :
Application
Créez un fichier README.md à la racine d'un dépôt Git, ce fichier contient :
votre nom,
la licence de votre projet (par exemple "Licence Art Libre — https://artlibre.org").
nano README.md
Visualisez l'état de votre suivi Git avec git status.
Suivre les fichiers (git add)
Fondamental :
La commande git add permet de déplacer un fichier depuis le working directory vers la staging area.
Méthode : git add
La commande git add est utilisée pour :
préparer la validation d'un fichier qui a été créé récemment et qui n'est pas encore suivi ,
préparer la validation des modifications apportées à un fichier déjà suivi.
git-scm.com/book/fr/v2/Les-bases-de-Git-Enregistrer-des-modifications-dans-le-dépôt
Syntaxe :
git add myfile.txtMéthode :
La commande git reset permet d'annuler un git add.
Attention :
La commande git reset n'annule pas les modifications qui ont été faites, elle annule simplement le fait que le fichier est prêt à être validé.
Application
Soit un fichier README.md à la racine d'un dépôt Git.
Ajouter ce fichier à la staging area.
Vérifiez que le fichier a bien été ajouté à la staging area.
Soit un fichier README.md à la racine d'un dépôt Git.
Ajouter ce fichier à la staging area.
Vérifiez que le fichier a bien été ajouté à la staging area.
Versionner les fichiers (git commit)
Fondamental :
La commande git commit permet de déplacer un fichier depuis la staging area vers le repository afin d'en créer une version permanente.
Une fois dans le repository la copie du fichier est figée, elle ne peut plus être modifiée (ni facilement supprimée), elle devient une archive que l'on pourra retrouver dans le futur telle quelle.
Méthode :
Pour effectuer un commit il faut que le ou les fichiers concernés aient été préalablement placés dans la staging area. L'instruction
git commitpermet donc de valider les changements qui ont été ajoutés à la staging area.Lorsque l'on effectue un commit, on doit associer un message qui résume le contenu des modifications de l'étape de validation.
Syntaxe :
git commitgit commit -m "message"
Définition : Commit
Un commit est un point de sauvegarde du travail.
Chaque commit possède un identifiant unique ;
Un commit est associé à une unique personne ;
L'historique des commits est incrémental, out commit (excepté le premier) a un commit « père » ;
Un commit correspond à une version figée du projet ;
On peut naviguer dans les commits (et donc revenir en arrière).
Méthode :
Ma commande git restore permet de remplacer la version actuelle d'un fichier par une version préalablement commitée.
Attention :
La version actuelle du fichier sera définitivement remplacée.
Conseil :
Dans Git on peut considérer que les fichiers qui sont dans le working directory et la staging area sont des fichiers temporaires qui peuvent facilement être altérés, et que ce qui sont dans le repository sont des fichiers protégés en écriture.
Application
Soit un fichier README.md à la racine d'un dépôt Git, ce fichier contient :
votre nom,
la licence de votre projet (par exemple "Licence Art Libre — https://artlibre.org").
Ce fichier a été ajouté à la staging area à l'aide de la commande git add README.md.
Valider définitivement les modifications apportées à ce fichier avec le message "Adding README".
git commit -m "Adding README"
Visualisez l'état de votre suivi Git avec git status.
Ajouter votre email au fichier README.md et vérifiez que le fichier a bien été détecté comme modifié par Git.
Validez cette nouvelle modification avec le message "Adding email to REAME".
git add README.mdgit commit -m "Adding email to REAME"
Afficher l'historique des commits (git log)
Syntaxe :
Le git log permet de voir l'historique de tous les commits effectués sur un repository.
git logExemple :
On peut voir ici :
L'identifiant unique des commits ;
Les auteurs ;
Les dates des commit ;
Les messages qui ont été entrés lors des commits.
Syntaxe :
Le git diff permet de voir les modifications apportées au working directory :
depuis l'état du staging area :
git diffdepuis le dernier commit :
git diff HEADdepuis un commit quelconque :
git diff id_commit
Exemple :
On peut observer sur cet exemple que entre le working directory et le dernier commit :
le
myfile.txta été modifié,la ligne
Ceci n'est pas une phrase.a été supprimée de ce fichier,la ligne
Ceci est-il une phrase ?a été ajoutée à ce fichier.
Méthode :
Les instruction git log et git diff peuvent être suivies du nom d'un fichier afin de n'afficher l'historique ou les différences qui concernent ce fichier.
Exemple :
On peut observer sur cet exemple qu'entre working directory et le commit 30676ede3ab1aaedc3cd8a6f8abc749efa552858, à propos du fichier README.md, la ligne stephane.crozat@utc.fr a été ajoutée.
Restaurer des versions (git checkout)
Fondamental :
Le git checkout permet de se déplacer sur un commit de l'historique.
Cette commande va restaurer l'ensemble du projet dans l'état dans lequel il était au moment de ce commit :
les fichiers créés depuis seront supprimés,
les fichiers supprimés depuis seront restaurés,
les modifications faites depuis seront annulées.
Cette fonction permet de donc de remonter dans le passé de n'importe quel état du projet.
Syntaxe :
git checkout identifiantRemarque :
La commande git checkout master permet de revenir à l'état du dernier commit (donc à l'état présent du présent).
Exemple :
git checkout 30676ede3ab1aaedc3cd8a6f8abc749efa552858Cette commande va restaurer l'ensemble du projet dans l'état dans lequel il était au moment du commit 30676ede3ab1aaedc3cd8a6f8abc749efa552858.
Attention :
Pour que cette commande soit inoffensive, il est nécessaire que le toutes les modifications courantes du projet aient été commitées.
En effet :
la commande
git checkoututilisée pour retourner à un état antérieur, va supprimer l'état présent,la commande
git checkoutpourra ensuite être utilisée pour revenir au dernier état commité.
Mais ce qui n'a pas été commité ne pourra plus jamais être retrouvé.
Remarque :
Si la commande git checkout est lancée sur un projet qui comporte des modifications en cours non validées, Git imposera d'annuler ces modifications ou de les commiter avant de pouvoir effectuer le checkout (afin de protéger l'utilisateur d'une perte d'information).
Complément : HEAD~1, HEAD~2...
La commande git checkout HEAD~1 permet de retourner à la dernière version validée avant celle actuelle (version actuelle "moins une"). De même git checkout HEAD~2 pour retourner deux versions en arrière, etc.
Complément : git tag
La commande git tag montag identifiant permet d'associer un tag à une version afin de la retrouver plus facilement ensuite.
