3.1. Démarrage rapide (Ubuntu Linux 22.04)

Ce guide de démarrage rapide propose l’installation de Bugzilla de la façon la plus simple possible pour les utilisateurs pouvant choisir leur environnement. Il décrit l’installation en utilisant Ubuntu Linux 22.04 LTS, Apache et MariaDB. Il nécessite d’être familier avec l’environnement Linux et les lignes de commande.

3.1.1. Le matériel

Ubuntu 22.04 LTS Server nécessite un processeur 64 bits. Bugzilla lui-même n’a pas de prérequis en dehors de ça, si ce n’est de choisir du matériel fiable. Vous pouvez aussi utiliser une machine virtuelle 64 bits ou une instance cloud sur laquelle vous avez un accès root.

3.1.2. Installer le système d’exploitation

Téléchargez Ubuntu Server 22.04 LTS à partir du site de Ubuntu et suivrez les instructions d’installation. Quelques indications :

  • Il n’est pas nécessaire d’avoir un groupe lvm, le répertoire home ou racine chiffrés.

  • Choisir le partitionnement proposé par défaut (sauf bien sûr, quand le défaut est Non et qu’il est nécessaire de cliquer sur Oui pour continuer).

  • Choisir le nom de serveur que vous voulez.

  • Lors de la création de l’utilisateur Linux initial, le nommer bugzilla, lui donner un mot de passe fort et le noter quelque part.

  • Dans les options d’installation, choisir Serveur OpenSSH.

Redémarrer le serveur à la fin de l’installation.

3.1.3. Se substituer à l’utilisateur root

Connectez-vous en ssh sur la machine avec l’utilisateur bugzilla et démarrez une console. Puis :

sudo su

3.1.4. Installer les prérequis

apt install git nano

apt install apache2 build-essential mariadb-server libcgi-pm-perl libdigest-sha-perl libtimedate-perl libdatetime-perl libdatetime-timezone-perl libdbi-perl libdbix-connector-perl libtemplate-perl libemail-address-perl libemail-sender-perl libemail-mime-perl liburi-perl liblist-moreutils-perl libmath-random-isaac-perl libjson-xs-perl libgd-perl libchart-perl libtemplate-plugin-gd-perl libgd-text-perl libgd-graph-perl libmime-tools-perl libwww-perl libxml-twig-perl libnet-ldap-perl libauthen-sasl-perl libnet-smtp-ssl-perl libauthen-radius-perl libsoap-lite-perl libxmlrpc-lite-perl libjson-rpc-perl libtest-taint-perl libhtml-parser-perl libhtml-scrubber-perl libencode-perl libencode-detect-perl libemail-reply-perl libhtml-formattext-withlinks-perl libtheschwartz-perl libdaemon-generic-perl libapache2-mod-perl2 libapache2-mod-perl2-dev libfile-mimeinfo-perl libio-stringy-perl libcache-memcached-perl libfile-copy-recursive-perl libfile-which-perl libmariadb-dev perlmagick lynx graphviz python3-sphinx rst2pdf

Ceci prend un peu de temps. Ces commandes sont séparées en deux parties de sorte que vous puissiez faire les étapes suivantes (jusqu’à l’étape 7) dans un autre terminal sans attendre la fin de l’exécution de la deuxième commande. Si vous démarrez un autre terminal, vous devez à nouveau exécuter la commande sudo su.

3.1.5. Configuration de MariaDB

Indiquer les paramètres de serveur dont nécessaires pour Bugzilla :

Puis, ajouter un utilisateur dans MariaDB pour utiliser à utiliser avec Bugzilla :

mariadb -u root -e "CREATE USER bugs@localhost IDENTIFIED BY '$db_pass'"

Remplacer $db_pass avec un mot de passe fort. Le noter quelque part. Le mot de passe doit être différent de votre mot de passe de connexion.

Ensuite, donner à l’utilisateur Bugzilla les droits de création et de gestion de la base de données :

mariadb -u root -e "GRANT ALL PRIVILEGES ON bugs.* TO bugs@localhost"

Redémarrer MariaDB :

systemctl restart mariadb

3.1.6. Configurer Apache

nano /etc/apache2/sites-available/bugzilla.conf

Copier le contenu suivant et enregistrez le fichier :

Alias /bugzilla /var/www/webapps/bugzilla
<Directory /var/www/webapps/bugzilla>
  AddHandler cgi-script .cgi
  Options +ExecCGI
  DirectoryIndex index.cgi index.html
  AllowOverride All
</Directory>

Cette configuration indique que Bugzilla sera servi sur votre serveur sous le chemin /bugzilla. Pour des instructions de configuration plus avancées, veuillez vous référer à la section Apache de cette documentation.

a2ensite bugzilla

a2enmod cgid headers expires rewrite

service apache2 restart

3.1.7. Téléchargement de Bugzilla

Récupération de Bugzilla sur le dépôt Git :

mkdir -p /var/www/webapps

cd /var/www/webapps

git clone --branch release-X.X-stable https://github.com/bugzilla/bugzilla bugzilla

(où « X.X » est le numéro de version à 2 chiffres de la branche stable de Bugzilla que vous désirez - par ex. 5.2)

