Привет, хаброжители!

В данном руководстве хочу изложить пошаговую настройку по развёртыванию платформы для непрерывного анализа и измерения качества кода. Подобных статей в сети достаточно много, но я хочу выделить лишь главное, чтобы все новички с первого раза смогли с ней разобраться.

Вы уже изучили вики, не так ли?

И прежде чем начнём

Хочу, чтобы вы определились, какую версию вам внедрять, ведь с каждым обновлением всё больше и больше плагинов становятся платными, что, естественно, скажется на финансовых затратах или функционале.

В общем — перейдите по этой ссылке и убедитесь сами: plugin version matrix

Согласно документации, сервер и базу данных рекомендуется держать на разных машинках.

Но в песочнице можно потренировать и на одной.

Итак. Я работаю с виртуальными машинками. Подготовил 2 штуки, точнее поднял одну и сделал из неё дубликат.

Под рукой у меня оказался Ubuntu server 18.04.3 LTS.

Изменить имя и ip вы сможете легко и просто с помощью этих команд:

::: change hostname :::

$ hostnamectl set-hostname sonarapp
sudo nano /etc/hostname
sudo nano /etc/hosts

::: change ip ubuntu :::

sudo nano /etc/netplan/01-eth0.yaml

Там найдите знакомые строчки и поменяйте параметры имени машинки и IP адреса.

И что должно получиться:

Sonar app server [SonarApp]
user: admin
IP: 192.168.0.15
Platform: Ubuntu server 18.04.3 LTS [8 cores, 16GB of RAM, 20Gb + 50Gb (/opt) disk space]

Sonar database [SonarDB]
user: admin
IP: 192.168.0.16
Platform: Ubuntu server 18.04.3 LTS [8 cores, 16GB of RAM, 20Gb + 100Gb disk space]

Непосредственно начало работы.

Заходим на первую тачку — 192.168.0.15 (SonarApp) НЕ под root'ом, а под своим пользаком admin'ом. Те строчки, что начинаются с символа $ — это терминальный ввод, а остальные — уже что правим в файлах или что должны получить на выходе (вывод инфы)

• нужна JAVA. Возьмём OpenJDK

::: Install open-jdk11 :::

$ sudo apt-get install openjdk-11-jdk

::: change java PATH :::

$ nano ~/.bash_profile
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64/bin/java 
export PATH=/usr/lib/jvm/java-11-openjdk-amd64/bin:$PATH

::: Download and configure SonarQube :::

Download the SonarQube installer files archive.

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

Install unzip by running:

# apt-get -y install unzip

Unzip the archive using the following command

$ sudo unzip sonarqube-7.9.1.zip -d /opt

Rename the directory

$ sudo mv /opt/sonarqube-7.9.1 /opt/sonarqube

Add Sonar User and Privileges

Create a user named sonar and make it the owner of the /opt/sonarqubedirectory

$ sudo adduser sonar
$ sudo passwd sonar
$ sudo chown -R sonar:sonar /opt/sonarqube

Continuation configure SonarQube

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

sonar.web.host=192.168.0.15
sonar.jdbc.username=sonar
sonar.jdbc.password=sonar
# sonar.jdbc.url=jdbc:postgresql://localhost/username
sonar.jdbc.url=jdbc:postgresql://192.168.0.16/sonar
sonar.web.javaAdditionalOpts=-server

Create a file /etc/systemd/system/sonarqube.service and past the following content on to the file

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

[Service]
Type=simple
User=sonar
Group=sonar
PermissionsStartOnly=true
ExecStart=/bin/nohup java -Xms32m -Xmx32m -Djava.net.preferIPv4Stack=true -jar /opt/sonarqube/lib/sonar-application-7.9.1.jar
StandardOutput=syslog
LimitNOFILE=65536
LimitNPROC=8192
TimeoutStartSec=5
Restart=always

[Install]
WantedBy=multi-user.target

Start and enable sonarqube

$ sudo systemctl start sonarqube
$ sudo systemctl enable sonarqube

To check if the service is running, run:

$ sudo systemctl status sonarqube

Log:

tail -f /opt/sonarqube/logs/sonar.log

Теперь подключаемся ко второй тачке

192.168.0.16 (SonarDB) под нашим добрым admin'ом.

::: Installing the Database :::

Install the PostgreSQL repository.

$ sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'
$ wget -q https://www.postgresql.org/media/keys/ACCC4CF8.asc -O - | sudo apt-key add -

Install the PostgreSQL database server by running:

$ sudo apt-get -y install postgresql postgresql-contrib

Start PostgreSQL server and enable it to start automatically at boot time by running:

$ sudo systemctl start postgresql
$ sudo systemctl enable postgresql

Change the password for the default PostgreSQL user

$ sudo passwd postgres

Switch to the postgres user.

$ su - postgres

Switch to the PostgreSQL shell.

$ psql

::: Configure PostgreSQL :::

Set a password for the newly created user for SonarQube database.

CREATE ROLE sonar WITH PASSWORD 'sonar';
SELECT rolname FROM pg_roles;
alter role sonar login;
SELECT pg_reload_conf();
Create a new database for PostgreSQL database by running:
create database sonar owner sonar;

Exit from the psql shell:

'\q'

::: Move Databases PostgreSQL :::

Stop PostgreSQL service

$ service postgresql stop
# or
$ /usr/lib/postgresql/10/bin/pg_ctl stop -D /var/lib/postgresql/10/main

Change data directory.

$ psql

# show data_directory;
/var/lib/postgresql/10/main

$ sudo rsync -av /var/lib/postgresql /opt/sonardb
$ sudo mv /var/lib/postgresql/*/main /var/lib/postgresql/*/main.bak

$ sudo nano /etc/postgresql/*/main/postgresql.conf # change location for new data_directory.
data_directory = '/opt/sonardb/postgresql/10/main'
listen_addresses = '*' 

Change check

$ sudo -u postgres psql

# show data_directory;
______________________
/opt/sonardb/postgresql/10/main
# \q

А также нужно проверить системные параметры. Их можно добавить в файл /etc/sysctl.conf или ввести в терминале :

sysctl -w vm.max_map_count=262144
sysctl -w fs.file-max=65536
ulimit -n 65536
ulimit -u 4096

Для проверки доступности базы данных подключимся к 192.168.0.15 и наберём:

$ psql -h 192.168.0.16 -p 5432 -U sonar

Вот и всё. Чтобы убедиться, что всё работает — переходим в браузер (убедитесь что 192.168.X.X сеть доступна из Вашей или воспользуйтесь links).

Наберём 192.168.0.15:9000 и Вас должно приветствовать окошко авторизации.
Логин: admin
Пароль: admin
это учётная запись админа, доступная по умолчанию.