Redmine et Git
Redmine est un gestionnaire de projet fonctionnant en mode web. Il possède de nombreuses fonctionnalités entre autres la gestion multi-projets, rapports de bugs, notifications par mail, multilingue et l’intégration avec divers suivis de versions.
Pour le suivi de versions, nous utiliserons git. Redmine permettant de voir rapidement les fichiers et l’ensemble des révisions d’un projet.
Passons à l’installation de ces deux applications.
Installation de Redmine
La procédure qui suit est pour le cas où vous utilisez Mysql pour la gestion des données.
Redmine étant développé en Ruby, nous devons installer les composants permettant le déploiement et l’installation de l’application web basée sur le framework Ruby on Rails :
$sudo gem install rake $sudo gem install rails
Redmine étant un gestionnaire de projet en mode web nous avons besoin d’un serveur. Nous installerons donc apache et la librairie libapache2-mod-passenger pour le framework :
$ sudo apt-get install apache2 libapache2-mod-passenger
Installons Mysql et redmine :
$ sudo apt-get install redmine mysql-server redmine-mysql
Un fois l’installation terminée, nous allons lier le répertoire d’installation Redmine et le répertoire d’arborescence d’apache et on indique que le chemin utilisé utilise rails :
$ sudo ln -s /usr/share/redmine/public /var/www/redmine $ sudo chown -R www-data:www-data /var/www/redmine # echo "RailsBaseURI /redmine" > /etc/apache2/sites-available/redmine $ sudo a2ensite redmine $ sudo /etc/inti.d/apache2 reload $ sudo /etc/init.d/apache2 restart
On créé le fichier database.yml dans le répertoire /etc/redmine/default/ et on met les lignes suivantes :
production: adapter: mysql database: redmine host: localhost username: my_user password: my_password
La configuration faite, il faut créer les tables dans la base de données redmine.
Créons la base de données table redmine dans mysql via phpmyadmin ou directement en ligne de commande :
$ mysql -u user_name -p mysql> CREATE DATABASE redmine;
Puis on installe les tables :
$ cd /usr/share/redmine $ sudo RAILS_ENV=production rake db:migrate
et on initialise les paramètres de configuration :
$ sudo RAILS_ENV=production rake redmine:load_default_data
L’installation de redmine est à présent terminée. Vous pouvez vous rendre à l’adresse http://localhost/redmine et vous connectez avec les identifiants par défaut login = admin et mot de passe = admin.
Bonus : pour active la notification par mail, ajouter le fichier configuration.yml dans /etc/redmine/default :
$ sudo gunzip /usr/share/doc/redmine/examples/configuration.yml.example $ sudo cp /usr/share/doc/redmine/examples/configuration.yml.example /etc/redmine/default/configuration.yml
et éditez la partie production (en bas du fichier) :
production: email_delivery: delivery_method: :smtp smtp_settings: tls: true enable_starttls_auto: true address: "smtp.gmail.com" port: 587 domain: "smtp.gmail.com" # 'your.domain.com' for GoogleApps authentication: :plain user_name: "your_email@gmail.com" password: "your_password"
et pour finir :
$sudo /etc/init.d/apache2 reload
Installation de Git
L’installation de git est très simple :
$ sudo apt-get install git git-core
on recharge le serveur :
$ sudo /etc/init.d/apache2 reload
et c’est fini.
Maintenant un petit test pour savoir si git fonctionne avec Redmine.
Nous allons créer un dépôt :
$ cd $ mkdir test_depot $ cd test_depot $ echo "Voici la première ligne de mon fichier" > test_file $ git init $ git add test_depot $ git commit -m "Ceci est mon premier commit" $ echo "Voici la deuxième ligne de mon fichier" >> test_file $ git commit -a -m "Ajout d'une ligne pour le second commit"
Nous venons de créer un dépôt dans lequel nous avons ajouté un fichier file_test. Nous modifions ce fichier en ajoutant une ligne avant de le renvoyer dans le dépôt.
Si vous souhaitez en savoir plus sur les commandes de git, je vous recommande cet excellent article : http://www.unixgarden.com/index.php/gnu-linux-magazine/git-pour-les-futurs-barbus
On se rend dans Redmine et on créé un projet auquel on associe le dépôt test_depot. Sous l’onglet configuration du projet, on choisi dépôt puis git pour SCM. On met le chemin du dépôt dans mon exemple /home/user/test_depot/.git et on sauvegarde.
En cliquant ensuite sur l’onglet dépôt du projet, vous devez voir le fichier du projet file_test ainsi que la liste des révisions.
Conclusion
L’installation de Redmine et du dépôt git est relativement simple. Vous pouvez à présent gérer vos projets en toute tranquilité.