Демонстрационный стенд Docker Compose

Запустите три контейнера: приложение, тестовую 1С:ЗУП и PostgreSQL. Стенд доступен только на этом компьютере по адресу http://127.0.0.1:8080 и использует синтетические данные.

Подготовка образов

Выполните сборку mock из корня репозитория. Получите образ приложения у поставщика и загрузите его в Docker тем способом, который указан в разделе Установить приложение в Docker. Укажите в .env точное имя образа и тег, выданные поставщиком или показанные командой docker image load.

Соберите образ тестовой 1С из репозитория:

.\mock\onec\docker-build.ps1 -Image onec-mock:demo

Для Linux или macOS:

sh ./mock/onec/docker-build.sh onec-mock:demo

Встроенный файл default.json содержит двух сотрудников и один расчётный листок за август 2026 года. Он помещается в лимит демонстрационного режима. Большой файл employee-history.json для этого стенда не подходит: он содержит 28 сотрудников, тогда как демо-режим ограничен пятью.

Создание файлов Compose и .env

Создайте отдельный каталог для стенда, например C:\salary-slip-demo в Windows или ~/salary-slip-demo в Linux и macOS. Сохраните в нём оба файла примера. Не размещайте их рядом с Compose-файлом основной установки: у демонстрационного стенда будет своя база и свои тома.

Создайте файл demo.compose.yaml в каталоге стенда:

name: salary-slip-demo

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: salary
      POSTGRES_DB: salary_slip
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB} -h 127.0.0.1"]
      interval: 5s
      timeout: 5s
      retries: 12
      start_period: 10s

  onec-mock:
    image: onec-mock:demo
    restart: unless-stopped
    command: ["--listen", "0.0.0.0:18080", "--data-file", "/fixtures/default.json"]

  salary-slip:
    image: ${SALARY_SLIP_IMAGE:?Set SALARY_SLIP_IMAGE in .env}
    user: "10001:10001"
    restart: unless-stopped
    stop_grace_period: 60s
    depends_on:
      postgres:
        condition: service_healthy
      onec-mock:
        condition: service_started
    environment:
      DATABASE_URL: ${DATABASE_URL:?Set DATABASE_URL in .env}
      ENCRYPTION_KEY: ${ENCRYPTION_KEY:?Set ENCRYPTION_KEY in .env}
      LISTEN_ADDR: 0.0.0.0
      PORT: "8080"
      NODE_ID_FILE: /app/data/node-id.json
      INTEGRATION_PROVIDER: onec-zup8
      ONEC_URL: http://onec-mock:18080
      ONEC_PUBLISH_NAME: ziktest
      ONEC_ROOT_URL: salary-slip
      ONEC_USERNAME: mock-user
      ONEC_PASSWORD: synthetic-password
      ADMIN_LOGIN: ${ADMIN_LOGIN:-}
      ADMIN_TEMP_PASSWORD: ${ADMIN_TEMP_PASSWORD:-}
    volumes:
      - salary-slip-data:/app/data
      - salary-slip-logs:/app/logs
    ports:
      - "127.0.0.1:8080:8080"

volumes:
  postgres-data:
  salary-slip-data:
  salary-slip-logs:

Создайте рядом файл .env. Замените все значения REPLACE_... и укажите тег образа приложения, полученный у поставщика:

SALARY_SLIP_IMAGE=REPLACE_WITH_SUPPLIER_IMAGE_AND_TAG
POSTGRES_PASSWORD=REPLACE_WITH_OUTPUT_OF_openssl_rand_-hex_24
DATABASE_URL=postgres://salary:${POSTGRES_PASSWORD}@postgres:5432/salary_slip?sslmode=disable
ENCRYPTION_KEY=REPLACE_WITH_OUTPUT_OF_openssl_rand_-base64_32
ADMIN_LOGIN=REPLACE_WITH_ADMIN_LOGIN
ADMIN_TEMP_PASSWORD=REPLACE_WITH_UNIQUE_PASSWORD_AT_LEAST_12_CHARACTERS

