Comment installer l’outil de gestion de projet agile Jira sur Ubuntu 20.04

JIRA est un outil de gestion de projet développé par Atlassian qui est utilisé comme système de suivi des problèmes et des bogues. C’est un outil commercial et disponible en version d’essai pour une durée limitée. Tu peux utiliser JIRA dans les services d’assistance et les services clients pour créer des tickets et suivre le statut des tickets créés. Il est livré avec un tableau de bord simple et convivial qui t’aide à suivre l’avancement du travail et les problèmes. Il offre un riche ensemble de fonctionnalités, notamment : gestion des bugs et des défauts, rapports avancés, recherche et filtrage, flux de travail personnalisables, tableaux de bord personnalisables, sécurité et administration avancées et bien d’autres encore.

Dans ce tutoriel, nous allons te montrer comment installer l’outil de gestion de projet JIRA sur le serveur Ubuntu 20.04.

Conditions préalables

  • Un serveur fonctionnant sous Ubuntu 20.04 avec au moins 4 Go de RAM.
  • Un nom de domaine valide pointé avec l’IP de ton serveur.
  • Un mot de passe root est configuré sur le serveur.

Pour commencer

Tout d’abord, il est recommandé de mettre à jour ton système avec la dernière version. Tu peux les mettre à jour à l’aide de la commande suivante :

apt-get update -y

Une fois que tous les paquets sont mis à jour, installe les autres paquets nécessaires avec la commande suivante :

apt-get install unzip fontconfig -y

Une fois que tu as terminé, tu peux passer à l’étape suivante.

Installer et configurer la base de données MariaDB

JIRA utilise MySQL/MariaDB pour stocker ses données. Tu devras donc installer le serveur MariaDB dans ton serveur. Tu peux l’installer avec la commande suivante :

apt-get install mariadb-server -y

Une fois l’installation terminée, connecte-toi au shell MariaDB avec la commande suivante :

mysql

Une fois connecté, crée une base de données et un utilisateur pour JIRA avec la commande suivante :

MariaDB [(none)]> CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
MariaDB [(none)]> CREATE USER 'jirauser'@'localhost' IDENTIFIED BY 'password';

Ensuite, accorde tous les privilèges à jiradb avec la commande suivante :

MariaDB [(none)]> GRANT ALL ON jiradb.* TO 'jirauser'@'localhost' WITH GRANT OPTION;

Ensuite, supprime les privilèges et quitte le shell MariaDB avec la commande suivante: :

MariaDB [(none)]> FLUSH PRIVILEGES; MariaDB [(none)]> EXIT;

Ensuite, édite le fichier de configuration par défaut de MariaDB et modifie certains paramètres pour améliorer les performances.

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Ajoute les lignes suivantes à l’intérieur de [mysqld] :

default-storage-engine= INNODB
character_set_server = utf8mb4
innodb_default_row_format = DYNAMIC
innodb_large_prefix = ON
innodb_file_format = Barracuda
innodb_log_file_size = 2G
sql_mode = NO_AUTO_VALUE_ON_ZERO

Enregistre et ferme le fichier lorsque tu as terminé. Ensuite, redémarre le service MariaDB pour appliquer les modifications :

systemctl restart mariadb.service

Une fois que tu as terminé, tu peux passer à l’étape suivante.

Installe JIRA

Tout d’abord, tu dois télécharger la dernière version de JIRA depuis leur site officiel. Tu peux la télécharger avec la commande wget comme indiqué ci-dessous :

wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.7.1-x64.bin

Une fois le téléchargement terminé, modifie la permission du fichier téléchargé avec la commande suivante :

chmod a+x atlassian-jira-software-8.11.0-x64.bin

Ensuite, installe le logiciel JIRA en exécutant le binaire téléchargé comme indiqué ci-dessous :

./atlassian-jira-software-8.11.0-x64.bin

Tu devrais voir la sortie suivante :

This will install Jira Software 8.11.0 on your computer.
OK [o, Enter], Cancel [c]

Appuie sur Entrée pour continuer. Tu devrais voir le résultat suivant :

Click Next to continue, or Cancel to exit Setup.

