Установка SonarQube с Docker Compose
Данная статья предназначена для тех, кто искал подробное и понятное руководство о том, как установить SonarQube с Docker Compose.
SonarQube - это платформа с открытым исходным кодом для непрерывного анализа и измерения качества программного кода.
В этом руководстве мы будем рассматривать тот случай, когда у вас уже есть сервер с установленной на нем операционной системой Ubuntu Server 22.04 LTS.
Подробно о том, как установить Ubuntu Server 22.04 LTS, вы можете прочитать в моем руководстве “Установка Ubuntu Server 22.04 LTS”.
Также на сервере должен быть установлен Docker Engine и Docker Compose.
Узнать о том, как установить Docker Engine на Ubuntu Server, вы можете, прочитав “Установка Docker Engine и Docker Compose на Ubuntu Server”.
Кроме того, на сервер должен быть установлен OpenSSH, а также открыт 22 порт, чтобы иметь возможность подключаться к серверу по протоколу SSH.
Для установки OpenSSH на сервер вы можете воспользоваться командой:
sudo apt install openssh-serverЕсли вы планируете подключиться к серверу, используя операционную систему Windows, то можете воспользоваться PuTTY или MobaXterm.
В данном руководстве рассматривается подключение к серверу при помощи терминального эмулятора iTerm2, установленного на операционную систему macOS.
Обратите внимание, вам потребуется открыть следующие порты TCP для доступа к вашему серверу:
- TCP порт 80 - для получения бесплатного криптографического сертификата через центр сертификации Let’s Encrypt.
- TCP порт 443 - для доступа к веб-интерфейсу SonarQube.
Подключаемся к серверу, на который планируется установить SonarQube.
Теперь нужно создать конфигурационный файл YAML, который будет содержать все необходимые условия для работы SonarQube.
Создадим конфигурационный файл YAML, воспользовавшись текстовым редактором, с помощью команды:
vim sonarqube-traefik-letsencrypt-docker-compose.yml
Нажимаем на кнопку “i”, чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы SonarQube.
Далее вам необходимо внести изменения в конфигурацию, чтобы содержимое файла соответствовало вашим условиям. Параметры, которые требуется проверить или в которые нужно внести изменения имеют пометку “(replace with yours)”.
В данном руководстве для доступа к SonarQube из сети Интернет будет использоваться субдомен sonarqube.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш SonarQube будет доступен из сети Интернет.
Обратите внимание, в данном руководстве в качестве системы для управления базами данных будет использоваться PostgreSQL, а в качестве reverse proxy - Traefik.
В параметре “traefik.http.middlewares.authtraefik.basicauth.users” необходимо указать имя пользователя и хэш пароля для доступа к панели управления Traefik.
Обратите внимание, для получения хэша пароля можно воспользоваться данным сервисом.
Теперь нажмите на кнопку “Esc”, чтобы выйти из режима редактирования, а затем введите “:x” и нажмите на кнопку “Enter”, чтобы сохранить изменения и выйти из редактора.
Теперь запустим SonarQube с помощью команды:
docker compose -f sonarqube-traefik-letsencrypt-docker-compose.yml -p sonarqube up -d
С рабочей станции переходим по ссылке https://sonarqube.heyvaldemar.net, где sonarqube.heyvaldemar.net - имя моего сервера. Соответственно, вам необходимо указать имя вашего сервера SonarQube.
Теперь можно войти в панель управления SonarQube под учетной записью администратора SonarQube.
Логин для учетной записи администратора SonarQube по умолчанию: admin
Пароль для учетной записи администратора SonarQube по умолчанию: admin
Указываем имя пользователя и пароль учетной записи, обладающей правами администратора SonarQube, и нажимаем на кнопку “Log in”.
Далее необходимо изменить стандартный пароль на более надежный.
Указываем старый пароль в поле “Old Password”.
Указываем надежный пароль в поле “New Password и “Confirm Password”.
Нажимаем на кнопку “Update”.
Добро пожаловать в панель управления SonarQube.
Для доступа к панели управления Traefik необходимо с рабочей станции перейти по ссылке https://traefik.sonarqube.heyvaldemar.net, где traefik.sonarqube.heyvaldemar.net — имя моего сервера. Соответственно, вам необходимо указать имя вашего сервера с установленным Traefik.
Указываем имя пользователя и пароль, заданный ранее в конфигурационном файле YAML, и нажимаем на кнопку “OK”.
Добро пожаловать в панель управления Traefik.
