Git/Développeur - WikiTeki

Page présentant les manipulations à faire dans une perspective de développeur.

Page en cours de rédaction. Ne pas la considérer comme une documentation valide !

Remplacer « projet » par le nom de votre projet.

Instructions suivantes fonctionnent avec Ubuntu 8.04 (Hardy Heron) et Git 1.5.4.3.

Préalables

Fournir sa clé SSH à l'un des administrateurs de git.auf.org (MoussaNombré, JeanChristopheAndré ou ThomasNoël).

Installer le paquet git-core.

Faire le premier commit local du projet

$ git commit -a -m "Première version : mise en route du suivi."

Créer la première version du projet sur le serveur

$ git remote add origin gitosis@git.auf:projet.git
$ git push origin master

Supprimer (sauvegarder) la copie locale du projet (incluant le répertoire racine)
Participer au développement du projet

Importer localement la version du serveur une première fois
```
$ git clone gitosis@git.auf:projet.git
```
Pour les fois suivante, récupérer localement la dernière version sur le serveur avant de commencer à éditer les fichiers
```
$ git pull
```
Éditer localement les fichiers
Vérifier le statut des fichiers par rapport au dernier commit
```
$ git status
```
Informer le git local de vos modifications (important car sinon git ignore certaines modifications telles que l'ajout de fichier)
```
$ git add fichier
```
ou encore
```
$ git rm fichier
```
(pour supprimer une arboresence, écrire le nom du répertoire à supprimer ainsi que -r [récursif]) mais aussi
```
$ git add .
```
cependant attention : cette dernière commande pourrait annuler des git rm fait auparavant (on peut éviter ce problème en faisant des git commit réguliers)

Commiter localement les modifications faites

$ git commit -a -m "Ma contribution du moment."

Vérifier si vous avez bien la dernière version du serveur.
```
$ git pull
```
Si vous transmettez vos modifications au serveur mais que vous n'avez pas la dernière version à jour du serveur : votre version s'ajoute au serveur et votre git local vous invite à télécharger cette dernière version (et à régler les éventuels conflits)... Vaut mieux faire un « pull » avant, plutôt que de mettre une version sur le serveur sans être sûr que celle-ci inclut déjà la dernière modification.
Transmettre au serveur vos modifications
```
$ git push
```

Lorsque votre contribution correspond à une version stable, l'identifier en y apposant une étiquette avec le nom de la version. [détailler]

Ajouter une étiquette

$ git tag -a -m "Commentaire etiquette" nom_etiquette

Lister toutes les étiquettes

$ git tag -l

Supprimer une étiquette

$ git tag -d nom_etiquette

Les étiquettes sont locales et ne seront pas transmises au serveur lors d'un push à moins de le spécifier explicitement.

$ git push --tags

Quand et où déclarer les exceptions à git (répertoires ou fichiers à ne pas suivre)?

ex.: cache/