Changes

Page history
Updated "Gestion de versions locale avec git, les bases" authored by Sebastien Jean's avatar Sebastien Jean
Show whitespace changes
Inline Side-by-side
Gestion-de-versions-locale-avec-git,-les-bases.md
View page @ fbd4217c
...@@ -14,11 +14,11 @@ L'objectif de ce qui suit est de prendre en main l'outil de gestion de versions ...@@ -14,11 +14,11 @@ L'objectif de ce qui suit est de prendre en main l'outil de gestion de versions
<small><i><a href='http://ecotrust-canada.github.io/markdown-toc/'>Table of contents generated with markdown-toc</a></i></small> <small><i><a href='http://ecotrust-canada.github.io/markdown-toc/'>Table of contents generated with markdown-toc</a></i></small>
__N.B.__ : _les manipulations suivante sont faites depuis un terminal Linux-compatible, les commandes ont des équivalents sous Windows_ __N.B.__ : _les manipulations suivantes sont effetcuées depuis un terminal Linux-compatible, les commandes ont des équivalents sous Windows_
## Création d'un dépôt local ## Création d'un dépôt local
_On suppose que l'on se trouve dans un répertoire local `4git` (vide) où l'on souhaite commencer à développer_ _On suppose que l'on se trouve dans un répertoire local `4git` (vide) où l'on souhaite commencer à développer_.
La création du dépôt local s'effectue via la commande `git init`: La création du dépôt local s'effectue via la commande `git init`:
``` ```
...@@ -66,7 +66,7 @@ drwxr-xr-x 4 sebastienjean staff 128 Dec 16 10:54 refs ...@@ -66,7 +66,7 @@ drwxr-xr-x 4 sebastienjean staff 128 Dec 16 10:54 refs
MacBook-Air-749:.git sebastienjean$ MacBook-Air-749:.git sebastienjean$
``` ```
Ce répertoire contient des méta-données représentant l'historique, que l'outil _git_ tient à jour au fil des commandes. Les fichiers ne sont pas faits pour être modifiés à la main, à l'exception du fichier `config` qui contient des informations personnalisables de configuration locale du dépôt (voir plus généralement `git config` pour cela) : Ce répertoire contient des méta-données représentant l'historique, que l'outil _git_ tient à jour au fil des commandes. Les fichiers ne sont pas faits pour être modifiés à la main, à l'exception du fichier `config` qui contient des informations personnalisables de configuration locale du dépôt (voir plus généralement [`git config`](https://git-scm.com/docs/git-config) pour cela) :
``` ```
MacBook-Air-749:.git sebastienjean$ more config MacBook-Air-749:.git sebastienjean$ more config
...@@ -81,12 +81,12 @@ MacBook-Air-749:.git sebastienjean$ more config ...@@ -81,12 +81,12 @@ MacBook-Air-749:.git sebastienjean$ more config
MacBook-Air-749:.git sebastienjean$ MacBook-Air-749:.git sebastienjean$
``` ```
N.B. Pour rappel, un commit répond aux questions : __N.B.__ Pour rappel, un _commit_ répond aux questions :
- quand ? (quand la version a été produite) - quand ? (quand la version a été produite)
- qui ? (par qui la version a été produte) - qui ? (par qui la version a été produte)
- pourquoi ? (ce qui justifie cette version) - pourquoi ? (ce qui justifie cette version)
- comment ? (les changements opérés) - comment ? (les changements opérés dans cette version)
Le fichier de configuration locale permet de paramétrer l'identité de l'auteur des commits, de sorte que l'outil _git_ les utilise automatiquement. Ceci se fait en ajoutant la section `[user]` à la suite de la section `[core]` déjà présente : Le fichier de configuration locale permet de paramétrer l'identité de l'auteur des commits, de sorte que l'outil _git_ les utilise automatiquement. Ceci se fait en ajoutant la section `[user]` à la suite de la section `[core]` déjà présente :
...@@ -102,7 +102,7 @@ Le fichier de configuration locale permet de paramétrer l'identité de l'auteur ...@@ -102,7 +102,7 @@ Le fichier de configuration locale permet de paramétrer l'identité de l'auteur
(en se plaçant dans le répertoire de base du dépôt, `4git`) (en se plaçant dans le répertoire de base du dépôt, `4git`)
N.B. : ici la création/édition du fichier s'effectue via la commande `cat` (`Ctrl-D` pour terminer), la commande `pwd` permet de savoir dans quel répertoire l'on se trouve, la commande `more` permet d'afficher le contenu du fichier __N.B.__ : ici la création/édition du fichier s'effectue via la commande `cat` (`Ctrl-D` pour terminer), la commande `pwd` permet de savoir dans quel répertoire l'on se trouve, la commande `more` permet d'afficher le contenu du fichier.
``` ```
MacBook-Air-749:4git sebastienjean$ pwd MacBook-Air-749:4git sebastienjean$ pwd
...@@ -118,7 +118,7 @@ MacBook-Air-749:4git sebastienjean$ ...@@ -118,7 +118,7 @@ MacBook-Air-749:4git sebastienjean$
### Visualisation de l'état du dépôt ### Visualisation de l'état du dépôt
La visualisation de l'état du dépôt s'effectue à l'aide de la commande `git status` : La visualisation de l'état du dépôt s'effectue à l'aide de la commande [`git status`](https://git-scm.com/docs/git-status) :
``` ```
MacBook-Air-749:4git sebastienjean$ git status MacBook-Air-749:4git sebastienjean$ git status
...@@ -138,27 +138,27 @@ Ici, plusieurs informations sont données : ...@@ -138,27 +138,27 @@ Ici, plusieurs informations sont données :
- la branche courante est `master` - la branche courante est `master`
- cette branche ne comporte pas encore de versions (commits) - cette branche ne comporte pas encore de versions (commits)
- git observe dans le _working tree_, l'existence d'un fichier qu'il n'a jamais vu (_untracked_) - git observe dans le _working tree_ l'existence d'un fichier qu'il n'a jamais vu (_untracked_)
- aucun changement n'est actuellement intégré à la future prochaine version - aucun changement n'est actuellement intégré à la future prochaine version
Cette situation est illustrée ci-dessous : Cette situation est illustrée ci-dessous :
<p align="center"> <p align="center">
<img src="uploads/b6e72399f6acb9f6f216c09982c05797/GitRepoStatus.png" width="66%" /> <img src="uploads/b6e72399f6acb9f6f216c09982c05797/GitRepoStatus.png" width="60%" />
</p> </p>
[//]: ![GitRepoStatus](uploads/b6e72399f6acb9f6f216c09982c05797/GitRepoStatus.png) [//]: ![GitRepoStatus](uploads/b6e72399f6acb9f6f216c09982c05797/GitRepoStatus.png)
Les changements observés sont consignés par _git_ dans une zone nommée `working` ou `unstaged` (qu'il s'agisse de la création d'un nouveau fichier ou de la suppression ou modification d'un fichier existant). Les changements observés sont consignés par _git_ dans une zone nommée `unstaged` (qu'il s'agisse de la création d'un nouveau fichier ou de la suppression ou modification d'un fichier existant).
Ces changements observés n'entrainent pas automatiquement la création d'une nouvelle version. Ces changements observés n'entrainent pas automatiquement la création d'une nouvelle version.
### Préparation d'une nouvelle version ### Préparation d'une nouvelle version
La sélection des changements à intégrer à la future nouvelle version est explicite et s'effectue La sélection des changements à intégrer à la future nouvelle version est explicite et s'effectue
s'effectue via la commande `git add` : s'effectue via la commande [`git add`](https://git-scm.com/docs/git-add) :
__N.B__. : On peut utiliser des jokers pour ajouter simultanément plusieurs fichiers, un répertoire, ... (cf. l'aide en ligne). __N.B__. : On peut utiliser des jokers pour ajouter simultanément plusieurs fichiers, un répertoire, ...
``` ```
MacBook-Air-749:4git sebastienjean$ git add unFichier.txt MacBook-Air-749:4git sebastienjean$ git add unFichier.txt
...@@ -190,7 +190,7 @@ __N.B__. : On peut annuler la prise en compte des changements pour un fichier vi ...@@ -190,7 +190,7 @@ __N.B__. : On peut annuler la prise en compte des changements pour un fichier vi
### Création d'une nouvelle version ### Création d'une nouvelle version
La création d'une nouvelle version (commit) s'effectue via la commande `git commit` : La création d'une nouvelle version (commit) s'effectue via la commande [`git commit`](https://git-scm.com/docs/git-commit) :
``` ```
MacBook-Air-749:4git sebastienjean$ git commit -m "ajout d'un fichier" MacBook-Air-749:4git sebastienjean$ git commit -m "ajout d'un fichier"
...@@ -231,7 +231,7 @@ MacBook-Air-749:4git sebastienjean$ ...@@ -231,7 +231,7 @@ MacBook-Air-749:4git sebastienjean$
### Visualisation de l'historique ### Visualisation de l'historique
La commande `git log` permet de voir l'historique de façon exhaustive et d'y retrouver les pointeurs : La commande [`git log`](https://git-scm.com/docs/git-log) permet de voir l'historique de façon exhaustive et d'y retrouver les pointeurs :
``` ```
MacBook-Air-749:4git sebastienjean$ git log MacBook-Air-749:4git sebastienjean$ git log
...@@ -279,7 +279,7 @@ MacBook-Air-749:4git sebastienjean$ ...@@ -279,7 +279,7 @@ MacBook-Air-749:4git sebastienjean$
__N.B.__ : ici, le fichier est déjà connu. __N.B.__ : ici, le fichier est déjà connu.
La commande `git diff`, sans paramètre, nous permet de comparer le _working tree_ et la version `HEAD` (et ainsi voir tout ce qui est déclaré _unstaged_) : La commande [`git diff`](https://git-scm.com/docs/git-diff), sans paramètre, nous permet de comparer le _working tree_ et la version `HEAD` (et ainsi voir tout ce qui est déclaré _unstaged_) :
```diff ```diff
MacBook-Air-749:4git sebastienjean$ git diff MacBook-Air-749:4git sebastienjean$ git diff
...@@ -293,7 +293,7 @@ index 927b61b..ee051bd 100644 ...@@ -293,7 +293,7 @@ index 927b61b..ee051bd 100644
MacBook-Air-749:4git sebastienjean$ MacBook-Air-749:4git sebastienjean$
``` ```
Pour chaque changement sur un fichier, une description des changements à la syntaxe _diff_ est produite. Elle fusionne les 2 versions du fichier et note les endroits des changements. L'outil _diff_ ne travaille qu'au niveau d'un ligne (pas au niveau de son contenu), ainsi une modification sur une ligne à l'endroit désigné du fichier est vue comme la suppression (`-`) de la ligne et l'ajout (`+`) d'une autre ligne (cf. documentation pour plus de détails) Pour chaque changement sur un fichier, une description des changements à la syntaxe [_diff_](https://en.wikipedia.org/wiki/Diff#Unified_format) est produite. Elle fusionne les 2 versions du fichier et annote les endroits où se produisent les changements. L'outil _diff_ ne travaille qu'au niveau d'un ligne (pas au niveau de son contenu), ainsi une modification sur une ligne à l'endroit désigné du fichier est vue comme la suppression (`-`) de la ligne et l'ajout (`+`) d'une autre ligne.
On suppose que l'on valide ces modifications : On suppose que l'on valide ces modifications :
...@@ -365,7 +365,7 @@ __N.B.__ : On peut aussi utiliser en paramètre les _hash_ des commits (abbrévi ...@@ -365,7 +365,7 @@ __N.B.__ : On peut aussi utiliser en paramètre les _hash_ des commits (abbrévi
### Restauration de versions ### Restauration de versions
la commande `git checkout` permet de déplacer le curseur `HEAD`sur une version antérieure. Mais son utilisation pour restaurer tout ou partie de la version en question nécessite de manipuler des branches (ce n'est pas l'objet de ce guide). La commande [`git checkout`](https://git-scm.com/docs/git-checkout) permet de déplacer le curseur `HEAD`sur une version antérieure. Mais son utilisation pour restaurer tout ou partie de la version en question nécessite de manipuler des branches (ce n'est pas l'objet de ce guide).
Néanmoins, si on lui indique en paramètre un fichier ou un répertoire, elle remplace le fichier ou le répertoire du _working tree_ avec une version antérieure sans déplacer `HEAD`. Néanmoins, si on lui indique en paramètre un fichier ou un répertoire, elle remplace le fichier ou le répertoire du _working tree_ avec une version antérieure sans déplacer `HEAD`.
...@@ -398,7 +398,7 @@ e08fe66 modification du fichier ...@@ -398,7 +398,7 @@ e08fe66 modification du fichier
### Inversion de modifications ### Inversion de modifications
La commande `git revert`permet d'annuler les modifications d'un commit antérieur (pas forcément le précédent, mais dans ce cas ce n'est possible automatiquement que si aucun des commits suivants n'est en conflit de modification avec celui-ci) La commande [`git revert`](https://git-scm.com/docs/git-revert) permet d'annuler les modifications d'un commit antérieur (pas forcément le précédent, mais dans ce cas ce n'est possible automatiquement que si aucun des commits suivants n'est en conflit de modification avec celui-ci).
On visualise les modifications entre les 2 dernières versions : On visualise les modifications entre les 2 dernières versions :
...@@ -448,7 +448,7 @@ index 927b61b..ee051bd 100644 ...@@ -448,7 +448,7 @@ index 927b61b..ee051bd 100644
MacBook-Air-749:4git sebastienjean$ MacBook-Air-749:4git sebastienjean$
``` ```
On visualise les modifications entre la dernière version et son grand-parent, et on observe qu'elles sont bien nulles (on a rétablit le même contenu du _working tree` : On visualise les modifications entre la dernière version et son grand-parent, et on observe qu'elles sont bien nulles (on a rétabli le même contenu du _working tree` :
```diff ```diff
MacBook-Air-749:4git sebastienjean$ git diff HEAD~2 HEAD unFichier.txt MacBook-Air-749:4git sebastienjean$ git diff HEAD~2 HEAD unFichier.txt
... ...
......