Pour faire suite à mon article sur l’installation de Subversion et un besoin rapide d’un gestionnaire de projets, voici un rapide descriptif de l’installation du logiciel Trac sur une plateforme Debian.

1. Installez les packages nécessaires.

Comme à notre habitude, on lance une console, on passe en root, on update nos sources et on télécharge les packages suivants :

apt-get update
apt-get install enscript python-docutils python-pkg-resources \
python-pysqlite2 python-setuptools libapache2-mod-python

2. Installez le logiciel Trac.

A la date de cette article, c’est la version 0.10.4.2 qui est proposée dans les dépôts Debian, la version sur le site de Trac est une 0.11rc1, cette version apportant pas mal de changements (voir les Release Notes) il me semble évident d’installer cette version.

Nous allons donc installer Trac via le “easy_install” de Python :

easy_install Trac==0.11rc1

3. Créer un répertoire pour le virtual host dédié à Trac.

Nous créons le répertoire dédié à l’hébergement de nos instances Trac et on règle les droits sur celui-ci de la manière suivante :

mkdir /home/trac
chmod 2770 /home/trac

4. Mettre en place les instances Trac.

Comme nous voulons une gestion multi-projets, il nous faut créer plusieurs instances pour l’exemple et affecter l’utilisateur et groupe Apache sur ceux-ci :

trac-admin /home/trac/projet_1 initenv
trac-admin /home/trac/projet_2 initenv
chown -R www-data:www-data /home/trac

trac-admin va vous demander une série de questions pour configurer son instance, parmi celles-ci on configure le nom du projet, par défaut on laisse SQLite comme gestionnaire de base de données, le path du repository SVN en rapport au projet et on valide le tout. Nous avons donc maintenant des instances de créé, il nous reste plus qu’à les configurer, pour cela il faut éditer le fichier :

vim /home/trac/projet_1/conf/trac.ini

Je vous laisse consulter la doc, pour configurer vos instances selon vos besoins.

5. Créer un répertoire pour les logs.

On crée un répertoire pour stocker les logs d’accès et d’erreurs de notre futur virtual host :

mkdir /home/trac/logs

6. Configurer Apache pour gestion des instances Trac.

vim /etc/apache2/sites-available/trac.exemple.com

Notre virtual host est en mode HTTPS mais vous êtes libre de le faire en port 80, à noter que nous mettons en place l’authentification Apache sur le même fichier d’autorisation que SVN.

<VirtualHost [IP address]:443>
  ServerName trac.example.com

  <Location />
    SetHandler mod_python
    PythonHandler trac.web.modpython_frontend
    PythonInterpreter main_interpreter
    PythonOption TracEnvParentDir /home/trac
    PythonOption TracUriRoot /

    AuthType Basic
    AuthName “Dépots Trac"
    AuthUserFile /home/svn/.passwd
    Require valid-user
  </Location>

  CustomLog /home/trac/logs/access.log combined
  ErrorLog /home/trac/logs/error.log

  SSLEngine on
  SSLCertificateFile /etc/ssl/server.pem
  SSLCertificateKeyFile /etc/ssl/server.key

</VirtualHost>

<VirtualHost [IP address]:80>
  ServerName trac.example.com
  Redirect / https://trac.example.com/
</VirtualHost>

7. On enclenche le virtual host pour Apache.

a2ensite trac.example.com

8. On relance notre serveur Apache.

/etc/init.d/apache2 restart

Et voilà nous avons Trac en mode multi-projets prêt à recevoir nos développements. Il ne vous reste plus qu’à consulter la doc pour aller plus loin dans votre installation.

Moi de mon côté je dispose d’un gestionnaire de projets tout neuf, parfait ça tombe bien, j’ai un projet en cours de réflexion qui commence à pointer le bout de son nez … muuummm