Skip to content

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

Внимание

Начиная с декабря 2025:

  • установка ТестОпс версии 4.x с помощью DEB-пакетов поддерживается только на Ubuntu 20.04;
  • сборка с пакетом box недоступна для установки и обновления.

Настоятельно рекомендуем обновить ваш инстанс ТестОпс на актуальную версию. См. Информация о релизах ТестОпс.

Важно

В инструкции описана установка ТестОпс версии 4.x. Чтобы установить ТестОпс версии 5.x, см. Установка ТестОпс версии 5.x с помощью DEB-пакетов.

Совет

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

sh
bind 'set enable-bracketed-paste on'

Переход на ТестОпс с установки Allure Testops

Если вы переходите на ТестОпс с существующего инстанса Allure TestOps, см. Переход на ТестОпс с установки Allure TestOps в Linux-пакетах.

Учетные данные

Учетные данные (логин, пароль) предоставляются отделом продаж при предоставлении ознакомительной или коммерческой лицензии.

Учетные данные могут быть использованы для установки ТестОпс как с помощью Linux-пакетов, так и в Docker Compose или Kubernetes. Особенности каждого вида установки описаны в соответствующих инструкциях документации.

Типы пакетов

Внимание

Начиная с декабря 2025, cборка с пакетом box недоступна для установки и обновления.

Мы предоставляем два типа пакетов:

  • пакет min;
  • пакет box.

Пакет min

Минимальный пакет содержит только исполняемые файлы ТестОпс:

  • сервис uaa;
  • сервис gateway;
  • сервис report.

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

  • Amazon Corretto JDK 17;
  • Consul;
  • RabbitMQ;
  • S3-решение (например, MinIO);
  • PostgreSQL версии не ниже 14;
  • Redis;
  • nginx.

Пакет box

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

Все инструменты будут установлены, настроены и запущены с помощью пакета установки ТестОпс на одном сервере (виртуальной машине).

Установка

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

Этот шаг может потребоваться, если вы устанавливаете пакет box, так как его установка подразумевает также установку PostgreSQL, MinIO, Amazon Corretto и других сервисов.

Amazon Corretto

Для работы ТестОпс используется Amazon Corretto JDK 17. Чтобы его установить, выполните в терминале команды:

shell
wget -q -O- https://apt.corretto.aws/corretto.key | sudo gpg --dearmor --output /usr/share/keyrings/corretto.gpg
echo "deb [signed-by=/usr/share/keyrings/corretto.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list
sudo apt update
sudo apt install -y java-17-amazon-corretto-jdk

Подробнее см. руководство по установке на сайте Amazon.

Consul

Для сервисного обнаружения и взаимодействия компонентов ТестОпс требуется Consul. Чтобы его установить, выполните в терминале команды:

shell
wget -q -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor --output /usr/share/keyrings/hashicorp.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/hashicorp.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update
sudo apt install -y consul

Подробнее см. руководство по установке на сайте HashiCorp.

PostgreSQL

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

shell
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-14

Подробнее см. руководство по установке на сайте PostgreSQL.

Добавление публичного ключа qatools

Выполните команды:

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

Скачивание и установка сборки ТестОпс

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

    Внимание

    Начиная с декабря 2025, cборка с пакетом box недоступна для установки и обновления.

    shell
    wget --user=<YOUR_LOGIN> --password=<YOUR_PASSWORD> -O allure-testops-min_<APP_VERSION>_amd64.deb https://dl.qatools.ru/repository/debian/pool/a/allure-testops-min/allure-testops-min_<APP_VERSION>_amd64.deb

    где:

    • YOUR_LOGIN — ваше имя пользователя в реестре ТестОпс;
    • YOUR_PASSWORD — ваш пароль в реестре ТестОпс;
    • APP_VERSION — версия ТестОпс.
  2. Установите сборку ТестОпс, выполнив команду:

    shell
    sudo apt install ./<PACKAGE_NAME>.deb

    где PACKAGE_NAME — название пакета ТестОпс.

    Например:

    shell
    sudo apt install ./allure-testops-min_4.26.5_amd64.deb
  3. Проверьте, что ТестОпс установлен в ожидаемом каталоге, выполнив команды:

    shell
    cd /opt/allure-testops/
    ls -la

