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

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 :

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 :

Participer à un projet (droits en écriture)

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

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

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

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 :

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