Применение изменений конфигурации для 4.18.+

Важно

Инструкция актуальна для ТестОпс версии ниже 4.18.0.

Важно

Начиная с версии 4.18.0, в сервисе uaa должны постоянно присутствовать описанные ниже параметры, без этих параметров регистрация пользователей в ТестОпс не будет работать.

SPRING_MAIL_HOST=smtp.gmail.com
SPRING_MAIL_PORT=465
SPRING_MAIL_USERNAME=username
SPRING_MAIL_PASSWORD=password
[email protected]
SPRING_MAIL_PROPERTIES_MAIL_SMTP_AUTH=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_ENABLE=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_TRUST=smtp.gmail.com

Как обновить конфигурации

Все необходимые параметры присутствуют в конфигурационных файлах, если вы устанавливаете ТестОпс с нуля. Если вы обновляете существующую версию, и у вас еще не настроен SMTP-сервер, то эта статья точно для вас.

Примечание

Настройки SMTP-сервера требуются и для процесса восстановления пароля.

Kubernetes

В актуальном Хелм чарте уже есть все необходимые настройки в файле values.yaml в разделе smtp.

Все, что вам нужно, это...

1. Включить функциональность и установить значения для работы с вашим SMTP-сервером.
2. Обновить настройки версии до 4.18.1.
3. Выполните helm upgrade.

Docker compose

Внимание

1. Следующие рекомендации подразумевает, что вы не вносили никаких изменений в файл docker-compose.yml и выполняли все настройки в файле .env, как рекомендуется в руководстве по установке docker compose.
2. Следующая рекомендация подразумевает, что вы используете этот набор конфигурационных параметров в производственной среде, как это рекомендовано в руководстве по установке docker compose.

Выполните следующие действия

1. Убедитесь, что вы используете актуальную конфигурацию для развертывания в docker compose.
2. Скачайте шаблоны файлов .env и docker-compose.yml
3. Создайте копию существующего docker-compose.yml, например, cp docker-compose.yml docker-compose.backup.
4. Замените docker-compose.yml тем же файлом, который был загружен на шаге 2.
5. В секции uaa раздела env-example найдите пример настроек, связанных с конфигурацией электронной почты.
6. Скопируйте настройки электронной почты в существующий файл .env.
7. Добавьте правильные параметры конфигурации для работы с вашим SMTP-сервером.
8. Обновите параметр VERSION до 4.18.0.
9. Остановите (docker compose down) установленную систему.
10. Запустите (docker compose up -d) установленную систему.

Установка пакетами Linux

ТестОпс должен быть развернут как описано здесь.

Существующая установка

Если вы установили ТестОпс с помощью пакетов deb или rpm, вам необходимо обновить установленное программное обеспечение

sudo apt-get install allure-testops-<package_name>=4.18.0

# или

yum install allure-testops-<package_name>-4.18.0-1

package_name будет box или min в зависимости от ранее выбранной установки.

затем откройте файл для редактирования /opt/allure-testops/uaa/conf/allure-uaa.conf и добавье в конец файла следующие строки:

SPRING_MAIL_HOST=smtp.<domain>
SPRING_MAIL_PORT=465
SPRING_MAIL_USERNAME=username
SPRING_MAIL_PASSWORD=password
SPRING_MAIL_PROPERTIES_MAIL_SMTP_AUTH=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_ENABLE=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_TRUST=smtp.<domain>

обновите строки с правильными параметрами для вашего SMTP-сервера и сохраните файл.

Затем перезапустите службы как обычно.