Конфигурационные файлы

Пути к файлам конфигурации

Для Debian-подобных ОС конфигурационные файлы сервисов ТестОпс находятся в /opt/allure-testops:

  • для сервиса gateway/opt/allure-testops/gateway/conf/allure-gateway.conf;
  • для сервиса uaa/opt/allure-testops/uaa/conf/allure-uaa.conf;
  • для сервиса report/opt/allure-testops/report/conf/allure-report.conf.

Конфигурация

Конфигурация осуществляется через набор переменных окружения, хранящихся в файле allure-<service>.conf, специфичном для каждого из сервисов ТестОпс.

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

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

Конфигурация ТестОпс

Информация о входе пользователя admin

ТестОпс требует создания и сохранения в системе учетной записи admin (admin — это имя пользователя по умолчанию). Это имя (admin) и пароль определяются в конфигурационном файле (allure-uaa.conf), и он будет восстановлен до состояния, описанного в конфигурационном файле, чтобы гарантировать, что вы не потеряете доступ к инстансу ТестОпс. Это означает, что если вы отключите пользователя admin в пользовательском интерфейсе, удалите роли администратора и измените пароль, при следующем запуске ТестОпс система снова создаст пользователя со всем набором доступных прав, с паролем, определенным в конфигурационном файле. Следовательно, этого пользователя нельзя отключить и удалить.

Важно

Измените пароль администратора в конфигурации перед развертыванием.

Если вы не задаете начальный пароль администратора, будет создан пользователь по умолчанию admin и сильный пароль администратора будет сгенерирован системой, а затем сгенерированный пароль будет отправлен в журналы сервиса uaa.

Каждый раз при перезапуске ТестОпс учетная запись admin восстанавливается в исходное состояние в соответствии с конфигурационным файлом (allure-uaa.conf).

Сервис Gateway

Конфигурационный файл сервиса gateway находится по адресу /opt/allure-testops/gateway/conf/allure-gateway.conf.

Стандартное содержимое (после установки) выглядит следующим образом:

shell
ALLURE_JWT_SECRET=N7zaHAQYQ4XtQTz4vGvqt7Tkyjuesxcp
SPRING_SESSION_STORE_TYPE=REDIS
SPRING_REDIS_HOST=localhost
SPRING_REDIS_PORT=6379
SPRING_REDIS_PASSWORD=""
SPRING_CLOUD_CONSUL_ENABLED=true
SPRING_CLOUD_CONSUL_HOST=localhost
SPRING_CLOUD_CONSUL_PORT=8500

Важно

Значение ALLURE_JWT_SECRET требуется обновить и скопировать в тот же параметр сервисов report и uaa.

Сервис UAA

Конфигурационный файл сервиса uaa находится по адресу /opt/allure-testops/uaa/conf/allure-uaa.conf.

Общие настройки

Рекомендуемые настройки для регистрации пользователей:

shell
ALLURE_SECURITY_USER_NAME=admin
ALLURE_SECURITY_USER_PASSWORD=admin # обязательно изменить
ALLURE_REGISTRATION_ENABLED=false # для производственной системы лучше выключить
ALLURE_REGISTRATION_AUTOAPPROVE=false # для производственной системы лучше выключить
ALLURE_REGISTRATION_DEFAULT_ROLE=ROLE_AUDITOR # для производственной системы лучше выставить так, чтобы лучше контролировать лицензии

# в примере используются настройки для gmail
# эта группа параметров является обязательной начиная с ТестОпс версии 4.18.0
SPRING_MAIL_HOST=smtp.gmail.com
SPRING_MAIL_PORT=465
SPRING_MAIL_USERNAME=username
SPRING_MAIL_PASSWORD=password
ALLURE_MAIL_FROM=noreply@example.com
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

