Comment installer l'outil de gestion de projet Redmine sur Ubuntu 22.04

Redmine est un outil de gestion de projet et de suivi des problèmes gratuit et open-source. C’est un logiciel d’application basé sur le web, principalement écrit en Ruby on Rails. Il est multiplateforme et prend en charge plusieurs bases de données et plusieurs langues.

Redmine est flexible et peut être utilisé pour différents types d’organisations et de projets, qu’il s’agisse de petites, moyennes ou grandes organisations. Il vous permet de créer et de gérer plusieurs projets, et chaque projet a son propre Wiki, Forums, suivi des problèmes, etc. De plus, il vous permet de créer des rôles personnalisés en fonction des besoins de votre organisation, et bien plus encore.

Redmine est publié sous la licence GNU GPL v2 et peut être installé sur n’importe quel système d’exploitation tel que Linux, Windows ou macOS. Il prend en charge différents types de bases de données, y compris PostgreSQL, MySQL et SQLite (par défaut).

Dans ce guide, vous allez installer Redmine avec le serveur web Apache2 et le serveur MySQL sur un serveur Ubuntu 22.04. Vous allez également sécuriser l’installation de Redmine avec des certificats SSL.

Prérequis

Ce tutoriel nécessite les éléments suivants :

• Un serveur Ubuntu 22.04 - Cet exemple utilise un serveur Ubuntu avec le nom d’hôte redmine-server.
• Un utilisateur non-root avec des privilèges sudo root - Mais vous pouvez également utiliser l’utilisateur root.
• Un nom de domaine pointant vers l’adresse IP de votre serveur - pour la production, vous devez vous assurer que votre nom de domaine est pointé vers l’adresse IP de votre serveur.

Une fois que vous avez tout en place, vous pouvez maintenant procéder à la première étape de l’installation de Redmine.

Installation des dépendances

Redmine est un outil de gestion de projet et de suivi des problèmes open-source principalement écrit en Ruby et Ruby on Rails (RoR). Pour installer Redmine, vous devez d’abord installer Ruby, puis vous pouvez installer d’autres dépendances telles que le serveur web Apache2 et la base de données en utilisant le serveur MySQL.

Dans cet exemple, vous exécuterez Redmine avec le serveur web Apache2 et le serveur MySQL.

Avant de commencer à installer des paquets, exécutez la commande apt ci-dessous pour mettre à jour et rafraîchir votre index de paquets Ubuntu.

sudo apt update

Après que le dépôt soit mis à jour, installez certaines des dépendances de paquets suivantes via la commande apt ci-dessous.

Avec cette commande, vous installerez le serveur web Apache2 suivi du linapache2-mod-passenger qui sera utilisé pour configurer l’application RoR afin de fonctionner sous Apache2. Vous installerez également des paquets Ruby.

sudo apt install apache2 ruby ruby-dev build-essential libapache2-mod-passenger libmysqlclient-dev

Lorsque vous êtes invité à confirmer l’installation, saisissez y puis appuyez sur ENTRER pour continuer.

Après l’installation d’Apache2 et de Ruby, exécutez la commande suivante pour installer le serveur MySQL. Redmine prend en charge plusieurs SGBD tels que PostgreSQL, MySQL/MariaDB et SQLite. Dans cet exemple, vous utiliserez le serveur MySQL.

sudo apt install mysql-server

Saisissez y lorsque vous êtes invité à confirmer l’installation, puis appuyez sur ENTRER pour continuer.

Pour l’installation de Redmine, vous devrez également installer un bundler sur votre serveur Ubuntu. Le bundler est une ligne de commande qui sera utilisée pour gérer les paquets Ruby Gems.

Exécutez la commande suivante pour installer un bundler sur votre système.

sudo gem install bundler

Une fois le bundler installé, vous verrez une sortie comme suit :

Enfin, vérifiez les services Apache2 et MySQL via la commande systemctl ci-dessous. Cela garantira que les services Apache2 et MariaDB fonctionnent et sont activés.

