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 © 2026 Все права защищены. Сайт принадлежит компании ООО «Инструменты тестирования»