deploy-server

name

deploy-server

description

Use when the user asks to deploy, update, ship, push to server, "обнови сервер", "задеплой", "выкати на прод", "deploy", "push to docker host". Синкает src/ на удалённый Docker-хост через rsync и перезапускает контейнер. Различает code-only update и full rebuild по тому, что изменилось. Do NOT use for: локальный docker compose up, изменения конфигов на сервере (config/ и .env на сервере — authoritative и не трогаются).

deploy-server: обновление nnp-ai-router на удалённом Docker-хосте

Контекст

• Хост: ssh docker (alias)
• Путь на сервере: /home/serge/docker/server-ai-api
• Контейнер: server-ai-api-api-1
• Порт: 8777 (host) → 8000 (container)
• Без git — файлы синкаются напрямую rsync'ом.
• Volume mount ./src:/app/src — изменения в src/ подхватываются после restart.

Важно: config/ и .env на сервере — authoritative.

• Никогда не rsync-ать корень проекта.
• Никогда не пушить локальные config/*.yaml или .env.
• На сервере другие провайдеры и ключи, чем локально (dummy там не работает).

Алгоритм

Шаг 1. Pre-deploy: проверить, что изменилось

git status --short
git diff --stat HEAD requirements.txt Dockerfile

Развилка:

• Изменён только src/ → code-only update (Шаг 3a).
• Изменены requirements.txt или Dockerfile → full rebuild (Шаг 3b).
• Изменены config/ → остановиться и спросить пользователя (это authoritative на сервере).

Шаг 2. Проверить состояние сервера

ssh docker "docker logs server-ai-api-api-1 --tail 5"

Если контейнер мёртв или сыпет ошибками — показать пользователю и подтвердить деплой.

Опционально (когда подозреваешь рассинхрон зависимостей):

ssh docker "cat /home/serge/docker/server-ai-api/requirements.txt" | diff - requirements.txt

Если diff есть, а локально requirements.txt не менялся — на сервере что-то руками поменяли, остановиться и спросить.

Шаг 3a. Code-only update

rsync -av --delete src/ docker:/home/serge/docker/server-ai-api/src/
ssh docker "cd /home/serge/docker/server-ai-api && docker compose restart"

Шаг 3b. Full rebuild (только если менялись requirements/Dockerfile)

rsync -av --delete src/ docker:/home/serge/docker/server-ai-api/src/
scp requirements.txt docker:/home/serge/docker/server-ai-api/
scp Dockerfile docker:/home/serge/docker/server-ai-api/
ssh docker "cd /home/serge/docker/server-ai-api && docker compose up --build -d"

Шаг 4. Verify

sleep 3 && ssh docker "docker logs server-ai-api-api-1 --tail 20"

Должно быть:

• Configuration manager initialized — конфиги загрузились.
• Application startup complete — стартанули все воркеры (uvicorn запускает 4).
• Нет Traceback, ImportError, ModuleNotFoundError.

Если ошибки — показать пользователю tail-50 и не считать деплой успешным.

Правила

• Никогда не rsync-ать корень проекта или config//.env — затрёт прод-конфиги.
• Никогда не запускать docker compose down на сервере без явной просьбы — рестарт достаточно для code-only.
• Не использовать docker compose up --build для code-only изменений — лишние 1-2 минуты на пересборку, при этом ничего не меняется (volume mount уже даёт код).
• Если pre-deploy проверка показывает, что сервер мёртв или нездоров — спросить пользователя, прежде чем накатывать.
• Не использовать --no-verify или другие обходы при git-операциях, если они вдруг возникнут в процессе.

Отчёт пользователю

Краткий отчёт:

Synced src/ → docker:/home/serge/docker/server-ai-api/src/
Restarted container, N workers up clean

При full rebuild — упомянуть, что пересобрался образ. При ошибках — показать релевантные строки логов.