Установить приложение в Docker
Запустите образ приложения рядом с подготовленной внешней PostgreSQL. Скопируйте файлы compose.yaml и заполненный .env из раздела Подготовка среды в один рабочий каталог.
Для локального знакомства с приложением, тестовой 1С и PostgreSQL используйте демонстрационный стенд.
Запуск с внешним сервисом PostgreSQL
Получить образ приложения
Выберите способ, который предоставил поставщик.
Из registry. Если registry закрытый, выполните docker login по
официальной инструкции. Затем загрузите образ:
docker compose pull
Из tar-архива. Получите у поставщика архив образа для архитектуры Docker-хоста
и скопируйте его на этот хост. Загрузите образ в то же Docker-окружение, где
запускается compose:
docker image load --input salary-slip.tar
Команда также принимает сжатые архивы (*.zip). Она выводит загруженное имя с тегом;
укажите это точное значение в SALARY_SLIP_IMAGE файла .env. Например, если
вывод содержит Loaded image: querion/salary-slip:1.2.3, задайте:
Например:
SALARY_SLIP_IMAGE=querion/salary-slip:1.2.3
Используйте имя и тег из вывода docker image load и
значение, выданное поставщиком. Для архива не нужны docker login и
docker compose pull. Подробнее см. в документации Docker о команде
загрузки образа.
Для варианта deploy/compose.yaml также обеспечьте доступ к образу PostgreSQL
и, если включён тестовый сервис 1С, к его образу в этом Docker-окружении.
Загрузите их отдельно, если архив поставщика их не включает, либо используйте
registry.
Запустить приложение
-
Проверьте файл
compose.yaml, не выводя значения переменных:docker compose config --quiet -
Запустите приложение без попытки загрузить образ из registry:
docker compose up -d --pull never -
Проверьте состояние контейнера:
docker compose ps -
Проверьте состояние приложения на Docker-хосте:
curl -i http://127.0.0.1:8080/health curl -i http://127.0.0.1:8080/ready
ready проверяет доступность PostgreSQL. Эти проверки не подтверждают подключение к 1С, почте или проверку лицензии.
Порт по умолчанию опубликован только на 127.0.0.1. Если Docker-хост удалённый, откройте SSH-туннель со своего компьютера:
ssh -L 8080:127.0.0.1:8080 user@docker-host
Внимание
Не закрывайте соединение, пока работаете с приложением.
На своём компьютере откройте http://127.0.0.1:8080/admin в браузере.
Предупреждение
Не открывайте порт контейнера напрямую в публичный Интернет-доступ. Настройте HTTPS на отдельном обратном прокси и ограничьте сетевой доступ из публичной сети.
Изменение параметров подключения в панели приложения не меняет публикацию порта запущенного контейнера Docker.
Подключить UUID перед активацией лицензии
Следующие шаги относятся к корневому compose.yaml с внешним сервисом PostgreSQL. Выполните их до активации лицензии. Скопируйте системный system_uuidв постоянный файл, доступный UID контейнера 10001 для чтения. На Linux компьютере исходный файл часто находится в /sys/class/dmi/id/product_uuid; в виртуальной машине используйте UUID гостя.
sudo install -D -m 0444 /sys/class/dmi/id/product_uuid \
/etc/salary-slip/license-host/system_uuid
В основном compose.yaml раскомментируйте переменную LICENSE_HOST_SYSTEM_UUID_FILE и параметры подключения раздела. В примере compose уже указан постоянный путь UUID:
services:
salary-slip:
environment:
LICENSE_HOST_SYSTEM_UUID_FILE: /run/license-host/system_uuid
volumes:
- type: bind
source: /etc/salary-slip/license-host/system_uuid
target: /run/license-host/system_uuid
read_only: true
bind:
create_host_path: false
Проверьте конфигурацию и примените изменение:
docker compose config --quiet
docker compose up -d --pull never --force-recreate salary-slip
Не меняйте UUID после активации лицензии и не помещайте его в общий том приложения. Для rootless Docker или переназначения UID настройте права на чтение файла для соответствующего UID, который видит контейнер. Затем откройте Настройки → Лицензия и активируйте лицензию.
Первый вход и настройки
- Войдите с
ADMIN_LOGINиADMIN_TEMP_PASSWORD, заданными при подготовке пустой базы. - Смените временный пароль и следуйте подсказкам администратора на экране, чтобы настроить приложение одноразовых кодов на телефоне.
- Откройте Настройки → 1С и укажите подключение к 1С:ЗУП 8. Без настроенной 1С сервис запустится, но расчётные листки сотрудникам не поступят.
- Если нужны приглашения и другие письма, настройте параметры SMTP сервера в панели администратора.
- Удалите
ADMIN_LOGINиADMIN_TEMP_PASSWORDиз.env.
После входа откройте руководство администратора, чтобы узнать, как управлять учётными записями, подключением и настройками.
Сохранённые настройки 1С и почты начинают действовать после перезапуска приложения. Примените их после удаления bootstrap-переменных, пересоздав контейнер:
docker compose up -d --pull never --force-recreate salary-slip
При установке из tar-архива используйте --pull never и при последующих
пересозданиях, чтобы compose не обращался к registry. Справка Docker описывает
этот параметр команды docker compose up.
Прежде чем активировать коммерческую лицензию убедитесь, что system_uuid смонтирован в качестве постоянного раздела. После этого пересоздайте сервис командой docker compose up -d --pull never --force-recreate salary-slip. Данные параметры отражены в примере compose.yaml.