Ru

Установка с внешней PostgreSQL#

Эта инструкция относится к новой установке Sherpa Orchestrator с базой PostgreSQL на отдельном сервере. При обновлении существующей установки используйте процесс обновления и заранее подготовьте резервную копию.

Перед началом#

  • Подготовьте сервер PostgreSQL версии 13 или новее с базой данных в кодировке UTF-8.
  • Разрешите подключения к нему из сети Docker сервера Orchestrator: настройте listen_addresses, правило host в pg_hba.conf и межсетевой экран. Проверьте адрес и порт, доступные из контейнера, а не только с хоста.
  • Выберите имя рабочей роли, базы и отдельный пароль. Рабочей роли понадобится право CREATE в базе: миграции создадут схемы orchestrator и orchestrator_archive автоматически.
  • Если роль и база уже созданы администратором PostgreSQL, административные реквизиты установщику не нужны. Иначе подготовьте временную административную роль с правами CREATEROLE и CREATEDB.

Установка#

  1. Распакуйте клиентский комплект и запустите sudo ./sh_scripts/install.sh, как описано в общей инструкции.
  2. На шаге Выбор базы данных выберите 4 — Внешняя PostgreSQL. Контейнер базы данных при этом не запускается.
  3. Укажите POSTGRES_PASSWORD рабочей роли, затем POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER и POSTGRES_DBNAME. Не оставляйте в .env пример пароля из шаблона.
  4. Если роль или база ещё не созданы, заполните POSTGRES_ADMIN_USER, POSTGRES_ADMIN_PASSWORD и при необходимости POSTGRES_ADMIN_DBNAME (по умолчанию postgres). При заранее созданных роли и базе оставьте административную роль пустой.
  5. Дождитесь проверки подключения до запуска системы. Установщик проверит доступность сервера и вход рабочей ролью, при необходимости создаст роль и базу, затем проверит право CREATE.
  6. Если проверка завершилась ошибкой, выполните указанные действия на сервере PostgreSQL и выберите r — Повторить проверку. Пункт e позволяет исправить параметры подключения. Не пропускайте проверку пунктом s: Orchestrator не запустится, пока база или роль недоступны.
  7. Завершите остальные шаги установщика и откройте интерфейс Orchestrator. Проверьте вход и создание тестового объекта в допустимом для вашей роли разделе.

Если проверка не проходит#

  • Сервер недоступен: проверьте POSTGRES_HOST, POSTGRES_PORT, маршрутизацию из Docker, listen_addresses, pg_hba.conf и межсетевой экран.
  • Роль или база отсутствует: создайте их на сервере PostgreSQL либо временно предоставьте установщику административные реквизиты. После создания базы выдайте рабочей роли право CREATE.
  • Ошибка входа рабочей роли: проверьте её пароль в .env и разрешающее правило pg_hba.conf. Если роль существовала раньше, её пароль может отличаться от указанного для новой установки.

Схемы orchestrator и orchestrator_archive создаются миграциями. Для новой установки не загружайте в них дамп от другой системы.