shuim
ea644a37f3
- .claude/settings.json (공유) 신설, hooks 를 settings.local.json 에서 이동 - bash_guard (PreToolUse): 로컬 스택 기동·운영 DB alembic·_test 아닌 pytest·main 강제 push·위험 rm 차단, main push/deploy.sh 는 장중 경고와 함께 확인 요청, backend 커밋 전 유닛 스위트 게이트 - rules_check (PostToolUse): py_compile + CLAUDE.md 규칙(json.dumps, except 후 logger.debug, except-pass, 실시간 계층 DB I/O) — diff 추가 라인만 - session_context (SessionStart): 브랜치·미커밋·장 상태·alembic head 주입 - stop_check (Stop): frontend 변경 시 tsc - auto-orchestrate: 서브에이전트 보고·시스템 알림·질문형 프롬프트 오발동 제거 - /deploy 스킬 + deploy.sh / prod_smoke.sh: 테스트→dev push→main 병합→재기동 감시→공개 API 스모크 - 팀 에이전트·orchestrate 스킬 추적 시작, settings.local.json 추적 해제(.gitignore) - CLAUDE.md §9 하네스 - 훅 테스트 69 passed Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.9 KiB
3.9 KiB
name, description
| name | description |
|---|---|
| deploy | auto-stock 운영 배포(dev → main → Jenkins → NAS) 절차. 사용자가 "배포해", "main 에 올려", "릴리스", "운영 반영"을 요청하거나 배포 후 재기동/스모크 확인이 필요할 때 사용. 사용법: /deploy [-m "병합 메시지"] [--watch-only] [--no-test] |
배포 (deploy)
수동 절차를 .claude/scripts/deploy.sh 로 코드화했다. 직접 git push origin main / HEAD:main 을 치지 말고 이 스크립트를 쓴다
(작업 브랜치 dev 를 바꾸지 않고, 임시 worktree 에서 병합하며, 재기동 감시·스모크까지 한 번에 한다).
배포 전 체크 (사람이 아니라 스크립트가 강제하는 것 + 에이전트가 확인할 것)
- 검증 게이트: 변경은 code-verifier/유닛 스위트 통과 상태여야 한다. 스크립트가 깨끗한 worktree 의 HEAD 기준으로
pytest tests/ --ignore=tests/integration를 다시 돌리며, 실패하면 중단한다.--no-test는 금지는 아니지만 경고 대상이다 — 정당한 사유(문서만 변경 등)가 있을 때만. - 작업트리:
.claude/settings.local.json외 미커밋 변경이 있으면 중단. 먼저 커밋(커밋 게이트가 backend 변경 시 테스트를 돌린다). - 브랜치: dev 에서만 실행. 새 브랜치 생성 금지.
- alembic 마이그레이션 포함 여부: 스크립트가
backend/alembic/versions변경을 감지하면 경고한다. 포함 시 Jenkins 로그에서alembic upgrade head가 앱 기동보다 먼저 성공했는지 반드시 확인하도록 사용자에게 안내한다(CLAUDE.md §1 배포 순서, 전략 파라미터 마이그레이션 0012 계열 포함). - 장중 여부: 평일 08:30~15:40 KST 는 재기동이 매매(DT 포지션, 스케줄러, KIS 토큰)에 영향을 준다. bash_guard 가
ask로 사용자 확인을 받는다. 장외(15:40 이후·주말)를 권장. - 운영 서버·KIS 를 직접 호출하지 않는다. 스모크는 공개 GET 3개뿐이다.
사용
# 전체 배포 (기본 병합 메시지)
bash .claude/scripts/deploy.sh
# 병합 메시지 지정
bash .claude/scripts/deploy.sh -m "Merge dev: DT 시간손절 밴 제외 수정"
# 이미 푸시된 배포의 재기동 감시 + 스모크만
bash .claude/scripts/deploy.sh --watch-only
# 테스트까지만 (푸시 없음) — 사전 점검용
bash .claude/scripts/deploy.sh --dry-run
# 스모크만
bash .claude/scripts/prod_smoke.sh
단계: (a) 작업트리 확인 → (b) worktree 유닛 스위트 → (c) git push origin dev → (d) 임시 worktree 에서 origin/main 에
--no-ff 병합 후 git push origin HEAD:main → (e) /api/v1/analysis/performance 비-200 → 200 재기동 감시(최대 15분, 15초 간격)
→ (f) 공개 API 스모크(market/indices, journals/stats, analysis/performance). 병합 커밋 끝에 Co-Authored-By: Claude Opus 5.5 트레일러가 붙는다.
배포 후 확인 포인트
- 감시 결과: "재기동 완료(200 복귀)" 여야 한다. "재기동 미감지"는 빌드 지연/무중단 교체/변경 없음 — Jenkins 로그 확인. "여전히 비-200"은 배포 실패 의심.
- 스모크 3개 모두
OK(200 + JSON 유효). - 마이그레이션 포함 시: Jenkins 로그의 alembic 단계, 그리고
alembic_version이 새 head 인지. - 장중 배포였다면: DT 포지션 복원(
restore_from_db)·스케줄러 기동 로그, MDD 갱신 health 확인. 토큰 충돌 징후(KIS 인증 오류)가 없는지. - 병합 충돌로 중단되면 main 은 건드려지지 않는다. dev 에 origin/main 을 병합해 해결 후 재시도.
하지 말 것
- 훅 비활성화/우회,
git push --forceto main, 로컬docker compose up, 로컬에서 운영 DB 대상 alembic (bash_guard 가 deny). - 사용자 승인 없이 배포 실행: main 푸시는 항상 사용자 확인(ask)을 거친다.