Vérifiez le service Apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Vous pouvez voir ci-dessous que le service Apache2 est activé et sera exécuté automatiquement au démarrage du système. Et l’état actuel du service est en cours d’exécution.

Vérifiez le service MySQL.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Vous verrez une sortie similaire à la suivante - Le service MySQL est activé et sera exécuté automatiquement au démarrage. Et l’état actuel du service MySQL est en cours d’exécution.

Configuration du serveur MySQL

Après l’installation d’Apache2 et du serveur MySQL, vous allez configurer le mot de passe root de MySQL et sécuriser le déploiement via mysql_secure_installation. Ensuite, vous allez également créer une nouvelle base de données MySQL et un utilisateur pour Redmine.

Connectez-vous à MySQL via la commande mysql ci-dessous.

sudo mysql

Maintenant, changez le mot de passe root de MySQL via la requête suivante. Et assurez-vous de changer le mot de passe avec votre mot de passe. Ensuite, tapez quit pour quitter le shell MySQL.

ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 'password';  
quit

Ensuite, exécutez la commande suivante pour commencer à sécuriser le déploiement du serveur MySQL.

sudo mysql_secure_installation

Lorsque vous êtes invité à entrer le mot de passe root de MySQL, saisissez votre mot de passe correct.

Ensuite, vous serez interrogé sur d’autres configurations MySQL telles que la désactivation de la connexion à distance pour l’utilisateur root, la suppression de l’utilisateur anonyme, la suppression de la base de données par défaut test et le rechargement de tous les privilèges des tables. Pour tous ces paramètres du serveur MySQL, saisissez Y pour confirmer la configuration.

Après avoir sécurisé le déploiement de MySQL, il est temps de configurer une nouvelle base de données et un utilisateur pour Redmine.

Connectez-vous au shell MySQL via la commande mysql ci-dessous. On vous demandera le mot de passe root de MySQL, saisissez le mot de passe correct pour votre utilisateur root MySQL, puis appuyez sur ENTER.

sudo mysql -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données MySQL et un utilisateur pour Redmine. Dans cet exemple, vous allez créer une nouvelle base de données et un utilisateur redmine avec le mot de passe ‘secretPassword‘. Vous pouvez remplacer le mot de passe de la base de données par votre mot de passe.

CREATE DATABASE redmine CHARACTER SET utf8mb4;  
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'secretPassword';  
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';  
FLUSH PRIVILEGES;

Ensuite, exécutez les requêtes suivantes pour vérifier les privilèges de l’utilisateur MySQL redmine. Assurez-vous que l’utilisateur MySQL redmine a des privilèges sur la base de données redmine.

SHOW GRANTS FOR redmine@localhost;  
quit

Vous pouvez voir ci-dessous l’utilisateur MySQL redmine@localhost avec des privilèges sur la base de données redmine.

Enfin, tapez quit pour vous déconnecter du shell MySQL.

Avec toutes les dépendances installées, et la base de données MySQL et l’utilisateur créés, vous êtes prêt à installer l’outil de gestion de projet Redmine sur votre serveur Ubuntu.

Installation de Redmine

Dans cette étape, vous allez installer la dernière version de Redmine. Au moment de la rédaction de cet article, la dernière version de Redmine est v5.0.2.

Vous allez télécharger le code source de Redmine, configurer la base de données, installer les dépendances Ruby via build, configurer le jeton secret de Redmine et migrer la base de données.

Dans cet exemple, vous allez installer Redmine dans le répertoire /opt/redmine.

Déplacez-vous dans le répertoire /opt.

cd /opt/

Maintenant, téléchargez le code source de Redmine avec la commande wget ci-dessous. Une fois téléchargé, vous verrez le fichier redmine-5.0.2.tar.gz dans votre répertoire /opt.

wget https://www.redmine.org/releases/redmine-5.0.2.tar.gz

Ensuite, exécutez la commande suivante pour extraire le code source de Redmine redmine-5.0.2.tar.gz et créer un nouveau lien symbolique pour le répertoire Redmine vers /opt/redmine.

