Dans ce tutoriel, nous allons vous montrer comment installer Redmine sur un VPS Ubuntu 18.04.
Redmine est une application de suivi des problèmes et de gestion de projet basée sur le Web, open source, multiplateforme et multibase de données, basée sur le framework Ruby on Rails. Commençons par l'installation.
Prérequis :
- Un nom de domaine enregistré pointant vers l'adresse IP de votre serveur. Dans ce tutoriel, nous utiliserons
your_domain.com. (facultatif) - Accès racine SSH complet ou un utilisateur avec des privilèges sudo.
- Certificat SSL installé pour votre domaine. Dans notre tutoriel, nous utiliserons un certificat SSL Let’s Encrypt gratuit. (facultatif)
Étape 1 :Connectez-vous à votre serveur
Pour vous connecter à votre serveur via SSH en tant qu'utilisateur root, utilisez la commande suivante :
$ ssh root@IP_ADDRESS -p PORT_NUMBER
et remplacez "IP_ADDRESS" et "PORT_NUMBER" par l'adresse IP de votre serveur et le numéro de port SSH.
Une fois connecté, assurez-vous que votre serveur est à jour en exécutant les commandes suivantes :
$ apt-get update $ apt-get upgrade
Étape 2 :Installer MySQL
Ensuite, nous devons installer le serveur MySQL. Ubuntu 18.04 dispose de la dernière version stable de MySQL prête à être installée via les référentiels préinstallés.
La commande suivante installera le dernier serveur MySQL 5.7 à partir des dépôts officiels d'Ubuntu :
$ apt-get install mysql-server
Le serveur Web MySQL démarrera automatiquement dès que l'installation sera terminée.
Vous pouvez également activer le service MySQL pour qu'il démarre automatiquement au redémarrage du serveur avec la commande suivante :
$ systemctl enable mysql
Exécutez la commande suivante pour sécuriser davantage votre installation :
$ mysql_secure_installation
Ce script vous aidera à effectuer des tâches de sécurité importantes telles que la configuration d'un mot de passe root, la désactivation de la connexion root à distance, la suppression d'utilisateurs anonymes, etc. Si le script demande le mot de passe root, appuyez simplement sur la touche [Entrée], car aucun mot de passe root n'est défini par défaut.
Étape 3 :Créer une base de données pour Redmine
Ensuite, nous devons créer une base de données pour notre installation Redmine. Connectez-vous à votre serveur MySQL avec la commande suivante et entrez votre mot de passe root MySQL :
$ mysql -uroot -p
Dans cette section, nous allons créer une nouvelle base de données MySQL :
CREATE DATABASE redmine_db; GRANT ALL PRIVILEGES ON redmine_db.* TO 'redmine_user'@'localhost' IDENTIFIED BY 'Password'; FLUSH PRIVILEGES; exit;
Assurez-vous de remplacer le mot de passe "Mot de passe" par un vrai mot de passe fort.
Étape 4 :Installer Ruby
Le moyen le plus simple d'installer Ruby sur votre serveur Ubuntu 18.04 consiste à utiliser le gestionnaire de packages apt. La version actuelle dans les référentiels Ubuntu est 2.5.1 qui est la dernière version stable de Ruby au moment de la rédaction de ce tutoriel.
Installez Ruby avec la commande suivante :
$ apt-get install ruby-full
Pour vérifier que tout est fait correctement, utilisez la commande ruby --version .
Le résultat doit ressembler à ce qui suit :
$ ruby --version ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux-gnu]
Étape 5 :Installer Nginx et Passenger
Pour installer Nginx sur votre serveur Ubuntu 18.04, vous devez saisir la commande suivante :
$ apt-get install nginx
Activez Nginx pour qu'il démarre au démarrage et démarrez le service à l'aide de ces deux lignes :
$ systemctl start nginx $ systemctl enable nginx
Pour installer Passenger, un module Nginx, commencez par installer les prérequis nécessaires du package :
$ apt-get install dirmngr gnupg apt-transport-https ca-certificates
Importez la clé GPG du référentiel et activez le référentiel "Phusionpassenger" :
$ apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 $ add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger bionic main'
Une fois le référentiel activé, mettez à jour la liste des packages et installez le module Passenger Nginx avec :
$ apt-get update $ apt-get install libnginx-mod-http-passenger
Étape 6 :Téléchargez et installez Redmine
Nous devons installer les dépendances nécessaires pour compiler Redmine :
$ apt-get install build-essential libmysqlclient-dev imagemagick libmagickwand-dev
Allez sur le site officiel de Redmine et téléchargez la dernière version stable de l'application. Au moment de la publication de cet article, la dernière version de Redmine est la version 4.0.2.
$ wget https://www.redmine.org/releases/redmine-4.0.2.zip -o /opt/redmine.zip
Une fois l'archive tar.gz téléchargée, décompressez-la dans /opt répertoire sur votre serveur :
$ cd /opt $ unzip redmine.zip $ mv redmine-4.0.2 /opt/redmine
Appliquez maintenant les autorisations de fichier et de dossier requises suivantes (elles sont nécessaires pour que Nginx ait accès aux fichiers) :
$ chown -R www-data:www-data /opt/redmine/ $ chmod -R 755 /opt/redmine/
Configurez les paramètres de la base de données :
$ cd /opt/redmine/config/ $ cp configuration.yml.example configuration.yml $ cp database.yml.example database.yml
Ouvrez le fichier database.yml fichier à l'aide de votre éditeur de texte préféré et mettez à jour les détails du nom d'utilisateur/mot de passe en fonction de ceux que vous avez définis à l'étape 3 :
$ nano database.yml
production: adapter: mysql2 database: redmine_db host: localhost username: redmine_user password: "Password" encoding: utf8
Ensuite, enregistrez et quittez le fichier.
Étape 7 :Installer les dépendances Ruby, générer des clés et migrer la base de données
Accédez au répertoire Redmine et installez le bundler et les autres dépendances Ruby :
$ cd /opt/redmine/ $ gem install bundler --no-rdoc --no-ri $ bundle install --without development test postgresql sqlite
Exécutez la commande suivante pour générer les clés et migrer la base de données :
$ bundle exec rake generate_secret_token $ RAILS_ENV=production bundle exec rake db:migrate
Étape 8 :Configurer Nginx
Ouvrez votre éditeur de texte préféré et créez le fichier de bloc de serveur Nginx suivant :
$ nano /etc/nginx/sites-available/your_domain.com.conf
# Redirect HTTP -> HTTPS
server {
listen 80;
server_name www.your_domain.com your_domain.com;
include snippets/letsencrypt.conf;
return 301 https://your_domain.com$request_uri;
}
# Redirect WWW -> NON WWW
server {
listen 443 ssl http2;
server_name www.your_domain.com;
ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/your_domain.com/chain.pem;
include snippets/ssl.conf;
return 301 https://your_domain.com$request_uri;
}
server {
listen 443 ssl http2;
server_name your_domain.com;
root /opt/redmine/public;
# SSL parameters
ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/your_domain.com/chain.pem;
include snippets/ssl.conf;
include snippets/letsencrypt.conf;
# log files
access_log /var/log/nginx/your_domain.com.access.log;
error_log /var/log/nginx/your_domain.com.error.log;
passenger_enabled on;
passenger_min_instances 1;
client_max_body_size 10m;
} Ensuite, enregistrez et quittez le fichier.
Pour activer la configuration du serveur que nous venons de créer, exécutez la commande suivante :
$ ln -s /etc/nginx/sites-available/your_domain.com.conf /etc/nginx/sites-enabled/your_domain.com.conf
Maintenant, vérifiez le fichier de configuration pour vous assurer qu'il n'y a pas d'erreurs de syntaxe. Toute erreur pourrait planter le serveur Web au redémarrage.
$ nginx -t
Sortie :
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
S'il n'y a pas d'erreurs, vous pouvez recharger la configuration Nginx.
$ service nginx reload
Étape 9 :Accéder à Redmine
Enfin, vous pouvez démarrer votre navigateur et l'installation est réussie, un écran similaire au suivant apparaîtra lorsque vous accéderez à https://your_domain.com/ :
Les identifiants de connexion par défaut pour Redmine sont :
- Nom d'utilisateur :admin
- Mot de passe :admin
Une fois le mot de passe modifié, vous serez redirigé vers la page du compte administrateur.
C'est ça. Vous avez installé avec succès Redmine sur votre VPS Ubuntu 18.04.
Bien sûr, vous n'avez pas besoin d'installer Redmine sur votre VPS Ubuntu 18.04 si vous utilisez l'un de nos services d'hébergement Redmine, auquel cas vous pouvez simplement demander à nos administrateurs Linux experts de le configurer pour vous. Ils sont disponibles 24h/24 et 7j/7 et prendront immédiatement en charge votre demande.
PS . Si vous avez aimé cet article sur l'installation de Redmine sur Ubuntu 18.04, partagez-le avec vos amis sur les réseaux sociaux à l'aide des boutons ci-dessous, ou laissez simplement une réponse dans la section des commentaires. Merci.