Choose the appropriate installation or upgrade option.
Please choose one of the following:
Express Install (use default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing Jira installation [3]
2

Tape 2 et appuie sur Entrée pour une installation personnalisée. Tu devrais voir le message suivant :

Select the folder where you would like Jira Software to be installed.
Where should Jira Software be installed?
[/opt/atlassian/jira]

Sélectionne le chemin d’installation de Jira et appuie sur Entrée. Tu devrais voir le message suivant :

Default location for Jira Software data
[/var/atlassian/application-data/jira]

Maintenant, appuie sur Entrée pour continuer. Tu devrais voir le message suivant :

Configure which ports Jira Software will use.
Jira requires two TCP ports that are not being used by any other
applications on this machine. The HTTP port is where you will access Jira
through your browser. The Control port is used to startup and shutdown Jira.
Use default ports (HTTP: 8080, Control: 8005) - Recommended [1, Enter], Set custom value for HTTP and Control ports [2]
1

Tape 1 et appuie sur Entrée pour utiliser le port HTTP par défaut. Tu devrais voir le message suivant :

Jira can be run in the background.
You may choose to run Jira as a service, which means it will start
automatically whenever the computer restarts.
Install Jira as Service?
Yes [y, Enter], No [n]
y

Saisis y et appuie sur Entrée pour installer Jira as a Service. Tu devrais voir le message suivant :

Details on where Jira Software will be installed and the settings that will be used.
Installation Directory: /opt/atlassian/jira 
Home Directory: /var/atlassian/application-data/jira 
HTTP Port: 8080 
RMI Port: 8005 
Install as service: Yes 
Install [i, Enter], Exit [e]
i

Tape i et appuie sur Entrée pour démarrer l’installation. Tu devrais voir le message suivant :

Please wait a few moments while Jira Software is configured.

Installation of Jira Software 8.11.0 is complete
Start Jira Software 8.11.0 now?
Yes [y, Enter], No [n]
y

Saisis y et appuie sur Entrée pour lancer le logiciel Jira. Une fois que l’installation s’est terminée avec succès, tu devrais voir le message suivant :

Please wait a few moments while Jira Software starts up.
Launching Jira Software ...

Installation of Jira Software 8.11.0 is complete
Your installation of Jira Software 8.11.0 is now ready and can be accessed
via your browser.
Jira Software 8.11.0 can be accessed at http://localhost:8080
Finishing installation ...

À ce stade, Jira est installé sur ton serveur. Tu peux maintenant passer à l’étape suivante.

Configurer JIRA

Ensuite, tu devras télécharger le pilote MySQL JDBC et le copier dans le répertoire d’installation de Jira. Tout d’abord, télécharge-le à l’aide de la commande suivante :

wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-8.0.18.zip

Ensuite, décompresse le fichier téléchargé avec la commande suivante :

unzip mysql-connector-java-8.0.18.zip

Ensuite, copie le connecteur MySQL avec la commande suivante :

cp mysql-connector-java-8.0.18/mysql-connector-java-8.0.18.jar /opt/atlassian/jira/lib

Ensuite, arrête et démarre le service Jira pour appliquer les modifications :

/etc/init.d/jira stop
/etc/init.d/jira start

Configurer le proxy pour JIRA

Ensuite, tu devras définir un proxy dans Jira. Si tu veux accéder à Jira en utilisant ton domaine. Tu peux le définir en modifiant le fichier /opt/atlassian/jira/conf/server.xml :

nano /opt/atlassian/jira/conf/server.xml

Trouve les lignes suivantes :

<Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`"<>"
                   maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false"
                   maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPort="8443"
                   acceptCount="100" disableUploadTimeout="true" bindOnInit="false"/>

Remplace-les par les lignes suivantes :

<Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`"<>"
                   maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false"
                   maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPort="8443"
                   acceptCount="100" disableUploadTimeout="true" bindOnInit="false" scheme="http"
                   proxyName="jira.example.com" proxyPort="80"/>

Maintenant, exécute la commande suivante pour appliquer la nouvelle configuration.

/etc/init.d/jira stop
/etc/init.d/jira start

Configurer Nginx comme proxy inverse pour Jira

Ensuite, tu devras configurer Nginx comme proxy inverse si tu veux accéder à Jira sur le port 80.

Tout d’abord, installe le serveur web Nginx avec la commande suivante :

apt-get install nginx -y

Une fois le serveur Nginx installé, crée un nouveau fichier de configuration d’hôte virtuel Nginx :

nano /etc/nginx/sites-available/jira.conf

Ajoute les lignes suivantes :

server {
    listen 80;
    server_name jira.example.com;
    location / {
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://localhost:8080;
        client_max_body_size 10M;
    }
}

Enregistre et ferme le fichier lorsque tu as terminé. Ensuite, active le fichier d’hôte virtuel avec la commande suivante :

ln -s /etc/nginx/sites-available/jira.conf /etc/nginx/sites-enabled/

Ensuite, vérifie que Nginx n’a pas d’erreur de syntaxe avec la commande suivante :

nginx -t

Tu devrais voir la sortie suivante :

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Enfin, redémarre Jira et le service Nginx pour appliquer les modifications :

/etc/init.d/jira stop
/etc/init.d/jira start
systemctl nginx restart

Accéder à l’interface Web de Jira

Maintenant, ouvre ton navigateur Web et accède à l’interface Web de Jira en utilisant l’URL http://jira.example.com. Tu seras redirigé vers l’écran suivant :

Installateur web de Jira

Sélectionne« Je vais le configurer moi-même » et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Configuration de la base de données

Sélectionne« Ma propre base de données« , donne les détails de ta base de données et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Propriétés d'application

Indique le titre de ton application, le mode, l’URL et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Clé de licence

Indique ta clé de licence d’essai et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Compte Admin

Indique les détails de ton compte administrateur et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Notification par courriel

Clique sur le bouton Terminer pour terminer l’installation. Tu devrais voir l’écran de sélection de la langue :

Langue

Sélectionne la langue de ton choix et clique sur le bouton Continuer. Tu devrais voir l’écran suivant :

Choisis ton avatar

Choisis ton avatar et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Tableau de bord Jira

Clique sur« Créer un nouveau projet » pour créer ton premier projet. Tu devrais voir l’écran suivant :

Créer un projet

Choisis« Développement de logiciels Scrum » et clique sur le bouton Suivant. Tu devrais voir l’écran suivant :

Développement de logiciels Scrum

Clique sur le bouton Select pour sélectionner ton Workflow. Tu devrais voir l’écran suivant :

nom du projet

Indique le nom et la clé de ton projet, puis clique sur le bouton Soumettre. Tu devrais voir le tableau de bord Jira dans l’écran suivant :

Gestion de projet dans Jira

Conclusion

Dans le guide ci-dessus, tu as appris comment installer JIRA sur Ubuntu 20.04. Si tu ne sais pas comment installer et utiliser JIRA efficacement, ce guide t’aidera à installer JIRA sans problème.

Vous aimerez aussi...