Ce tutoriel décrit comment installer Redmine sur Ubuntu 18.04 server en utilisant MySQL comme back-end de base de données et Passenger + Nginx comme serveur d’applications Ruby.
Redmine est l’un des outils logiciels de gestion de projet open source et de suivi des problèmes les plus populaires. Il est multi-plateforme et multi-base de données et construit sur le framework Ruby on Rails.
Redmine inclut la prise en charge de plusieurs projets, wikis, système de suivi des problèmes, forums, calendriers, notifications par e-mail et bien plus encore.
Conditions préalables
Avant de continuer ce tutoriel sur comment installer Redmine sur Ubuntu, assurez-vous que vous remplissez les conditions préalables suivantes avant de poursuivre ce didacticiel:
- Vous disposez d’un nom de domaine pointant vers l’adresse IP publique de votre serveur. Dans ce tutoriel, nous utiliserons example.com.
- Vous êtes connecté en tant qu’utilisateur avec les privilèges sudo.
- Vous avez installé Nginx.
- Vous avez un certificat SSL installé pour votre domaine. Vous pouvez installer un certificat SSL Let’s Encrypt gratuit en suivant ces instructions.
Créer une base de données MySQL
Redmine prend en charge MySQL/MariaDB, Microsoft SQL Server, SQLite 3 et PostgreSQL.
Dans ce didacticiel, nous utiliserons MySQL comme back-end de base de données.
Si vous n’avez pas encore installé MySQL sur votre serveur Ubuntu, vous pouvez l’installer en suivant ces instructions.
Connectez-vous au shell MySQL en tapant la commande suivante:
sudo mysql
Depuis le shell MySQL, exécutez l’instruction SQL suivante pour créer une nouvelle base de données:
mysql > CREATE DATABASE redmine CHARACTER SET utf8mb4;
Ensuite, créez un compte utilisateur MySQL et accordez l’accès à la base de données:
mysql > GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password';
Assurez-vous de modifier change-with-strong-password avec un mot de passe fort.
Une fois cela fait, quittez la console mysql en tapant:
mysql > EXIT;
Installer Ruby
Le moyen le plus simple d’installer Ruby sur votre système Ubuntu consiste à utiliser le gestionnaire de paquets apt.
Au moment de la rédaction de cet article, la version dans les référentiels Ubuntu est 2.5.1 qui est la dernière version stable de Ruby.
Installez Ruby en tapant:
sudo apt install ruby-full
Si vous souhaitez installer Ruby via Rbenv ou RVM, consultez ce guide.
Installation de Passenger et Nginx
Passenger est un serveur d’applications Web rapide et léger pour Ruby, Node.js et Python qui peut être intégré à Apache et Nginx.
Nous installerons Passenger en tant que module Nginx.
Assurez-vous d’avoir suivi les prérequis et installé Nginx avant de continuer avec les étapes suivantes.
Commencez par installer les packages nécessaires:
sudo apt install dirmngr gnupg apt-transport-https ca-certificates
Importez la clé GPG du référentiel et activez le référentiel Phusionpassenger:
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger bionic main'
Une fois le référentiel apt activé, mettez à jour la liste des packages et installez le module Passenger Nginx avec:
sudo apt update sudo apt install libnginx-mod-http-passenger
Installer Redmine sur Ubuntu
Pour installer Redmine sur Ubuntu, nous allons commencer par installer les dépendances nécessaires pour construire Redmine:
sudo apt install build-essential libmysqlclient-dev imagemagick libmagickwand-dev
Au moment de la rédaction de cet article, la dernière version stable de Redmine est la version 4.0.0.
Avant de passer à l’étape suivante, vous devez vérifier la page de téléchargement de Redmine pour voir si une version plus récente est disponible.
1. Téléchargement de Redmine
Téléchargez l’archive Redmine avec la commande curl suivante:
sudo curl -L http://www.redmine.org/releases/redmine-4.0.0.tar.gz -o /tmp/redmine.tar.gz
Une fois le téléchargement terminé, extrayez l’archive et déplacez-la dans le répertoire /opt:
cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.0 /opt/redmine
2. Configuration de la base de données Redmine
Commencez par copier le fichier de configuration d’exemple Redmine:
sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml
Ouvrez le fichier avec votre éditeur de texte:
sudo nano /opt/redmine/config/database.yml
Recherchez la section de production et entrez les informations de la base de données MySQL et utilisateur que nous avons créées précédemment:
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: "change-with-strong-password"
encoding: utf8
Une fois terminé, enregistrez le fichier et quittez l’éditeur.
3. Installation des dépendances Ruby
Accédez au répertoire redmine et installez le bundler et d’autres dépendances Ruby:
cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite
4. Générer des clés et migrer la base de données
Exécutez la commande suivante pour générer des clés et migrer la base de données:
cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate
5. Définissez les permissions
Nginx fonctionne en tant qu’utilisateur et groupe www-data. Définissez les autorisations correctes en exécutant la commande chown suivante:
sudo chown -R www-data: /opt/redmine/
Configurer Nginx
À présent, vous devriez déjà avoir Nginx avec certificat SSL installé sur votre système.
Ouvrez votre éditeur de texte et créez le fichier de bloc de serveur Nginx suivant:
sudo nano /etc/nginx/sites-available/example.com
# Redirect HTTP -> HTTPS
server {
listen 80;
server_name www.example.com example.com;
include snippets/letsencrypt.conf;
return 301 https://example.com$request_uri;
}
# Redirect WWW -> NON WWW
server {
listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
return 301 https://example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com;
root /opt/redmine/public;
# SSL parameters
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
include snippets/letsencrypt.conf;
# log files
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
passenger_enabled on;
passenger_min_instances 1;
client_max_body_size 10m;
}
Activez le bloc serveur en créant un lien symbolique vers le répertoire sites-enabled:
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
Avant de redémarrer le service Nginx, effectuez un test pour vous assurer qu’il n’y a pas d’erreurs de syntaxe:
sudo nginx -t
S’il n’y a pas d’erreur, la sortie devrait ressembler à ceci:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
Enfin, redémarrez le service Nginx en tapant:
sudo systemctl restart nginx
Accéder à Redmine
Ouvrez votre navigateur, saisissez votre domaine.
Les informations de connexion par défaut pour Redmine sont:
Nom d’utilisateur: admin
Mot de passe: admin
Lorsque vous vous connectez pour la première fois, vous serez invité à modifier le mot de passe.
Une fois que vous avez modifié le mot de passe, vous serez redirigé vers la page du compte utilisateur.
Conclusion
Vous avez pu installer Redmine sur Ubuntu avec succès . Vous devriez maintenant consulter la documentation Redmine et en savoir plus sur la configuration et l’utilisation de Redmine.
Si vous rencontrez un problème ou avez des commentaires, laissez un commentaire ci-dessous.
Leave a Comment