JWT секрет

Параметр является обязательным, и его значение должно совпадать со значением того же параметра из сервиса gateway:

shell
ALLURE_JWT_SECRET=N7zaHAQYQ4XtQTz4vGvqt7Tkyjuesxcp

Настройки Consul

Настройки Consul, используемые по умолчанию:

shell
SPRING_CLOUD_CONSUL_HOST=localhost
SPRING_CLOUD_CONSUL_PORT=8500

Если в вашем окружении есть выделенный сервер Consul, соответствующим образом обновите эти настройки.

Настройки PostgreSQL

Рекомендуемые по умолчанию настройки для подключения к базе данных:

shell
SPRING_DATASOURCE_URL="jdbc:postgresql://localhost:5432/uaa?assumeMinServerVersion=11&ApplicationName=uaa-service"
SPRING_DATASOURCE_USERNAME=uaa
SPRING_DATASOURCE_PASSWORD=CjAXjUav3eh3cmWk

Если у вас выделенный сервер баз данных (настоятельно рекомендуется для производственной системы), соответствующим образом обновите настройки.

Сервис Report

Конфигурационный файл сервиса report находится по адресу /opt/allure-testops/report/conf/allure-report.conf.

JWT-секрет

Параметр является обязательным, и его значение должно совпадать со значением того же параметра из сервиса gateway:

shell
ALLURE_JWT_SECRET=N7zaHAQYQ4XtQTz4vGvqt7Tkyjuesxcp

Настройки Consul

Настройки Consul, используемые по умолчанию:

shell
SPRING_CLOUD_CONSUL_HOST=localhost
SPRING_CLOUD_CONSUL_PORT=8500

Если в вашем окружении есть выделенный сервер Consul, соответствующим образом обновите эти настройки.

Настройки PostgreSQL

Рекомендуемые по умолчанию настройки для подключения к базе данных:

shell
SPRING_DATASOURCE_URL="jdbc:postgresql://localhost:5432/report?assumeMinServerVersion=11&ApplicationName=report-service"
SPRING_DATASOURCE_USERNAME=report
SPRING_DATASOURCE_PASSWORD=GnNc9QQcLzZfhVNn

Если у вас выделенный сервер баз данных (настоятельно рекомендуется для производственной системы), соответствующим образом обновите настройки.

Настройки RabbitMQ

shell
SPRING_RABBITMQ_HOST=localhost
SPRING_RABBITMQ_PORT=5672
SPRING_RABBITMQ_USERNAME=guest
SPRING_RABBITMQ_PASSWORD=guest

Настройка хранилища (S3)

Тип хранилища, используемый установкой по умолчанию, — это хранилище S3 с сервисом MinIO «под капотом», этот тип настройки рекомендуется по сравнению с хранилищем файловой системы, так как он позволяет более стабильно обрабатывать файлы.

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

shell
ALLURE_BLOBSTORAGE_TYPE=S3
ALLURE_BLOBSTORAGE_S3_PATHSTYLEACCESS=true
ALLURE_BLOBSTORAGE_S3_ENDPOINT="http://localhost:9000"
ALLURE_BLOBSTORAGE_S3_BUCKET=testops
ALLURE_BLOBSTORAGE_S3_REGION=your-region-0
ALLURE_BLOBSTORAGE_S3_ACCESSKEY=M8P2RAAa73KCBNmXKcp9csX5u5SXUg7L
ALLURE_BLOBSTORAGE_S3_SECRETKEY=YPZNUd5eULXGTZN9c9dNj8M4vffCpYPE

Для производственной системы рекомендуется использовать Amazon AWS или локальное решение S3 (например, MinIO) с хранилищем на SSD-дисках.

Управление состоянием выполнения ТестОпс

После установки ТестОпс он будет поднят автоматически и включен как сервис.

Для управления состоянием приложений вам нужно использовать команды, указанные ниже.

Запуск сервисов ТестОпс

