Un «dépôt git» est disponible à l'AUF. Il permet :

• à quiconque de suivre les développements effectués à l'AUF ;
• à tout technicien AUF d'y présenter ses développements.

Les projets publics de ce dépôt sont visibles ici : http://git.auf.org/

Vous trouverez ci-dessous un résumé des commandes à utiliser pour exploiter ce service. Si vous voulez vraiment savoir utiliser git, voyez les liens sur la page Git.

Télécharger un projet

Tous les projets visibles sur http://git.auf.org/ sont librement téléchargeables.

Pour obtenir un projet, on fait d'abord un premier clonage :

• $ git clone git://git.auf.org/nom-du-projet

Cela crée un répertoire nom-du-projet, contenant votre dépôt git local du projet. Vous pouvez placer ce répertoire où bon vous semble.

Par la suite, pour obtenir la dernière version du projet, on se place dans le répertoire déjà téléchargé et on pull :

• $ cd nom-du-projet
  $ git pull

Participer à un projet (droits en écriture)

Si vous désirez participer à un projet sur le dépôt Git, vous devez :

• avoir un accès au réseau privé de l'AUF (RPV) ;

• envoyer votre clé publique SSH à l'un des responsables du dépôt (JeanChristopheAndré ou MoussaNombré) ;

• en rappelant sur quel(s) projet(s) vous désirez obtenir les droits d'écriture.

Une fois que les droits vous auront été accordés, vous pouvez envoyer vos modifications avec un push :

• $ git push ssh://gitosis@git.auf/nom-du-projet

Note : afin de pouvoir taper directement git push, enregistrez l'URL dans la configuration du dépôt git :

• $ git config remote.origin.url ssh://gitosis@git.auf/nom-du-projet

Note : sans doute est-il préférable de travailler sur une branche du projet, que vous créerez à l'occasion de vos expérimentations. On essayera de mettre une documentation claire sur le sujet ici prochainement...

Annexe : création d'un projet (notes pour les administrateurs du système gitosis)

Pour ajouter un projet :

1. Accéder au système de configuration de gitosis :

   • $ git clone ssh://gitosis@git.auf/gitosis-admin
     $ cd gitosis-admin

2. Si besoin, ajouter la clé publique ssh du ou des nouvelles personnes dans des fichiers keydir/prenom.nom.pub. Les ajouter au dépôt git : git add keydir

3. Ajouter le projet dans gitosis.conf :

   • # extraits de gitosis.conf :
     
     # permissions : les personnes qui pourront publier dans le projet (ici : nacer.saidou-adamou dans le projet "nacer"
     [group nacer]
     members = nacer.saidou-adamou
     writable = nacer
     
     # le dépôt du projet lui-même
     [repo nacer]
     description = petits bouts de codes de Nacer
     owner = AuF
     daemon = yes
     gitweb = yes

4. Publier la nouvelle configuration :

   • $ git add keydir
     $ git commit -a -m "ajout du projet nacer"
     $ git push

5. Enfin, créer un projet bidon et l'envoyer (note : il faut éventuellement s'y donner les droits) :

   • $ mkdir bidon
     $ cd bidon
     $ git init
     $ git remote add origin gitosis@git.auf:nacer.git
     $ echo "codes de nacer" > LISEZMOI.txt
     $ git add LISEZMOI.txt
     $ git commit -a -m "premier commit"
     $ git push origin master:refs/heads/master

6. Vérifier que cela fonctionne et, éventuellement, se retirer les droits en écriture pour ne les laisser qu'au propriétaire du projet.

synchronisation sur redmine.auf.org

Pour que le dépôt soit accessible sur https://redmine.auf.org/, il faut en faire un clone sur cette machine :

•     root@redmine# su - redmine
   redmine@redmine$ cd /srv/git
   redmine@redmine$ git clone --bare git://git.auf.org/xxxx.git xxxx.git
   redmine@redmine$ cd xxxx.git
   redmine@redmine$ git --bare remote add origin git://git.auf.org/xxxx.git

Un cron s'occupe de mettre à jour tous les dépôts /srv/git/*.git, voir sur la page redmine/InstallationMontreal.