Comment installer SonarQube sur CentOS 7

• Conditions préalables
• Étape 1: effectuer une mise à jour du système
• Étape 2: installer Java
• Étape 3: installer et configurer PostgreSQL
• Étape 4: Téléchargez et configurez SonarQube
• Étape 5: configurer le service Systemd
• Étape 5: configurer le proxy inverse
• Étape 6: configurer le pare-feu
• Errata

SonarQube est un outil open source pour le développement de systèmes qualité. Il est écrit en Java et prend en charge plusieurs bases de données. Il offre des capacités pour inspecter en continu le code, montrer la santé d'une application et mettre en évidence les problèmes récemment introduits. Il contient des analyseurs de code qui sont équipés pour détecter les problèmes délicats. Il s'intègre également facilement avec DevOps.

Dans ce didacticiel, nous allons installer la dernière version de SonarQube sur CentOS 7.

Remarque: ce document a été mis à jour depuis sa publication d'origine. Voir la section "Errata" dans les notes de bas de page.

Conditions préalables

• Une instance de serveur Vultr 64 bits CentOS 7 avec au moins 2 Go de RAM.
• Un utilisateur sudo .

Étape 1: effectuer une mise à jour du système

Avant d'installer des packages sur l'instance de serveur CentOS, il est recommandé de mettre à jour le système. Connectez-vous à l'aide de l'utilisateur sudo et exécutez les commandes suivantes pour mettre à jour le système.

sudo yum -y install epel-release
sudo yum -y update
sudo shutdown -r now

Une fois le redémarrage du système terminé, reconnectez-vous en tant qu'utilisateur sudo et passez à l'étape suivante.

Étape 2: installer Java

Téléchargez le package Oracle SE JDK RPM en tapant:

wget --no-cookies --no-check-certificate --header "Cookie:oraclelicense=accept-securebackup-cookie" "http://download.oracle.com/otn-pub/java/jdk/8u131-b11/d54c1d3a095b4ff2b6607d096fa80163/jdk-8u131-linux-x64.rpm"

Installez le package téléchargé en tapant:

sudo yum -y localinstall jdk-8u131-linux-x64.rpm

Vous pouvez maintenant vérifier la version de Java en tapant:

java -version

Étape 3: installer et configurer PostgreSQL

Installez le référentiel PostgreSQL en tapant:

sudo rpm -Uvh https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-centos96-9.6-3.noarch.rpm

Installez le serveur de base de données PostgreSQL en exécutant:

sudo yum -y install postgresql96-server postgresql96-contrib

Initialisez la base de données:

sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb

Modifiez le /var/lib/pgsql/9.6/data/pg_hba.confpour activer l'authentification basée sur MD5.

sudo nano /var/lib/pgsql/9.6/data/pg_hba.conf

Recherchez les lignes suivantes et passez peerà trustet idnetvers md5.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident

Une fois mise à jour, la configuration devrait ressembler à celle ci-dessous.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

Démarrez le serveur PostgreSQL et activez-le pour démarrer automatiquement au démarrage en exécutant:

sudo systemctl start postgresql-9.6
sudo systemctl enable postgresql-9.6

Modifiez le mot de passe de l'utilisateur PostgreSQL par défaut.

sudo passwd postgres

Passez à l' postgresutilisateur.

su - postgres

Créez un nouvel utilisateur en tapant:

createuser sonar

Basculez vers le shell PostgreSQL.

psql

Définissez un mot de passe pour l'utilisateur nouvellement créé pour la base de données SonarQube.

ALTER USER sonar WITH ENCRYPTED password 'StrongPassword';

Créez une nouvelle base de données pour la base de données PostgreSQL en exécutant:

CREATE DATABASE sonar OWNER sonar;

Quittez le psqlshell:

\q

Revenez à l'utilisateur sudo en exécutant la exitcommande.

Étape 4: Téléchargez et configurez SonarQube

Téléchargez l'archive des fichiers du programme d'installation de SonarQube.

wget https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-6.4.zip

Vous pouvez toujours rechercher le lien vers la dernière version de l'application sur la page de téléchargement de SonarQube .

