# Сборка и выкладка

Стандарт jcb-deploy - v0.1 - 2026-11-16

## Суть

Приложение выкладывается образом контейнера и знает о сервере минимум: переменные окружения и проверка здоровья.
Всё про конкретную машину (прокси, файрвол, ключи, адреса) — вне репозитория.

## Образ

- Сборка и запуск — разные этапы: в образе запуска только результат сборки, процесс не от root.
- В образ не попадают `.env`-файлы, базы, результаты проверок, `.git`.
- Настройки — только окружение контейнера.

## Приложение само

- **Применяет миграции при старте.** Применённые миграции не меняются. Несколько экземпляров — миграции под
  блокировкой.
- **Отвечает на проверку здоровья** (`GET /_health`): 200 с версией и состоянием базы или 503, если база не
  отвечает.
- **Фоновые задачи** — по расписанию внутри приложения; повторный запуск ничего не ломает.

## Ограничения записаны

- **Сколько экземпляров можно**: один, если лимиты хранятся в памяти процесса.
- **За прокси**: приложение доступно только через прокси, прокси заменяет `X-Forwarded-For`, а не дописывает.

## Обвязка

- Приложение слушает только локальный адрес сервера, база наружу не открыта.
- CI: проверки на каждый push; образ — на тег версии, в реестр.
- Выкатить и откатить версию по тегу — одной командой. Резервная копия базы и восстановление — тоже.

## Перед выкладкой и после

Записаны два списка:

- **перед выкладкой**: проверки зелёные; боевой образ собран и запущен локально с настоящей базой;
- **после выкладки руками**: здоровье, то, что проверками не покрыто (почта, вход через поставщиков, флаги cookie на
  https), закрытые страницы отвечают 404.

## Проверка

- Образ собирается из чистого клона; в нём нет `.env`-файлов и `.git`.
- Контейнер со всеми переменными стартует, `/_health` отвечает 200.
- Списки «перед выкладкой» и «после выкладки» есть.

## История

- v0.1 — 2026-11-16: черновик, из практики MoveTap.
