Документация
Toggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto mode Назад на главную

Установка

Предусловия

  1. Вам понадобится docker compose версии 2+ на вашей машине, где вы собираетесь устанавливать ТестОпс.
  2. Вам понадобятся имя пользователя и пароль (может так же называться “секретный токен”) для скачивание образов ПО из нашего частного докер-репозитория. Учетные данные обычно предоставляются командой продаж вместе с ознакомительной или коммерческой лицензией.
  3. Вам также понадобится ознакомительная или коммереческая лицензия для ТестОпс.

Реестр образров для ТестОпс

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

Для того, чтобы установить ТестОпс при помощи docker compose требуется скачать образы ПО следующим образом:

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

  • Вы не можете воспользоваться веб-интерфейсом докера, это не работает.
  • Вы не можете войти в реестр, используя пользовательский интерфейс Docker Desktop.

Образы сервисов, входящих в состав ТестОпс находятся в частном реестре, для доступа к которому требуется имя пользователя (username) и пароль (password), которые предоставляются отделом продаж.

Вход в реестр

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

docker login reg.qatools.ru -u <username> -p <password>

Конфигурирование, скачивание образов и старт системы

Шаблон файлов конфигурации

Шаблон файла конфигурации для развертывания при помощи docker compose можно скачать можно по ссылке.

Конфигурирование

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

  • базы данных
  • хранилище артефактов (S3)

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

Для подготовки конфигурации для ознакомительного использования вам потребуется выполнить следующие действия:

  1. Распаковать скачанный архив в отдельную папку на сервере, где вы планируете разворачивать ТестОпс.
  2. Перейти в эту папку
  3. Открыть файл .env в режиме редактирования и выполнить изменения:
    1. Значение переменной ALLURE_VERSION, которая указывает, какой релиз требуется ставить.
    2. Все переменные окружения, содержащие пароли.
    3. Переменная ALLURE_HOST
    4. Временная зона севера, на котором вы разворачиваете систему
  4. Сохранить сделанные изменения.

Разворачивание ТестОпс на сервере

Разворачивание конфигурации для ознакомительных целей осуществляется следующим образом:

  1. Выполняется команда
docker compose up -d
  1. Начальный запуск и инициализация БД могут занять до 6 минут.
  2. Система становится доступна по адресу и порту, настроенным вами в конфигурационном файле .env.

Доступ к пользовательскому интерфейсу

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

Эти учетные данные следует всегда использовать для доступа к системе для ее администрирования и обновления лицензии.

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

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

При перезапуске системы пароль возвращается в состояние, описанное в ALLURE_ADMIN_PASS.

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

При появлении ошибок (пользовательский интерфейс или недоступен или содержит сообщения об ошибках), сбор данных проводится средствами docker compose.

  1. Выполните следующие команды в терминале, находясь в той же папке, что и конфигурационные файлы (скопируйте все стри строки, вставьте в окно терминала и нажмите Enter):
docker compose logs allure-report > report-logs.txt && \
docker compose logs allure-uaa > uaa-logs.txt && \
docker compose logs allure-gateway > gateway-logs.txt
  1. Проверьте, какие ошибки описаны в лог-файлах.
  2. Остановите систему при помощи команды docker compose down
  3. Исправьте конфигурацию и запустите систему.
  4. Если описание ошибок вам не понятно, уточните с ответственными за инфраструктуру и сесть.
  5. Если проблему не уадалось решить самостоятельно, то обратитесь за помощью к нашей команде, ответственной за счастье клиентов.

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

  1. Откройте .env для редактирования
  2. Обновите значение переменной ALLURE_VERSION на идентификатор релиза, который вы планируете установить.
  3. Выполните команду docker compose pull
    1. Дождитесь окончания выполнения команды
  4. Выполните команду docker compose down
  5. Выполните команду docker compose up -d

Полное удаление установки

Полное удаление установки выполняется средствами docker compose:

docker compose down -v --rmi local