Демонстрационный стенд 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 использует прежние тома.