Требования к установке

Аппаратные характеристки к серверу, на котором будет разворачиваться и запускаться основной экземпляр сервиса, должны соответствовать значениям из расчетных параметров указаных ниже. Значения рассчитаны по результатам локальных нагрузочных тестов. Параметры сервера 1С рассчитываются отдельно.

Аппаратные ресурсы

Вариант Базовая конфигурация Рекомендуемая конфигурация
Приложение отдельно 2 vCPU, 2 Гб RAM 2 vCPU, 4 Гб RAM
PostgreSQL отдельно 2 vCPU, 2 Гб RAM 4 vCPU, 4 Гб RAM
Один сервер для приложения и PostgreSQL 4 vCPU, 8 Гб RAM 6 vCPU, 12 Гб RAM

Для раздельного размещения учитывайте ресурсы отдельно для каждого узла. Эти значения являются ориентировачными, фактические значения необходимо подбирать из фактического потребления и пропускной способности конкретного узла.

Ниже приведён пример расчёта хранилища. Исходные данные расчётных листков приложение получает из 1С. PDF отдельного листка формируется в браузере; при формировании на сервере приложение временно использует рабочие файлы на узле приложения и удаляет их после обработки. Пиковый объём этих файлов не измерен — отдельно проверьте свободное место во временном каталоге.

Для действия «Сохранить всё» готовый PDF хранится в PostgreSQL в зашифрованном виде. Срок его доступности по умолчанию — 15 минут с момента формирования; после успешной передачи браузеру приложение удаляет файл из базы. Если передача прервётся, файл можно скачать повторно в течение оставшегося срока.

Для нескольких экземпляров приложения необходимо выделять отдельный постоянный том для каждого отдельного сервиса.

Релизные сборки образов docker распространяются с поддержкой 64-разрядных архитектур amd64 и arm64. Перед развертыванием необходимо убедиться, что архитектура платформы подходит для соответсвующих образов сервиса.

Пример расчёта хранилища

Размещение Объём без локальной копии базы С одной полной локальной копией базы
Узел приложения, PostgreSQL отдельно 40 Гб —
Отдельный узел PostgreSQL 160 Гб 256 Гб
Приложение и PostgreSQL вместе 160 Гб 256 Гб

Пример рассчитан для 10 000 сотрудников и четырёх событий аудита на сотрудника в день при хранении аудита 365 дней. Он учитывает до 1000 готовых PDF по 16 Мб.

В оценку входят: система, образы Docker, 5 Гб журналов при настроенной ротации, 10 Гб на служебный журнал PostgreSQL (WAL) и 25% свободного места. При другой политике ротации или распределении сервисов и базы данных запас необходимо пересчитать. Три полные копии в отдельном хранилище потребуют около 320 Гб. Аудит и историю синхронизации очищайте вручную через функционал раздела: Обслуживание.

Операционная система и программы

Параметр Минимальное требование Примечание
Операционная система 64-разрядный Linux, совместимый с Docker Engine Ubuntu 24.04 LTS или Debian 13; это примеры систем, поддерживаемых Docker, а не обзательное требование приложения
Docker Engine Docker Engine для выбранного Linux Актуальная стабильная версия из официального репозитория Docker для конкретного дистрибутива
Docker Compose Плагин Compose, команда docker compose Актуальный стабильный плагин из официального репозитория Docker.
PostgreSQL Версия 15 или новее, доступная контейнеру приложения Рекомендуется PostgreSQL 17+ с последним обновлением выбранной основной версии
OpenSSL Нужен на хосте только для создания секретного ключа (необязательно) Может быть сгенерирован на стороннем хосте
curl Нужен на Docker-хосте для проверки /health и /ready по инструкции Используйте установленный в системе curl
SSH-клиент Нужен только для подключения к удалённому серверу через туннель Используйте SSH-клиент вашей рабочей системы для режимов recovery

Официальная документация Docker содержит список поддерживаемых Linux-систем: установке Engine, в том числе для Ubuntu и Debian. Устанавливайте плагин по инструкции Compose для Linux. Compose устанавливается как плагин и вызывается командой docker compose.

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

Сеть и внешние системы

Параметр Минимальное требование Примечание
PostgreSQL База доступна контейнеру приложения; порт по умолчанию — 5432, точные параметры задаёт переменная среды DATABASE_URL Используйте защищённое соединение и сетевые правила вашей организации
1С:ЗУП 8 Исходящий доступ от приложения к 1С, если вы используете интеграцию Ограничьте исходящее соединение адресами и параметрами, настроенными для вашей 1С
Почта и лицензирование Исходящий доступ к SMTP и сервису лицензирования, если вы используете эти функции Используйте адреса и параметры из настроек соответствующих сервисов; фиксированные порты не задаются
Вход операторов Указанное через переменную HOST_PORT значение сетевого порат на узле с Docker не должно быть занято другим сервисом; по умолчанию это 8080 на 127.0.0.1 Для удалённого оператора используйте SSH-туннель или HTTPS-прокси по инструкции установки

На хосте где разворачивается приложение не нужно устанавливать Go, Node.js и npm: готовый образ уже содержит необходимые компоненты. В образ также включены корневые сертификаты и часовые пояса.

Для доступа к панели администратора и кабинету сотрудника используется WEB-браузер, а также приложение аутентификатор для одноразовых кодов. Устанавливать эти программы на хост где разворачивается экземпляр сервиса не нужно.

Далее: Подготовка среды.