Установка ТестОпс версии 5.x с помощью DEB-пакетов ​

Внимание

В разделе описывается, как установить и запустить ТестОпс версии 5.х на Ubuntu Linux с помощью DEB-пакетов.

Инструкция для версии 4.x перенесена в архив. Чтобы установить и запустить ТестОпс, пожалуйста, используйте только актуальную инструкцию.

Совет

В зависимости от настроек операционной системы вы можете столкнуться с проблемами при вставке многострочных команд в терминал. Чтобы исправить ситуацию, выполните эту команду перед началом работы:

sh
bind 'set enable-bracketed-paste on'

Миграция с ТестОпс версии 4.x ​

Внимание

ТестОпс версии 5.х нельзя развернуть поверх версии 4.х. Для обновления необходима миграция данных в одну базу данных, а также переход на новую конфигурацию.

Перейти на ТестОпс версии 5.х можно только с версии 4.26.5. Обновление с более старых версий приведет к сбоям в системе и потере данных.

Чтобы обновить ТестОпс версии 4.26.5 до версии 5.x, пожалуйста, обратитесь к руководству по миграции.

Подготовительные шаги для установки ТестОпс версии 5.x «с нуля» ​

  1. Убедитесь, что вы используете Ubuntu версий 20.04 LTS, 22.04 LTS или 24.04 LTS. ТестОпс официально не поддерживается на не-LTS версиях.

    Чтобы проверить версию вашей операционной системы, выполните команду в терминале:

    sh
    lsb_release -a

    Важно

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

  2. Разверните дополнительные сервисы:

    Рекомендуется запускать PostgreSQL и S3-совместимое хранилище на разных серверах.

  3. Получите лицензию на ТестОпс.

    Чтобы получить ключ для коммерческой лицензии, свяжитесь с нами по адресу [email protected]. В письме укажите, что планируете установить ТестОпс с помощью DEB-пакетов.

    Вместе с лицензионным ключом вы получите имя пользователя и пароль для доступа к DEB-репозиторию ТестОпс.

  4. Получите подробную информацию о настройке аутентификации внутри вашей организации.

    Данные, необходимые для настройки, зависят от того, какой подход к аутентификации пользователя вы выберете. Возможные варианты:

    • Стандартная аутентификация с помощью имени пользователя и пароля, реализованная в ТестОпс.

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

    • Аутентификация через внешнего провайдера идентификационных данных (IdP).

      Детали, необходимые для этого, могут отличаться в зависимости от типа используемого провайдера идентификационных данных. Подробная информация о настройках находится в соответствующих разделах документации.

Установка зависимостей ​

Eclipse Temurin ​

Для запуска ТестОпс мы рекомендуем использовать среду JRE Eclipse Temurin v21. Чтобы ее установить, выполните следующие команды:

sh
sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install -y temurin-21-jre

Более подробную информацию об установке можно найти на сайте Adoptium.

PostgreSQL ​

Хотя это не рекомендуется для высоконагруженных случаев, можно запустить PostgreSQL на той же машине, на которой будет работать ТестОпс. Чтобы установить его, выполните следующие команды в терминале:

sh
wget -q -O- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor --output /usr/share/keyrings/pgdg.gpg
echo "deb [signed-by=/usr/share/keyrings/pgdg.gpg] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
sudo apt update
sudo apt install -y postgresql-15

Более подробная информация доступна в инструкции по установке на сайте PostgreSQL.

RabbitMQ ​

Важно

ТестОпс не поддерживает работу с кворумными очередями в режиме высокодоступного сервиса в RabbitMQ версии 4.0 и выше. Если для инсталляции RabbitMQ требуется режим высокой доступности — необходимо выбирать RabbitMQ версии ниже 4.0.

Чтобы установить RabbitMQ, выполните следующие команды в терминале:

sh
wget -q -O- https://dl.cloudsmith.io/public/rabbitmq/rabbitmq-erlang/setup.deb.sh | sudo bash
sudo apt install -y socat logrotate erlang
wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.13.2/rabbitmq-server_3.13.2-1_all.deb -O rabbitmq-server.deb
sudo dpkg -i rabbitmq-server.deb
sudo systemctl enable rabbitmq-server
sudo systemctl start rabbitmq-server

Более подробная информация доступна в инструкции по установке на сайте RabbitMQ.

MinIO ​

Вы можете использовать MinIO как объектное хранилище для ТестОпс, совместимое с S3. Чтобы установить MinIO, следуйте одной из инструкций по установке на официальном сайте:

Redis ​

Чтобы установить Redis, выполните следующие команды в терминале:

