Установка

Получение поставочного пакета, запуск установщика, регистрация экземпляра и проверка состояния всех 14 служб.

Способ развёртыванияКоманды на этой странице относятся к поставке Docker Compose. Откройте соответствующую процедуру для Kubernetes и Helm.
Термины этого руководства
  • Обратный прокси-сервер (reverse proxy) принимает внешние запросы и передаёт их службам MassAccess.
  • Защита транспортного уровня (Transport Layer Security, TLS) шифрует соединение с публичным адресом.
  • Проверка состояния (health check) подтверждает готовность службы отвечать на запросы.
  • Регистрация экземпляра (enrollment) связывает установленный экземпляр с созданной лицензией.

Получение пакета

Поставочный архив massaccess-compose.tar.gz выдаётся в панели управления по адресу https://massaccess.net/dashboard/on-premise. Архив содержит данные установки, лицензирования, скрипты установки и обновления.

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

Запуск установщика

Архив содержит весь Compose transport. Установщик проверяет доверенные metadata, загружает 16 immutable images, создаёт unique local PKI и запускает 17 сервисов. Вручную готовить Receiver/RabbitMQ/Agent и bot TLS перед первым запуском не требуется.

bash
tar -xzf massaccess-compose.tar.gz
cd massaccess-compose
chmod +x install.sh
bash install.sh --manifest ./manifest.json

Предварительная проверка (--dry-run)

Проверяет manifest, package/release metadata, окружение и Docker inventory. Не создаёт .env, keys, lock/journal и не выполняет login/pull/up/down.

bash
bash install.sh --manifest ./manifest.json --dry-run

Что проверяет установщик

Перед загрузкой образов install.sh проверяет Docker daemon, Docker Engine 24.0+, Docker Compose v2.24+, Linux kernel 5.x+, Bash, Python 3, curl, базовые команды, свободное место и порты. CPU и RAM проверяются отдельно: при несоответствии установщик выводит требуемые и фактические значения и запрашивает явное подтверждение. Критические ошибки выводятся одним списком, и до их устранения установщик не загружает образы и не запускает Compose.

Лицензия и публичный webhook ingress

После подтверждения license heartbeat/Core оператор центральной инфраструктуры подключает разрешённый Receiver endpoint. Подготовьте явный DNS и входящий TCP/443 только с согласованных IP jump. Выполните enrollment и проверьте ingress readiness. Для ошибок используйте раздел Диагностика).

Настройка входящих сообщений MAX и Telegram для этой установки. DNS-имя или разрешённый IP без https://, порта и пути. Используется TCP/443. После готовности ingress повторите подключение бота и отдельно проверьте доставку настоящего сообщения.

Учётные данные для первого входа

В .env (0600) сохраняются credentials первого администратора и настройки установки. Повторный запуск сохраняет admin/JWT/role keys, installation UUID/Core ID и volumes. Пароль не выводится в журнал.

Проверка здоровья платформы

local=ready требует healthy всех 17 сервисов и согласованного signed snapshot/durable receipt, включая пустую установку без ботов. ingress=pending допускается при первом local startup. Добавьте боты после успешной установки; реальные сообщения Telegram/MAX проверяются отдельно.

Предупреждение о блокировке лицензииНе запускайте установочный пакет с одной лицензией на нескольких экземплярах одновременно. Установщик не удаляет существующие контейнеры и volumes; если проект ms-onprem уже существует, установка завершается с ошибкой — для обновления используйте upgrade.sh.