Требования к установке
Аппаратные характеристки к серверу, на котором будет разворачиваться и запускаться основной экземпляр сервиса, должны соответствовать значениям из расчетных параметров указаных ниже. Значения рассчитаны по результатам локальных нагрузочных тестов. Параметры сервера 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-браузер, а также приложение аутентификатор для одноразовых кодов. Устанавливать эти программы на хост где разворачивается экземпляр сервиса не нужно.
Далее: Подготовка среды.