sh
wget -q -O- https://packages.redis.io/gpg | sudo gpg --dearmor --output /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
sudo apt update
sudo apt install -y redis

Более подробная информация доступна в инструкции по установке на сайте Redis.

Установка ТестОпс ​

Пакеты ТестОпс распространяются через репозиторий, который требует аутентификации. Если у вас есть пробная или коммерческая лицензия на ТестОпс, вы должны были получить имя пользователя и пароль в том же письме, в котором вы получили лицензионный ключ. Если вы не можете найти их, свяжитесь с нами по адресу [email protected].

Получив логин и пароль, установите пакет ТестОпс:

  1. Откройте терминал.

  2. Если вы не root-пользователь, введите команду sudo su и пароль для получения прав администратора.

  3. Импортируйте публичный ключ реестра qatools, выполнив команды:

    sh
    curl -s https://pub.qatools.ru/qatools.gpg | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/qatools.gpg --import
chmod 644 /etc/apt/trusted.gpg.d/qatools.gpg

  4. Выполните команду (скопируйте все строки):

    sh
    cat << EOF >> /etc/apt/sources.list.d/qatools.list
deb [trusted=yes] https://dl.qatools.ru/repository/debian stable main
EOF

  5. Убедитесь, что нужный для установки файл был обновлен:

    sh
    cat /etc/apt/sources.list.d/qatools.list

  6. Замените параметры USERNAME и PASSWORD на учетные данные, которые вам прислали при покупке лицензии ТестОпс, и выполните команду (скопируйте все строки):

    sh
    cat << EOF >> /etc/apt/auth.conf.d/qatools.conf
machine dl.qatools.ru login USERNAME password PASSWORD
EOF

  7. Убедитесь, что нужный для установки файл был обновлен:

    sh
    cat /etc/apt/auth.conf.d/qatools.conf

  8. Перезапустите терминал для применения выполненных настроек.

  9. Обновите индекс доступных пакетов:

    sh
    sudo apt update

  10. Выберите версию ТестОпс для установки. Список доступных версий указан в разделе Информация о релизах. Мы рекомендуем использовать только последнюю доступную версию, так как она содержит новые возможности и улучшения в ТестОпс, а также исправления ошибок.

    Скопируйте и выполните эту команду целиком, а не ее строки по отдельности. Перед выполнением команды замените 5.7.0 на версию ТестОпс, которую вы хотите использовать.

    sh
    cat <<EOF | sudo tee /etc/apt/preferences.d/qatools
Package: testops
Pin: version 5.7.0
Pin-Priority: 1000
EOF

  11. Установите пакет ТестОпс.

    sh
    sudo apt install -y testops

  12. Если вы используете межсетевой экран, убедитесь, что входящий трафик на TCP-порт 8080 разрешен.

    Если вы используете ufw, выполните команду:

    sh
    sudo ufw allow 8080/tcp

Изменение файлов конфигурации ​

Параметры конфигурации задаются в файле конфигурации /opt/testops/conf/testops.conf.

Чтобы изменить параметры, откройте файл в текстовом редакторе, измените нужные значения и сохраните его. После этого перезапустите ТестОпс, чтобы применить изменения.

Совет

Для изменения файла конфигурации необходимо использовать права суперпользователя. Один из способов изменить его с такими правами - выполнить команду sudo nano в терминале:

sh
sudo nano /opt/testops/conf/testops.conf

Для стандартной настройки выполните следующее:

  1. Настройте URL-адрес ТестОпс.
  2. Настройте параметры безопасности.
  3. Добавьте адрес электронной почты первого администратора.
  4. Настройте аутентификацию.
  5. Настройте сервисы хранения данных.
  6. Настройте сервис очередей.

Настройка URL-адреса ТестОпс ​

В параметре ALLURE_ENDPOINT укажите URL, который должен использоваться для доступа к веб-интерфейсу ТестОпс.

sh
ALLURE_ENDPOINT=https://testops.example.com/

Примечание

Чтобы ТестОпс был доступен через HTTPS, необходимо настроить обратный прокси-сервер. Подробнее см. в разделе Сеть.

Если вы планируете интеграцию ТестОпс с Jira, используйте HTTPS и включите защищенные cookie, чтобы интеграция работала правильно. Подробнее см. в разделах Интеграция с Jira Data Center (Jira Server) и Интеграция с Jira Software Cloud.

sh
ALLURE_SECURE=true

Настройка параметров безопасности ​

Ключ шифрования ​

В качестве меры безопасности ТестОпс шифрует важные значения в базе данных с помощью алгоритма AES-256. Таким образом, если злоумышленник получит доступ к базе данных PostgreSQL, но не к файлу конфигурации, он не получит учетные данные сторонних сервисов, используемых вашим инстансом.

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