Сгенерируйте значения командой openssl rand -hex 24 для пароля PostgreSQL и openssl rand -base64 32 для ключа шифрования. Скопируйте вывод первой команды в POSTGRES_PASSWORD: Compose подставит то же значение в DATABASE_URL. Шестнадцатеричный пароль состоит только из символов, безопасных в URL. Укажите непустое значение ADMIN_LOGIN и задайте временный пароль длиной не менее 12 символов. Эти две переменные нужны для создания первого администратора в пустой базе. Подставьте выданные поставщиком имя и тег вместо значения SALARY_SLIP_IMAGE. Не оставляйте строки REPLACE_... в файле.

Ключ ENCRYPTION_KEY должен быть base64-кодированием ровно 32 байт. Сохраните его в защищённом месте: без этого ключа приложение не сможет расшифровать записанные данные после пересоздания контейнеров.

Запуск стенда

Запускайте команды из каталога стенда. Проверьте конфигурацию, не выводя значения переменных:

docker compose --env-file .env -f demo.compose.yaml config --quiet

Если приложение получено из registry, загрузите оба образа:

docker compose --env-file .env -f demo.compose.yaml pull postgres salary-slip

Если вы загрузили приложение из tar-архива, загрузите только PostgreSQL:

docker compose --env-file .env -f demo.compose.yaml pull postgres

Теперь запустите стенд без дополнительных запросов к registry:

docker compose --env-file .env -f demo.compose.yaml up -d --pull never

Проверьте состояние контейнеров и готовность приложения:

docker compose --env-file .env -f demo.compose.yaml ps
curl -i http://127.0.0.1:8080/ready

Ответ /ready со статусом 200 означает, что приложение подключилось к PostgreSQL; он не проверяет тестовую 1С. Откройте http://127.0.0.1:8080/admin и войдите с данными ADMIN_LOGIN и ADMIN_TEMP_PASSWORD. При первом входе смените временный пароль и настройте одноразовые коды.

Переменные ADMIN_LOGIN и ADMIN_TEMP_PASSWORD нужны только при создании первого администратора в пустой базе. После входа удалите их из .env и пересоздайте контейнер приложения:

docker compose --env-file .env -f demo.compose.yaml up -d --pull never --force-recreate salary-slip

Прежде чем синхронизировать сотрудников и выдавать приглашения, задайте URL стенда, который попадёт в ссылку. Откройте Настройки → Транспорт и укажите:

Параметр Значение
Публичный URL http://127.0.0.1:8080
Режим работы сервиса HTTP
CORS origins (по одному на строку) http://127.0.0.1:8080

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

До синхронизации проверьте состояние подключения в разделе Настройки → 1С. Затем откройте Синхронизация и запустите ручную синхронизацию сотрудников из тестовой 1С. Подробные шаги приведены в инструкции по синхронизации. После завершения откройте Сотрудники и карточку активного сотрудника из синтетических данных. В разделе доступа нажмите Выдать приглашение, выберите Прямая ссылка и нажмите Выдать ссылку. Откройте её в приватном окне или другом браузере на этом же компьютере, чтобы сохранить вход администратора, и пройдите первый вход. SMTP не настроен, поэтому для стенда используйте прямую ссылку.

В кабинете сотрудника выберите август 2026 года, чтобы увидеть демонстрационный расчётный листок.

Параметры ONEC_* заданы в Compose и имеют приоритет над настройками, сохранёнными в приложении. Чтобы позже заменить их настройками из панели, удалите эти переменные из demo.compose.yaml и пересоздайте контейнер.

Остановка стенда

Остановите контейнеры, сохранив данные в именованных томах:

docker compose --env-file .env -f demo.compose.yaml down

Не добавляйте -v, если хотите сохранить базу и данные приложения. Следующий запуск с теми же файлами Compose использует прежние тома.