Redmine + Git

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é.

 

Ce contenu a été publié dans Ubuntu, avec comme mot(s)-clé(s) , , , . Vous pouvez le mettre en favoris avec ce permalien.