Community코딩 & 개발github.com

스테이징 배포

현재 앱을 스테이징에 배포합니다. 테스트 실행, 빌드, 인간 승인 요청 후 스테이징 배포 스크립트와 헬스 스모크 체크를 실행합니다. 사용자가 스테이징에 배포하려 할 때 사용합니다 (데모 대상: ex_staging).

스테이징 배포란 무엇인가요?

이 스킬은 개발자가 안전하고 반복 가능한 방식으로 애플리케이션을 스테이징 환경에 배포할 수 있도록 설계된 AI 에이전트 도구입니다. 주로 Claude Code, Cursor와 같은 AI 코딩 어시스턴트에서 사용되며, 데모 대상으로 `ex_staging` 디렉토리를 사용합니다. 핵심 기능은 깃 상태 확인, 테스트 실행, 빌드, 인간 승인 게이트, 배포 스크립트 실행, 헬스 스모크 체크 순서로 진행됩니다. 특히 모든 단계에서 실패 시 멈추고 명확한 출력을 제공하며, 배포 전 반드시 사용자의 명시적 승인을 요구하여 무단 배포를 방지합니다. 최종적으로 배포된 URL과 헬스 체크 결과를 요약하여 제공함으로써 개발자에게 투명한 피드백을 제공합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/olonok69/cursor_code_ml_engineer/tree/HEAD/.cursor/skills/deploy-staging

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스테이징 배포은(는) 무엇을 하나요?

스테이징에 안전하게 배포하기 위한 반복 가능한 절차입니다. 데모 대상: ex_staging/ 폴더 (실제 클라우드가 아닌 로컬 시뮬레이션 스테이징).

단계

  1. 대상(ex_staging 또는 @-언급된 경로)으로 cd합니다.
  2. 대상의 git 트리를 확인합니다: git status --porcelain -- . (해당 폴더에서) 또는 git status --porcelain -- ex_staging. 대상에 커밋되지 않은 변경 사항이 있으면 중단하고 알립니다. (코스 모노레포의 다른 폴더에 있는 변경 사항은 알린 후 무시할 수 있습니다.)
  3. 테스트 실행: npm test. 실패하면 중단하고 출력을 보여줍니다.
  4. 빌드: npm run build. 실패하면 중단합니다.
  5. 배포 전 인간 확인을 요청합니다 (외부 작업 / 프로덕션에서 되돌릴 수 없음). 이 채팅에서 사용자의 명시적 승인이 있을 때까지 배포를 실행하지 마세요.
  6. 승인 후: npm run deploy:staging (node scripts/deploy.mjs staging과 동일).
    • 이 데모에서는 로컬 서버를 시작하고 .staging-url을 작성합니다.
    • 실제 저장소에서는 ./scripts/deploy.sh staging 또는 파이프라인으로 대체하세요.
  7. 스모크 체크: .staging-url을 읽고 GET {url}/health를 호출합니다 (curl, Invoke-WebRequest 또는 fetch). HTTP 200 및 ok: true여야 합니다.
  8. 요약: 배포된 내용, URL, 스모크 결과. 데모를 종료하려면 npm run staging:stop을 언급합니다.

규칙

  • 절대 테스트가 실패하거나 대상이 더러운 상태에서 배포하지 마세요.
  • 절대 명시적인 인간 요청/확인 없이 배포하지 마세요 (핸드오프 게이트).
  • 항상 각 명령어의 실제 출력을 보여주세요.
  • 이 저장소에서 staging.example.com을 사용하지 마세요. 스모크는 .staging-url의 로컬 URL을 대상으로 합니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