bash
sudo systemctl start allure-uaa
sudo systemctl start allure-report
sudo systemctl start allure-gateway

Перезапуск сервисов ТестОпс

bash
sudo systemctl restart allure-uaa
sudo systemctl restart allure-report
sudo systemctl restart allure-gateway

Получение статуса выполнения сервисов ТестОпс

bash
sudo systemctl status allure-uaa
sudo systemctl status allure-report
sudo systemctl status allure-gateway

Остановка сервисов ТестОпс

bash
sudo systemctl stop allure-uaa
sudo systemctl stop allure-report
sudo systemctl stop allure-gateway

Подключение к ТестОпс UI

Интерфейс ТестОпс по умолчанию доступен на порту 8080. Чтобы открыть его, перейдите по URL-адресу: http://your_domain_or_ip:8080/.

Первоначальный вход

Войдите в ТестОпс, используя имя пользователя (по умолчанию — admin) и пароль из конфигурации /opt/allure-testops/uaa/conf/allure-uaa.conf.

Имя пользователя — admin, пароль — либо по умолчанию, либо тот, который вы задал в указанном файле.

Ввод лицензии для инстанса ТестОпс

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

После предоставления правильной лицензии вы сможете начать свою работу.

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

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

Перед обновлением

Сохраните файлы конфигурации для каждого сервиса:

shell
cp /opt/allure-testops/gateway/conf/allure-gateway.conf ~/
cp /opt/allure-testops/report/conf/allure-report.conf ~/
cp /opt/allure-testops/uaa/conf/allure-uaa.conf ~/

Обновление

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

    Внимание

    Начиная с декабря 2025, cборка с пакетом box недоступна для установки и обновления.

    shell
    wget --user=<YOUR_LOGIN> --password=<YOUR_PASSWORD> -O allure-testops-min_<APP_VERSION>_amd64.deb https://dl.qatools.ru/repository/debian/pool/a/allure-testops-min/allure-testops-min_<APP_VERSION>_amd64.deb

    где:

    • YOUR_LOGIN — ваше имя пользователя в реестре ТестОпс;
    • YOUR_PASSWORD — ваш пароль в реестре ТестОпс;
    • APP_VERSION — версия ТестОпс.
  2. Обновите текущую версию ТестОпс, выполнив команду:

    shell
    sudo apt install ./<PACKAGE_NAME>.deb

    где PACKAGE_NAME — название пакета ТестОпс.

    Например:

    shell
    sudo apt install ./allure-testops-min_4.26.5_amd64.deb
  3. Проверьте, что ТестОпс установлен в ожидаемом каталоге, выполнив команды:

    shell
    cd /opt/allure-testops/
    ls -la

После обновления

  1. Восстановите ранее сохраненные файлы конфигурации и перезапустите сервисы ТестОпс, выполнив команды:

    shell
    cp ~/allure-gateway.conf /opt/allure-testops/gateway/conf/allure-gateway.conf
    cp ~/allure-report.conf /opt/allure-testops/report/conf/allure-report.conf
    cp ~/allure-uaa.conf /opt/allure-testops/uaa/conf/allure-uaa.conf
    
    systemctl restart allure-uaa && systemctl restart allure-report && systemctl restart allure-gateway
  2. Убедитесь, что все сервисы ТестОпс работают корректно, выполнив команды:

    shell
    sudo systemctl status allure-report.service
    sudo systemctl status allure-uaa.service
    sudo systemctl status allure-gateway.service

Решение проблем

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

bash
sudo journalctl -f -n 100 -u allure-uaa
sudo journalctl -f -n 100 -u allure-report
sudo journalctl -f -n 100 -u allure-gateway

где:

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

Чтобы проверить состояние сервиса в Consul

Чтобы показать статус сервиса в Consul, используйте приведенные ниже URL-адреса, заменив 127.0.0.1 на ваш реальный IP-адрес Consul:

