Установить приложение в 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.

Запустить приложение

  1. Проверьте файл compose.yaml, не выводя значения переменных:

    docker compose config --quiet
    
  2. Запустите приложение без попытки загрузить образ из registry:

    docker compose up -d --pull never
    
  3. Проверьте состояние контейнера:

    docker compose ps
    
  4. Проверьте состояние приложения на 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, который видит контейнер. Затем откройте Настройки → Лицензия и активируйте лицензию.

Первый вход и настройки

  1. Войдите с ADMIN_LOGIN и ADMIN_TEMP_PASSWORD, заданными при подготовке пустой базы.
  2. Смените временный пароль и следуйте подсказкам администратора на экране, чтобы настроить приложение одноразовых кодов на телефоне.
  3. Откройте Настройки → 1С и укажите подключение к 1С:ЗУП 8. Без настроенной 1С сервис запустится, но расчётные листки сотрудникам не поступят.
  4. Если нужны приглашения и другие письма, настройте параметры SMTP сервера в панели администратора.
  5. Удалите 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.