tar -xvzf redmine-5.0.2.tar.gz  
sudo ln -s redmine-5.0.2 redmine

Le répertoire principal d’installation de Redmine sera /opt/redmine.

Déplacez-vous dans le répertoire /opt/redmine.

cd /opt/redmine/

Copiez la configuration de base de données par défaut ‘config/database.yml.example’ vers ‘config/database.yml’. Ensuite, ouvrez le fichier de configuration de la base de données ‘config/database.yml’ en utilisant l’éditeur nano.

cp config/database.yml.example config/database.yml  
nano config/database.yml

Dans la section ‘production’, changez les détails de la base de données MySQL et de l’utilisateur. Assurez-vous d’utiliser le bon utilisateur de base de données et le mot de passe pour Redmine.

production:  
  adapter: mysql2  
  database: redmine  
  host: localhost  
  username: redmine  
  password: "secretPassword"   
  # Utilisez "utf8" au lieu de "utfmb4" pour MySQL avant 5.7.7  
  encoding: utf8mb4

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande bundler suivante pour installer les dépendances Ruby pour l’application Redmine.

bundle config set --local without 'development test'  
bundle install

Vous verrez une sortie similaire à la suivante :

Une fois les dépendances de Redmine installées, exécutez la commande suivante pour générer le jeton secret de Redmine et migrer la base de données.

bundle exec rake generate_secret_token  
RAILS_ENV=production bundle exec rake db:migrate

Dans la capture d’écran suivante, vous pouvez voir que le jeton secret de Redmine est généré et le processus de migration de la base de données Redmine.

Enfin, chargez les données par défaut dans votre installation de Redmine avec la commande suivante. Lorsque vous êtes invité à choisir la langue, saisissez en pour Anglais.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Lorsque les données par défaut de Redmine sont chargées, vous verrez le message de sortie comme “ Données de configuration par défaut chargées “.

Maintenant que Redmine est installé, vous allez configurer un hôte virtuel Apache2 pour Redmine.

Configuration de l’hôte virtuel pour Redmine

Dans cette étape, vous allez créer une nouvelle configuration d’hôte virtuel Apache2 pour Redmine. Assurez-vous donc d’avoir le nom de domaine qui pointe vers l’adresse IP de votre serveur et que les certificats SSL sont générés.

Exécutez la commande suivante pour activer les modules Apache ssl et rewrite.

sudo a2enmod ssl rewrite

Vous verrez une sortie comme suit :

Maintenant, créez une nouvelle configuration d’hôte virtuel Apache2 ‘ /etc/apache2/sites-available/redmine.conf ‘ en utilisant l’éditeur nano.

sudo nano /etc/apache2/sites-available/redmine.conf

Ajoutez la configuration suivante au fichier. Et assurez-vous de changer le nom de domaine et le chemin des certificats SSL avec votre configuration.

  
  
    ServerName redmine.howtoforge.local  
    ServerAdmin [email protected]  
  
    # Rediriger les requêtes vers SSL  
    Redirect permanent "/" "https://redmine.howtoforge.local/"  
  
  
  
  
  
      
  
        ServerName redmine.howtoforge.local  
        RailsEnv production  
        DocumentRoot /opt/redmine/public  
  
        ErrorLog ${APACHE_LOG_DIR}/redmine.howtoforge.local.error.log  
        CustomLog ${APACHE_LOG_DIR}/redmine.howtoforge.local.access.log combined  
  
        SSLEngine on  
        SSLCertificateFile /etc/letsencrypt/live/redmine.howtoforge.local/fullchain.pem  
        SSLCertificateKeyFile /etc/letsencrypt/live/redmine.howtoforge.local/privkey.pem  
  
          
            Allow from all  
            Require all granted  
          
  
      
  

Enregistrez le fichier et quittez l’éditeur.

Ensuite, exécutez la commande suivante pour activer le fichier d’hôte virtuel ‘ redmine.conf ‘. Ensuite, vérifiez votre configuration Apache2 pour vous assurer que vous avez la bonne configuration.

