메뉴
Use when deploying new version to production server (fb.ikeniborn.ru). Covers full pipeline from merged PR to live deployment — git pull on server, registry image pull, smart container restart.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | deploy-prod |
| description | Use when deploying new version to production server (fb.ikeniborn.ru). Covers full pipeline from merged PR to live deployment — git pull on server, registry image pull, smart container restart. |
| version | 1.0.0 |
| author | Family Budget Team |
| tags | ["deployment","production","docker","ci-cd"] |
| user-invocable | true |
| context | fork |
Деплой новой версии на прод-сервер fb.ikeniborn.ru (194.34.239.2).
Обязательно перед деплоем:
prod ветку на GitHubIMAGE_VERSIONS.json (chore(ci): auto-update IMAGE_VERSIONS.json)Проверить статус PR:
gh pr view <PR_NUMBER> --json state,mergedAt
ssh budget-prod "cd ~/familyBudget && git pull 2>&1"
Репозиторий на сервере: ~/familyBudget (НЕ /opt/budget — это deployment dir).
ssh budget-prod "sudo bash -c 'cd /opt/budget && ./deploy.sh --use-registry --sync-mode mirror --cleanup-mode smart --repo-dir /home/ikeniborn/familyBudget' 2>&1"
Флаги:
| Флаг | Значение |
|---|---|
--use-registry | Pull образов из ghcr.io (не собирать локально) |
--sync-mode mirror | rsync с --delete --checksum из репо в /opt/budget |
--cleanup-mode smart | Анализ изменений → перезапуск только изменившихся сервисов |
--repo-dir /home/ikeniborn/familyBudget | Явный путь к репозиторию (без него — интерактивный запрос) |
sudo обязателен — .env принадлежит root (-rw------- 1 root root).
Успешный деплой завершается:
✓ backend: healthy
✓ bot: healthy
✓ nginx: healthy
✓ postgres: healthy
✓ redis: healthy
All smoke tests passed!
Smart cleanup пересоздаёт только сервисы с изменившимися образами:
backend recreate# 1. Проверить что PR влит
gh pr view 657 --json state,mergedAt
# 2. Обновить репозиторий на сервере
ssh budget-prod "cd ~/familyBudget && git pull 2>&1"
# 3. Задеплоить
ssh budget-prod "sudo bash -c 'cd /opt/budget && ./deploy.sh --use-registry --sync-mode mirror --cleanup-mode smart --repo-dir /home/ikeniborn/familyBudget' 2>&1"
Таймаут SSH: 600 секунд (deploy может занять 3–5 минут на pull образов).
.env not readable[ERROR] .env file is not readable
→ Запускать с sudo (см. выше).
Unknown option: --profileФлаг --profile устарел. Использовать --sync-mode / --cleanup-mode.
save_html_templates_checksum: command not foundУстаревший вызов в старой версии services.sh. После синхронизации кода (--sync-mode mirror) ошибка исчезает в следующем деплое — функция удалена в коммите 9d00dbcf.
CI/CD не завершил сборку. Дождаться коммита chore(ci): auto-update IMAGE_VERSIONS.json в prod.
Проверить, что git pull на сервере получил новые коммиты. Если нет — CI ещё не завершил или PR не влит.
~/familyBudget — git-репозиторий на сервере (source of truth для кода)/opt/budget — deployment dir (rsync target, не git repo)IMAGE_VERSIONS.json — per-service версии образов (обновляется CI автоматически)full — автоопределяется из .env (DEPLOYMENT_PROFILE=full) → postgres + backend + bot + nginx + certbotsafety_backup_pre_start_<timestamp>.sql.gzUse when writing, editing, or debugging Telegram bot code in the Family Budget project — adding new commands, conversation handlers, scheduled jobs, API client calls, authentication, notification service, or bot tests. Trigger on: "add command", "new handler", "telegram bot", "bot command", "conversation flow", "ConversationHandler", "add job", "scheduled task", "bot notification", "bot auth", "api_client", "session manager", "bot test", "PTB", "python-telegram-bot", "webhook", "polling", "bot menu", "WebApp button".
Use when writing, editing, or debugging backend Python code in the Family Budget project — adding API endpoints, creating or modifying SQLModel models, writing Alembic migrations, implementing service logic, fixing auth bugs, working with WebSocket/Redis pub-sub, or writing backend tests. Trigger on: "add endpoint", "new model", "create migration", "fix API", "add service", "backend bug", "authentication issue", "database query", "WebSocket event", "Redis cache", "write test", "pytest", "SQLModel", "FastAPI route", "Pydantic schema", "alembic", "background job", "scheduler".
Frontend development guide for the Family Budget project. Use this skill whenever you're writing, editing, or debugging TypeScript/JavaScript frontend code, Jinja2 templates, or CSS in this project — adding new features, implementing UI components, fixing bugs in existing pages (facts, plan, dashboard, lists), or wiring up API calls and WebSocket handlers. Trigger on: "add button", "create modal", "implement filter", "fix table", "new page", "update template", "CSS issue", "TypeScript error", "bundle", "window.X is not a function", "onclick not working".