bash
curl  http://127.0.0.1:8500/v1/health/service/allure-ee-gateway
curl  http://127.0.0.1:8500/v1/health/service/allure-ee-uaa
curl  http://127.0.0.1:8500/v1/health/service/allure-ee-report

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

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

  1. Удалите пакеты.
  2. Удалите конфигурации.

Пакеты

bash
sudo apt autoremove allure-testops-min

Эта команда удалит ТестОпс и все зависимости, установленные apt install.

Удаление конфигураций

bash
sudo rm -rf /opt/allure-testops

Использование ТестОпс с обратным прокси

Если вы планируете использовать ТестОпс с http/https, потребуется установить nginx и certbot.

Установка nginx

bash
sudo apt install nginx certbot

Получите SSL-сертификат, где %%DOMAIN%% — ваш домен:

bash
certbot certonly -d %%DOMAIN%%

Конфигурация nginx

Поместите конфиг nginx в файл /etc/nginx/sites-available/allure.conf:

bash
cat << EOF > /etc/nginx/sites-available/allure.conf
upstream allure {
     server 127.0.0.1:8083 weight=1;
}

server {
   listen 80;
   server_name %%DOMAIN%%;
   return 301 https://$host$request_uri;
}

server {
   listen 0.0.0.0:443 ssl;
   server_name %%DOMAIN%%;
   ssl_certificate /etc/letsencrypt/live/%%DOMAIN%%/fullchain.pem;
   ssl_certificate_key /etc/letsencrypt/live/%%DOMAN%%/privkey.pem;
   ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
   ssl_protocols TLSv1.1 TLSv1.2;
   ssl_prefer_server_ciphers on;
   location / {
       proxy_pass http://allure;
       proxy_set_header Host $host;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_redirect off;
   }
}
EOF

Включение сайта

bash
sudo ln -s /etc/nginx/sites-available/allure.conf /etc/nginx/sites-enabled/allure.conf

Запуск nginx

bash
sudo systemctl start nginx
sudo systemctl enable nginx

Подключение хранилища S3

Настоятельно рекомендуется использовать внешнее хранилище для производственной системы. По умолчанию для пакета box ТестОпс использует MinIO.

Чтобы использовать другие объектные хранилища, например AWS, вам нужно обновить следующие переменные окружения:

shell
ALLURE_BLOBSTORAGE_TYPE=S3
ALLURE_BLOBSTORAGE_S3_PATHSTYLEACCESS=true
ALLURE_BLOBSTORAGE_S3_ENDPOINT="http://localhost:9000"
ALLURE_BLOBSTORAGE_S3_BUCKET=testops
ALLURE_BLOBSTORAGE_S3_REGION=region
ALLURE_BLOBSTORAGE_S3_ACCESSKEY=M8P2RAAa73KCBNmXKcp9csX5u5SXUg7L
ALLURE_BLOBSTORAGE_S3_SECRETKEY=YPZNUd5eULXGTZN9c9dNj8M4vffCpYPE

ACL для S3

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

JSON
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "S3assets",
            "Effect": "Allow",
            "Action": [
                "s3:PutObjectAcl",
                "s3:PutObject",
                "s3:ListMultipartUploadParts",
                "s3:ListBucketMultipartUploads",
                "s3:ListBucket",
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:GetBucketLocation",
                "s3:GetBucketAcl",
                "s3:DeleteObject"
            ],
            "Resource": [
                "arn:aws:s3:::<allure_s3_bucket_name>/*",</allure_s3_bucket_name>
                "arn:aws:s3:::<allure_s3_bucket_name>"]</allure_s3_bucket_name>
        }
    ]
}

Google S3

Важно

Для Google S3 вам нужно использовать fine-granted access control и настройки для публичного доступа Subject to object ACLs. Это необходимо для совместимости с AWS SDK, иначе файлы в S3 bucket не будут полностью доступны ТестОпс и сервис report не сможет запуститься.

Значение параметра ALLURE_BLOB-STORAGE_S3_ENDPOINT для Google S3 должен быть https://storage.googleapis.com.

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