deploy-verification-loop

name

deploy-verification-loop

description

배포 직후 일정 간격(예 15분)마다 health·smoke 엔드포인트를 curl로 찔러보고, 실패하면 배포 로그·환경변수·마이그레이션을 점검해 가장 작은 수정을 적용한 뒤, 설정한 모든 엔드포인트가 성공 응답을 줄 때까지 반복하는 인터벌 루프입니다. 사용자가 "배포 후 헬스체크 돌려줘", "배포 검증 루프", "deploy 끝나고 health/smoke 엔드포인트 다 통과할 때까지 15분마다 체크", "배포하고 나서 헬스 엔드포인트 주기적으로 찔러줘", "배포 잘 떴는지 확인 루프", "deploy verification loop", "hit health and smoke endpoints after a deploy", "verify deploy until healthy", "post-deploy health check loop"처럼 배포가 정상인지 주기적으로 검증하고 싶을 때 사용하세요. (구분: 배포 후 한 번 수동으로 고정 스모크 체크리스트를 도는 건 looping:staging-smoke-test, 원격 CI 실행을 주기적으로 감시하는 건 looping:ci-failure-watcher, DB 마이그레이션을 깨끗이 적용시키는 건 looping:migration-until-applied, 열린 PR을 주기적으로 돌보는 건 looping:pr-babysitter)

배포 검증 루프 (Deploy Verification Loop)

일정 간격마다 배포 후 health·smoke 엔드포인트를 찔러보고, 모든 체크가 정상 응답을 줄 때까지 반복합니다.

항목	값
카테고리	DevOps
트리거	인터벌(interval) — 기본 15분마다
종료 조건(Exit)	설정한 모든 health 엔드포인트가 성공 응답을 반환할 때
반복 한도(Max iterations)	8
매 반복 체크 명령	curl -fsS <your-health-url>
가드레일	강화됨(Hardened)
지원 에이전트	Claude Code · Cursor · Codex

이 루프는 언제 쓰나

배포 버튼을 누른 직후 "진짜 잘 떴나?"를 사람이 새로고침하며 들여다보는 대신, 정해진 간격마다 에이전트가 health·smoke 엔드포인트를 대신 찔러보고 정상으로 수렴할 때까지 지켜보게 할 때 씁니다. 배포 직후에는 인스턴스 워밍업, 마이그레이션 지연, 환경변수 누락, 롤아웃 시차 때문에 잠깐 빨갛다가 자연히 초록으로 바뀌는 일이 흔합니다. 이 루프는 그 시차를 견디며 찔러보기 → 실패 조사 → 재검증을 주기적으로 반복하고, 진짜 문제(설정 누락·마이그레이션 실패 등)면 가장 작은 수정을 적용하거나 명확한 블로커로 에스컬레이션합니다. 상태 코드와 응답 본문을 매 회차 기록하므로, 어느 엔드포인트가 언제부터 정상이 됐는지 흐름이 그대로 남습니다.

루프 흐름

〔15분마다〕→ health/smoke 엔드포인트 찔러보기 → 실패 조사 → 재검증 →〔피드백 게이트〕
   설정한 엔드포인트가 전부 성공? → 아니오: 다음 틱에 반복(최대 8회) / 예: 종료

매 반복(pass)마다 하는 일

1. health 엔드포인트 찔러보기 — 설정해 둔 health/smoke URL을 curl로 호출합니다. 상태 코드와 응답 본문을 기록합니다.

   curl -fsS https://your-app.example/health
   

2. 실패 조사 — 엔드포인트가 하나라도 실패하면 최근 배포 로그, 환경변수(env vars), 마이그레이션을 확인합니다. 가장 작은 수정을 적용합니다.
3. 재검증 — 수정 또는 롤백 결정 후 health 체크를 다시 돌립니다.

가드레일 (점수 조작 방지 규칙)

종료 조건을 "가짜로" 통과시키지 못하게 막는 규칙입니다. 반드시 지키세요.

• 체크 명령이나 종료 기준을 고쳐서 억지로 성공시키지 않는다.
• 체크를 건너뛰거나 비활성화·우회해서 종료 조건을 통과시키지 않는다.
• 여러 번 반복해도 막히면, 지표를 조작하지 말고 멈추고 블로커를 보고한다.

Claude Code에서 실행하기

이 루프는 시간 기반(인터벌) 입니다. Claude Code에서 인터벌 루프를 돌리는 방법은 두 가지입니다.

방법 1 — /loop (이번 세션 동안 주기 실행)

/loop 15m "배포 검증 루프(Deploy Verification Loop)"를 시작합니다.

목표: 배포 후 모든 health·smoke 엔드포인트가 성공 응답을 반환한다.
최대 반복: 8.
매 반복 사이 실행: curl -fsS <your-health-url>
종료 조건: 설정한 모든 엔드포인트가 성공할 때.

1단계: health/smoke URL을 찔러본다. 실패가 있으면 배포 로그를 살펴 고치거나 에스컬레이션한다.

방법 2 — /schedule (세션을 닫아도 도는 cron형 클라우드 에이전트) 세션을 꺼도 계속 검증하게 하려면 /schedule로 위 프롬프트를 cron(예: */15 * * * *)에 등록하세요. 배포 파이프라인이 끝난 뒤 한동안 무인 감시를 돌려야 할 때 적합합니다.

전제: <your-health-url>을 실제 health/smoke 엔드포인트로 바꾸고, 인증이 필요한 엔드포인트면 curl에 헤더(-H "Authorization: ...")나 토큰을 함께 넘기세요.

팁 / 변형

• 여러 엔드포인트: health 외에 smoke·readiness까지 보려면 체크를 묶으세요. 예: curl -fsS $URL/health && curl -fsS $URL/ready.
• 체크 명령 교체: 순수 curl 대신 httpie(http --check-status GET $URL/health)나 프로젝트 스크립트(npm run smoke)로 바꿔도 됩니다. -fsS는 실패 시 0이 아닌 종료 코드를 주므로 종료 조건 판단에 유용합니다.
• 간격 조정: 롤아웃이 느리면 /loop 30m처럼 늘리고, 빠른 배포 검증이면 5m으로 좁히세요.
• 막힐 때: 같은 엔드포인트가 2회 연속 실패하면 가드레일대로 지표를 조작하지 말고, 롤백 여부 판단과 함께 사람에게 에스컬레이션하게 하세요.
• 연관 루프: 배포 후 한 번 도는 고정 스모크 체크리스트는 looping:staging-smoke-test, 원격 CI 감시는 looping:ci-failure-watcher, DB 마이그레이션 적용은 looping:migration-until-applied.

원본 영어 kickoff (loops.elorm.xyz 원문)

/loop 15m Start the "Deploy Verification Loop".

Goal: all post-deploy health and smoke endpoints return success.
Max iterations: 8.
Between iterations run: curl -fsS <your-health-url>
Exit when: every configured endpoint succeeds.

Step 1: Hit health/smoke URLs. If any fail, inspect deploy logs and fix or escalate.

출처: https://loops.elorm.xyz/loops/deploy-verification-loop