ini
ALLURE_CRYPTO_PASSWORD=MolehillQuiverLatterSturdily

Важно

Если вы забудете значение параметра ALLURE_CRYPTO_PASSWORD или измените его после начального развертывания, все текущие интеграции перестанут работать. В таком случае вам нужно будет зайти в настройки каждого проекта и заново ввести учетные данные для каждой интеграции.

Секретный ключ JWT ​

ТестОпс использует открытый стандарт JSON Web Token для аутентификации запросов. В рамках этого стандарта вам нужно создать секретный ключ, который будет использоваться для подписи токенов.

Чтобы установить ключ, укажите его в качестве значения параметра ALLURE_JWT_SECRET. Рекомендованная длина ключа — от 8 до 16 символов. Чем длиннее ключ, тем больше ресурсов ЦПУ понадобится для вычисления подписи.

Вы можете изменить секретный ключ в любое время, это не повлияет на работу пользователей.

ini
ALLURE_JWT_SECRET=123456789ABCDEF

Настройка почты для первого администратора ​

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

Важно

Начиная с версии 5.4.0, эти настройки обязательны при развертывании нового инстанса ТестОпс. Начиная с версии 5.6.0, первый запуск ТестОпс невозможен без использования настроенного SMTP-сервера.

Чтобы настроить SMTP:

  1. В параметре ALLURE_MAIL_ROOT укажите адрес электронной почты первого администратора.

    Пример:

    sh
    ALLURE_MAIL_ROOT=[email protected]

  2. Укажите учетные данные SMTP согласно инструкции.

Настройка аутентификации ​

Необходимый шаг при развертывании ТестОпс — настройка того, как пользователи (кроме первого администратора) будут регистрироваться и входить в систему.

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

Этот вариант аутентификации требует включенного SMTP. Дополнительная настройка не требуется.

Настройка сервисов хранения данных ​

Чтобы подключиться к сервисам хранения данных, которые используются в ТестОпс, определите параметры для:

  • подключения к серверу хранения данных Redis:

    • SPRING_DATA_REDIS_HOST — имя хоста сервера;
    • SPRING_DATA_REDIS_PORT — порт сервера;
    • SPRING_DATA_REDIS_PASSWORD — пароль для подключения к хранилищу.

  • подключения к базе данных PostgreSQL:

    • SPRING_DATASOURCE_URL — локация базы данных в формате JDBC URL;
    • SPRING_DATASOURCE_USERNAME — имя пользователя для подключения к базе данных;
    • SPRING_DATASOURCE_PASSWORD — пароль для подключения к базе данных.

  • подключения к S3-совместимому хранилищу:

    • ALLURE_BLOBSTORAGE_S3_ENDPOINT — URL-адрес сервера;
    • ALLURE_BLOBSTORAGE_S3_BUCKET — название бакета S3;
    • ALLURE_BLOBSTORAGE_S3_REGION — название региона S3;
    • ALLURE_BLOBSTORAGE_S3_ACCESSKEY — ключ доступа для подключения к бакету;
    • ALLURE_BLOBSTORAGE_S3_SECRETKEY — секретный ключ для подключения к бакету.

    Информацию о том, как настроить доступ к внешним S3-совместимым хранилищам, таким как Amazon S3 и Google Cloud Storage, см. в инструкции S3-совместимое хранилище.

Некоторые дополнительные параметры могут быть изменены для тонкой настройки производительности или поддержки нестандартных конфигураций сервисов хранения. Проверьте комментарии в файле testops.conf и при необходимости проконсультируйтесь со службой технической поддержки ТестОпс.

Настройка сервиса очередей ​

Важно

ТестОпс не поддерживает работу с кворумными очередями в режиме высокодоступного сервиса в RabbitMQ версии 4.0 и выше. Если для инсталляции RabbitMQ требуется режим высокой доступности — необходимо выбирать RabbitMQ версии ниже 4.0.

Чтобы подключиться к сервису очередей, который используется в ТестОпс, укажите параметры подключения к серверу RabbitMQ:

  • SPRING_RABBITMQ_HOST — имя хоста сервера;
  • SPRING_RABBITMQ_PORT — порт сервера;
  • SPRING_RABBITMQ_USERNAME — имя пользователя для подключения к очереди сообщений;
  • SPRING_RABBITMQ_PASSWORD — пароль для подключения к очереди сообщений.

Первый запуск ТестОпс ​

Примечание

При каждом запуске, включая первый запуск и обновление инстанса, ТестОпс выполняет проверку всех настроек и пытается подключиться ко всем настроенным сервисам:

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