Installez décompressez en exécutant:

sudo yum -y install unzip

Décompressez l'archive à l'aide de la commande suivante.

sudo unzip sonarqube-6.4.zip -d /opt

Renommez le répertoire:

sudo mv /opt/sonarqube-6.4 /opt/sonarqube

Ouvrez le fichier de configuration SonarQube à l'aide de votre éditeur de texte préféré.

sudo nano /opt/sonarqube/conf/sonar.properties

Trouvez les lignes suivantes.

#sonar.jdbc.username=
#sonar.jdbc.password=

Décommentez et fournissez le nom d'utilisateur et le mot de passe PostgreSQL de la base de données que nous avons créée précédemment. Cela devrait ressembler à:

sonar.jdbc.username=sonar
sonar.jdbc.password=StrongPassword

Ensuite, trouvez:

#sonar.jdbc.url=jdbc:postgresql://localhost/sonar

Décommentez la ligne, enregistrez le fichier et quittez l'éditeur.

Étape 5: configurer le service Systemd

SonarQube peut être démarré directement à l'aide du script de démarrage fourni dans le package d'installation. Par souci de commodité, vous devez configurer un fichier d'unité Systemd pour SonarQube.

sudo nano /etc/systemd/system/sonar.service

Remplissez le fichier avec:

[Unit]
Description=SonarQube service
After=syslog.target network.target

[Service]
Type=forking

ExecStart=/opt/sonarqube/bin/linux-x86-64/sonar.sh start
ExecStop=/opt/sonarqube/bin/linux-x86-64/sonar.sh stop

User=root
Group=root
Restart=always

[Install]
WantedBy=multi-user.target

Démarrez l'application en exécutant:

sudo systemctl start sonar

Activez le service SonarQube pour qu'il démarre automatiquement au démarrage.

sudo systemctl enable sonar

Pour vérifier si le service est en cours d'exécution, exécutez:

sudo systemctl status sonar

Étape 5: configurer le proxy inverse

Par défaut, SonarQube écoute localhost sur le port 9000. Dans ce didacticiel, nous utiliserons Apache comme proxy inverse afin que l'application soit accessible via le port HTTP standard. Installez le serveur Web Apache en exécutant:

sudo yum -y install httpd

Créez un nouvel hôte virtuel.

sudo nano /etc/httpd/conf.d/sonar.yourdomain.com.conf

Remplissez le fichier avec:

<VirtualHost *:80>  
    ServerName sonar.yourdomain.com
    ServerAdmin me@yourdomain.com
    ProxyPreserveHost On
    ProxyPass / http://localhost:9000/
    ProxyPassReverse / http://localhost:9000/
    TransferLog /var/log/httpd/sonar.yourdomain.com_access.log
    ErrorLog /var/log/httpd/sonar.yourdomain.com_error.log
</VirtualHost>

Démarrez Apache et activez-le pour démarrer automatiquement au démarrage:

sudo systemctl start httpd
sudo systemctl enable httpd

Étape 6: configurer le pare-feu

Autorisez le port HTTP requis via le pare-feu du système.

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --reload

Démarrez le service SonarQube:

sudo systemctl start sonar

Vous devrez également désactiver SELinux:

sudo setenforce 0

SonarQube est installé sur votre serveur, accédez au tableau de bord à l'adresse suivante.

http://sonar.yourdomain.com

Connectez-vous en utilisant le compte administrateur initial adminet admin. Vous pouvez désormais utiliser SonarQube pour analyser en continu le code que vous avez écrit.

Errata

Si vous installez SonarQube 7.1 (ou une version plus récente), apportez les modifications ci-dessous car les versions plus récentes d'Elasticsearch ne peuvent pas être exécutées en tant qu'utilisateur root.

• Mettre à jour les autorisations: chown -R sonar:sonar /opt/sonarqube
• Modifiez /opt/sonarqube/bin/linux-x86-64/sonar.sh, changez #RUNASpour être " sonar".
• Modifiez /etc/systemd/system/sonar.service, changez le groupe d'utilisateurs en " sonar".