Utilisation du dépôt git de Syracuse

Un dépôt git est mis en place pour les projets développés autour de Syracuse. Ce document constitue un aide-mémoire pour l'utilisation de ce dépôt.

Liste des projets : Projets hébergés sur Syracuse

Si vous souhaitez disposer des fichiers de l'un de ces projets, il vous suffit de télécharger un snapshot via l'interface gitweb ci-dessus.

La suite de ce document concerne la lecture et l'écriture des projets au travers du programme git. Ces opérations sont permises aux seuls membres enregistrés. Si vous êtes intéressé par le développement de ces projets ou si vous voulez héberger un projet sur Syracuse faites le moi savoir.

Téléchargement d'un projet

Supposons que vous souhaitiez télécharger le projet geshi, il suffit de faire :

git clone gitosis@melusine.eu.org:geshi.git

Cela signifie que vous vous connectez à la machine melusine.eu.org via le protocole SSH sous l'identité gitosis¹ pour cloner le projet geshi.git.

Après cela vous disposez d'un répertoire geshi. C'est prêt pour le travail !

Modification des fichiers

Dans le répertoire précédent vous pouvez maintenant modifier les fichiers présents et en ajouter d'autres. Attention à ne pas modifier, pour l'instant, le répertoire caché .git

Lorsqu'on a fait des modifications en local, on doit exécuter une série d'actions² les unes à la suite des autres, en fonction des cas.

un add pour signaler à git quels sont les fichiers à prendre en compte (fichiers créés ou modifiés).

Cela peut se faire manuellement :
```
git add mon_fichier.ext mon_autre_fichier.ext2
```
ou bien automatiquement grâce à l'option -A. Dans ce cas, git enregistre tous les fichiers modifiés ou créés.
un commit pour que git ajoute les modifications à l'historique local (i.e. sur la machine de travail).
```
git commit
```
Il sera alors demandé d'écrire un message de description de la modification. Ceci peut aussi se faire directement dans la ligne de commande grâce à l'option -m :
```
git commit -m 'Mes modifications essentielles...'
```
Si l'on a utilisé l'option -A pour l'opération add, alors il peut-être bon de vérifier quels fichiers ont été pris en compte :
```
git commit --dry-run
```
Et si l'on s'aperçoit que des fichiers inutiles ont été ajoutés, alors il suffit de les retirer du contrôle :
```
git reset mon_fichier.ext
```
Lorsque l'on n'a fait que des modifications de fichiers déjà présents dans le dépôt, alors, on peut se passer de l'opération add en exécutant la commande suivante :
```
git commit -a -m 'Mes modifications essentielles...'
```
L'option -a fait que tous les fichiers modifiés (et non créés) seront ajoutés à l'historique.

Interactions avec Mélusine

Il est temps maintenant de mettre à jour le répertoire distant ! En local, on exécute :

git push

qui envoie les fichiers sur Mélusine.

À partir de ce moment là, les autres participants au projet en question peuvent récupérer les modifications grâce à la commande :

git pull

Il vaut donc mieux, avant de se lancer dans des modifications, commencer par un pull pour être à jour avec le serveur.

Vous êtes reconnu par l'intermédiaire de votre clé publique qui a été déposée dans le répertoire .ssh de l'utilisateur gitosis.↩
Celles-ci doivent être exécutées dans le répertoire (ou sous-répertoire) du projet. En effet, dans celui-ci se trouve un dossier caché .git où sont stockées les informations du dépôts.↩