Чтобы впервые запустить ТестОпс:

  1. Откройте терминал.

  2. Перезапустите службы, чтобы применить изменения в файле конфигурации:

    sh
    sudo systemctl restart testops

    Перезапуск всех сервисов ТестОпс займет некоторое время. Дождитесь завершения перезапуска, прежде чем переходить к следующему шагу.

  3. После запуска ТестОпс вам придет письмо с приглашением на адрес, который вы указали в ALLURE_MAIL_ROOT. В полученном письме нажмите Принять приглашение.

    Примечание

    Если в браузере появляется ошибка «Невозможно подключиться» (“Unable to connect”) или «Сайт недоступен» (“This site can't be reached”), это может означать, что некоторые сервисы все еще инициализируются.

    Если через пять минут браузер все еще не может открыть страницу, см. раздел Устранение неполадок.

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

    Важно

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

  5. Нажмите Продолжить.

  6. В форму активации введите лицензионный ключ, который вы получили при покупке лицензии ТестОпс. Убедитесь, что лицензионный ключ скопирован и введен без лишних пробелов и других символов.

  7. Нажмите Активировать лицензию.

Управление сервисами ТестОпс ​

Запуск ТестОпс ​

Чтобы запустить ТестОпс, в терминале выполните команду:

sh
sudo systemctl start testops

Остановка ТестОпс ​

Чтобы остановить ТестОпс, в терминале выполните команду:

sh
sudo systemctl stop testops

Перезапуск ТестОпс ​

Чтобы перезапустить ТестОпс, в терминале выполните команду:

sh
sudo systemctl restart testops

Обновление ТестОпс ​

Внимание

5 августа 2025 года мы обновили PGP-ключ, который используется для подписи DEB-пакетов из репозитория qatools. Чтобы продолжить работу с репозиторием и обновить инстанс ТестОпс, вам необходимо заменить устаревший PGP-ключ на новый и задать новые права доступа к файлу с этим ключом. Для этого последовательно выполните команды:

  1. Замена PGP-ключа:

    sh
    curl -s https://pub.qatools.ru/qatools.gpg | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/qatools.gpg --import

  2. Предоставление доступа к ключу:

    sh
    chmod 644 /etc/apt/trusted.gpg.d/qatools.gpg

Важно

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

Чтобы обновить ТестОпс:

  1. Откройте терминал.

  2. Обновите параметр, указывающий версию пакета для установки.

    Перед выполнением команды замените 5.7.0 на версию, до которой вы обновляетесь. После этого скопируйте и выполните эту команду целиком, а не ее строки по отдельности:

    sh
    cat <<EOF | sudo tee /etc/apt/preferences.d/qatools
Package: testops
Pin: version 5.7.0
Pin-Priority: 1000
EOF

  3. Обновите индекс доступных пакетов:

    sh
    sudo apt update

  4. Переустановите пакет ТестОпс:

    sh
    sudo apt install -y testops

  5. При необходимости измените файлы конфигурации согласно информации о релизах.

  6. Перезапустите ТестОпс:

    sh
    sudo systemctl restart testops

Удаление ТестОпс ​

Чтобы удалить ТестОпс:

  1. Откройте терминал.

  2. Удалите пакеты ТестОпс:

    sh
    sudo apt autoremove testops-*

  3. Удалите файлы конфигурации:

    sh
    sudo rm -rf /opt/testops

Устранение неполадок ​

Если вы столкнулись с проблемой, не перезапускайте ТестОпс. Специалистам технической поддержки нужны лог-файлы каждого компонента, чтобы понять, что произошло.

Создайте обращение в техподдержку, используя корпоративный адрес электронной почты. Для этого перейдите на портал Help Desk, доступный по адресу help.qatools.ru, нажмите Создать обращение и заполните форму:

  1. Подробно опишите проблему, с которой вы столкнулись.
  2. Укажите способ установки и версию ТестОпс, а также всех дополнительных компонентов, с которыми у вас возникли проблемы (allurectl, интеграционные плагины и т. д.).
  3. Приложите логи из вашей системы в качестве вложений к обращению (см. подробности ниже). Пожалуйста, добавляйте только логи, описанные ниже, и только в виде вложения.
bash
journalctl -f -n 100 -u testops

где:

  • f — следить за журналом, т.е. все новые строки будут показаны на экране;
  • n 100 — количество записей в журнале для отображения;
  • u name — название юнита.

Получение логов ​

По умолчанию все компоненты пишут логи в stdout. Получить логи можно с помощью journalctl:

sh
journalctl --no-tail -u testops > testops.log

Logo © 2025 Все права защищены. Сайт принадлежит компании ООО «Инструменты тестирования»