WikiTeki /  Git / Développeur

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

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.

Créer un nouveau projet

• Contacter un administrateur de git.auf.org pour config du nouveau projet.
• Projet public ou privé. [détailler]
• Créer son projet localement
• Créer un git local avec tous les fichiers du projet

  $ cd projet
  $ git init
  $ git add .

• 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

Participer à un projet

• Importer localement la version du serveur une première fois

  $ git clone gitosis@git.auf:projet.git

  Note: on n'a pas besoin de créer le repertoire du projet. Il sera automatiquement créé.

• 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

Étiquetter une version

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

Expérimenter plusieurs voies grâce aux branches

À vérifier

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

ex.: cache/

• Dans .git/info/exclude. -- ProgFou

Ignorer des fichiers ou des dossiers

On peut lister les fichiers à ignorer dans le fichier .gitignore (à la racine du projet). Ce fichier pourra éventuellement être suivi par git et être partagé par tous les développeurs. Par exemple, pour ignorer les fichiers .pyc, on rajoute la ligne suivante dans le fichier .gitignore:

*.pyc 

Pour ignorer les fichiers de façon locale (par exemple si votre éditeur de texte crée des fichiers tampons commencant par '~'), on rajoutera les règles d'exclusion plutôt dans le fichier .git/info/exclude

~*