sudo a2ensite redmine.conf  
sudo apachectl configtest

Vous obtiendrez maintenant le message de sortie tel que “ Syntaxe OK “ lorsque vous avez des configurations Apache2 correctes.

Enfin, redémarrez le service Apache2 via la commande systemctl ci-dessous pour appliquer le nouveau fichier d’hôte virtuel.

sudo systemctl restart apache2

À ce stade, Redmine est installé et l’hôte virtuel est configuré. Vous devriez maintenant accéder à votre installation de Redmine via votre nom de domaine.

Configuration du pare-feu UFW

En production, vous êtes censé activer le pare-feu. Pour le système Ubuntu, vous pouvez utiliser le pare-feu par défaut UFW (Uncomplicated Firewall).

Maintenant, vous allez ajouter des règles UFW qui ouvrent les services HTTP et HTTPS par défaut afin que Redmine soit accessible depuis l’extérieur du réseau.

Exécutez la commande ufw suivante pour ajouter le profil d’application “ OpenSSH “ au UFW. Ensuite, démarrez et activez le pare-feu UFW.

sudo ufw allow "OpenSSH"  
sudo ufw enable

Lorsque vous êtes invité à confirmer, saisissez y pour démarrer et activer le service de pare-feu UFW.

Ensuite, exécutez la commande suivante pour ajouter le profil d’application “ Apache Full “ au pare-feu. Ensuite, vérifiez l’état de UFW via la commande suivante.

sudo ufw allow "Apache Full"  
sudo ufw status

Vous devriez voir que l’état du pare-feu UFW est actif et que les profils d’application actuellement activés sont OpenSSH et “ Apache Full “. Cela ouvrira le port SSH par défaut 22 et les ports des services HTTP et HTTPS 80 et 443.

Installation de Redmine

Ouvrez le navigateur web et visitez le nom de domaine de votre installation de Redmine (c’est-à-dire : https://redmine.howtoforge.local/).

Vous verrez maintenant la page d’accueil par défaut de l’outil de gestion de projet et de suivi des problèmes Redmine. Cliquez sur “ Se connecter “ pour vous connecter au tableau de bord d’administration de Redmine.

Saisissez l’utilisateur d’administration par défaut de Redmine et le mot de passe “ admin - admin “.

Après vous être connecté, on vous demandera maintenant de changer le mot de passe par défaut de Redmine. Saisissez le nouveau mot de passe pour votre installation de Redmine et cliquez sur “ Appliquer “.

Enfin, modifiez les détails de votre utilisateur administrateur Redmine et cliquez sur “ Enregistrer “ pour appliquer les configurations. Vous avez maintenant configuré les bases de Redmine.

Pour ajouter un nouveau projet, cliquez sur le menu “ Projets “. Vous devriez être en mesure de créer, modifier ou supprimer des projets sur votre Redmine.

Maintenant, si vous souhaitez ajouter des configurations à Redmine, cliquez sur le menu “ Administration “. Avec cela, vous pouvez ajouter plus d’utilisateurs, configurer des groupes, définir des rôles, activer l’authentification via une application tierce telle que LDAP, et bien plus encore.

Conclusion

Dans ce tutoriel, vous avez installé et configuré l’outil de gestion de projet et de suivi des problèmes Redmine sur le serveur Ubuntu 22.04. Vous avez également configuré la base de données MariaDB et le serveur web Nginx pour Redmine. De plus, vous avez également sécurisé l’installation de Redmine avec des certificats SSL.

Vous avez maintenant Redmine installé sur votre système, vous pouvez étendre votre installation de Redmine en ajoutant quelques configurations supplémentaires telles que l’intégration de Redmine dans vos infrastructures actuelles, comme l’ajout d’authentifications LDAP, et l’intégration avec SCM comme SVN, Git et Mercurial. De plus, vous pouvez ajouter des rôles en fonction de votre organisation ou entreprise.