3.1.8. Installation des modules Perl additionnels

Bugzilla nécessite des versions plus récentes des modules Perl que délivre Ubuntu. Bugzilla contient un script install-module.pl qui les installera lcoalement dans votre répertoire Bugzilla sans affecter votre configuration Perl globale.

cd /var/www/webapps/bugzilla

./install-module.pl Template Email::Sender Email::Address::XS DBD::MariaDB

3.1.9. Vérification de la configuration

Bugzilla fournit un script appelé checksetup.pl qui vous aidera dans le processus d’installation. Il devra être exécuté à deux reprises. La première fois, il génère un fichier (appelé localconfig) pour les informations de connexion à la base de données, et la seconde fois (étape 10), il utilise les informations que vous avez indiquées dans ce fichier pour paramétrer la base de données.

./checksetup.pl

3.1.10. Édition de localconfig

nano localconfig

Vous devrez définir les valeurs suivantes :

  • Ligne 29 : pour $webservergroup indiquez www-data

  • Ligne 50 : pour db_driver indiquez mariadb

  • Ligne 67 : pour $db_pass indiquez le mot de passe pour l’utilisateur MariaDB bugs que vous avez créé un peu plus tôt

3.1.11. Vérification de la configuration (à nouveau)

Exécutez le script checksetup.pl à nouveau pour configurer la base de données.

./checksetup.pl

Le script demandera une adresse électronique, un nom réel et un mot de passe pour créer le premier compte Bugzilla, lequel sera administrateur. Notez l’adresse électronique et le mot de passe que vous avez indiqués.

3.1.12. Test du serveur

./testserver.pl http://localhost/bugzilla

Tous les tests devraient s’exécuter avec succès. Vous obtiendrez un avertissement sur l’échec du lancement de gdlib-config. Ignorez-le.

3.1.13. Accès à Bugzilla avec un navigateur Web

Accès à la page d’accueil :

lynx http://localhost/bugzilla

Il n’est pas vraiment possible d’utiliser Bugzilla avec Lynx, mais vous pourrez accéder à la page d’accueil pour valider visuellement que Bugzilla est démarré et qu’il fonctionne.

Vous pourriez vouloir configurer votre DNS pour que le serveur soit accessible à l’aide d’un nom plutôt que de son adresse IP. Ce paramétrage n’est pas dans le périmètre de ce document. Le serveur Bugzilla est accessible sur votre réseau local sur l’URL suivante http://<adresse IP>/bugzilla, où <adresse IP> est (à moins que votre paramétrage réseau soit complexe) l’adresse commençant par 192 qui s’affiche quand vous exécutez la commande hostname -l.

3.1.14. Accès à Bugzilla depuis Internet

Pour pouvoir accéder à Bugzilla depuis n’importe où dans le monde, vous n’avez pas besoin de le rendre accessible à tous sur Internet, il existe des services de VPN gratuits qui permettent de créer son propre réseau accessible de n’importe où. L’un d’eux est Tailscale, qui dispose d’un guide de démarrage rapide tout à fait accessible.

Si votre installation de Bugzilla est accessible à tous sur Internet, il est essentiel de mettre en place SSL, de sorte que la communication entre le serveur et les utilisateurs soit chiffrée. Pour les installations locales ou sur un intranet, ceci est moins important, et pour ces cas-là, vous pouvez créer un certificat auto-signé. instead.

Il existe plusieurs moyens de créer des certificats gratuits, grâce à Let’s Encrypt par exemple. Les deux principaux sont mod_md de Apache et certbot de l’EFF, mais nous n’aborderons pas la confection des certificats, car cela n’est pas dans le périmètre de ce guide.

3.1.15. Configuration de Bugzilla

Sur la page d’accueil de Bugzilla, cliquez sur Se connecter dans l’en-tête de la page, puis utilisez identifiants de l’utilisateur administrateur que vous avez défini à l’étape 10.

Cliquez sur le lien Paramètres puis définissez les paramètres suivants dans la section Paramètres requis :

  • urlbase: http://<nom_du_serveur>/bugzilla/ ou http://<adresse IP>/bugzilla/

  • ssl_redirect: on si vous mettez en place un certificat

Cliquez sur Enregistrer les modifications au bas de la page.

Il existe plusieurs façons pour que Bugzilla puisse envoyer des courriels. La façon la plus simple consiste à utiliser Gmail, ce que nous allons faire ici. Rendez-vous sur https://gmail.com et créez un nouveau compte Gmail pour Bugzilla. Ensuite, cliquez sur la section Courriel dans la page des Paramètres en utilisant le lien dans la colonne de gauche et indiquez les valeurs de paramètres suivantes :

  • mail_delivery_method : SMTP

  • mailfrom : nouvelle_adresse_gmail@gmail.com

  • smtpserver : smtp.gmail.com:465

  • smtp_username : nouvelle_adresse_gmail@gmail.com

  • smtp_password : nouveau_mot_de_passe_gmail

  • smtp_ssl : On

Cliquez sur le bouton Enregistrez les modifications au bas de la page.

Et voilà. :-)

Cette documentation contient très probablement des bogues ; si vous en découvrez, veuillez les signaler ici.