Skill

06-infra

인프라 및 DevOps 셋업 단계. "인프라 설정", "CI/CD 파이프라인", "배포 설정", "Docker 설정", "클라우드 셋업", "모니터링", "로깅", "infrastructure", "devops", "deployment" 요청 시 사용.

npx claudepluginhub shaul1991/shaul-plugin --plugin project-lifecycle

Tool Access

This skill uses the workspace's default tool permissions.

Preview

애플리케이션을 안정적으로 빌드, 배포, 운영하기 위한 인프라와 자동화 파이프라인을 구성한다.

Supporting Assets

references/ci-cd-templates.mdreferences/dockerfile-templates.mdreferences/iac-templates.md

SKILL.md

Similar Skills

ui-to-vue

180.0k

Batch-converts UI design screenshots from directories into Vue 3 Composition API components, mapping elements to Vant, Element Plus, or Ant Design Vue libraries.

ecc

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 28, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Phase 6: 인프라 / DevOps (Infrastructure)

애플리케이션을 안정적으로 빌드, 배포, 운영하기 위한 인프라와 자동화 파이프라인을 구성한다.

필수: Plan → Review → Execute → Re-verify

이 Phase를 시작하기 전에 반드시 거버넌스 프로세스를 따른다.

PLAN — 실행계획서를 작성한다 (governance 스킬의 references/execution-plan-template.md 참조)
- .claude/local/plans/<sanitized-branch>/06-infra/execution-plan.md로 저장 (브랜치별 작업 영역, gitignore 대상)
- 목표, 범위, 실행 단계, 성공 기준을 구체적으로 기술
REVIEW — 실행계획서를 사용자에게 제시하고 명시적 수락을 받는다
- 승인(Approved) → 실행 절차로 진행
- 수정 요청(Revise) → 계획 수정 후 재검증
- 거부(Rejected) → 근본적 재설계
EXECUTE — 수락된 계획에 따라 아래 실행 절차를 수행한다
RE-VERIFY — 실행 완료 후 산출물과 결과를 재검증한다
- 성공 기준 대비 달성 여부 확인
- 산출물 완결성 및 이전 Phase와의 정합성 검증
- 교훈(Lessons Learned) 기록
- 통과(Pass) → 다음 Phase 진행 / 미달(Fail) → 보완 실행 또는 계획 재수립

⚠️ 실행계획 수립과 수락 없이 실행에 들어가지 않는다. 실행 후 재검증 없이 다음 Phase로 넘어가지 않는다.

전제 조건

Phase 3의 기술 스택 및 배포 구조 (.claude/03-architecture/tech-stack.md)
Phase 5의 프로젝트 코드가 기본 구조 갖춤

실행 절차

Step 1: 컨테이너화

Dockerfile 작성 — 멀티스테이지 빌드, 최소 이미지
docker-compose.yml — 로컬 개발 환경 (앱 + DB + 캐시 등)
.dockerignore — 불필요한 파일 제외

Dockerfile 베스트 프랙티스:

멀티스테이지 빌드로 이미지 크기 최소화
non-root 사용자로 실행
COPY package*.json 먼저 → npm install → COPY . (레이어 캐싱)
health check 포함

Step 2: CI/CD 파이프라인

사용하는 도구(GitHub Actions, GitLab CI 등)에 맞게 파이프라인 구성:

CI (Continuous Integration):

코드 체크아웃
의존성 설치 (캐시 활용)
린트 & 포맷 체크
타입 체크
단위 테스트
통합 테스트
빌드
(선택) 보안 스캔

CD (Continuous Deployment):

Docker 이미지 빌드 & 푸시
스테이징 배포
스모크 테스트
(수동 승인)
프로덕션 배포
헬스 체크
(실패 시) 자동 롤백

Step 3: 환경 구성

각 환경별 설정을 분리:

환경	용도	특성
local	개발자 로컬	Docker Compose, 핫 리로드
dev	개발 통합	자동 배포, 테스트 데이터
staging	릴리즈 전 검증	프로덕션과 동일 구성
production	실 서비스	고가용성, 모니터링

Step 4: 모니터링 & 로깅

APM — 애플리케이션 성능 모니터링 (Datadog, New Relic, Grafana)
로깅 — 구조화된 로그, 중앙 집중 수집 (ELK, CloudWatch)
알림 — 임계치 기반 알림 (PagerDuty, Slack webhook)
업타임 모니터링 — 외부 헬스체크 (UptimeRobot, Pingdom)

로깅 레벨 정의:

레벨	용도	프로덕션
ERROR	즉시 대응 필요한 에러	O
WARN	잠재적 문제	O
INFO	주요 비즈니스 이벤트	O
DEBUG	디버깅 정보	X
TRACE	상세 추적	X

Step 5: 보안 기본 설정

시크릿 관리 — 환경 변수, Secret Manager
HTTPS — SSL 인증서 (Let's Encrypt, ACM)
CORS — 허용 오리진 설정
Rate Limiting — API 요청 제한
WAF — 웹 방화벽 (필요 시)

Step 6: 산출물 생성

.claude/06-infra/infrastructure.md — 인프라 구성 문서
.claude/06-infra/ci-cd.md — CI/CD 파이프라인 문서
.claude/06-infra/monitoring.md — 모니터링/알림 설정
인프라 코드 — Dockerfile, docker-compose.yml, CI/CD 설정 파일

가이드라인

IaC (Infrastructure as Code) — 인프라 변경은 코드로 관리
환경 동일성 — dev/staging/prod 간 차이 최소화
시크릿은 코드에 절대 포함하지 않음 — .env는 .gitignore에
점진적 구축 — MVP에서는 단순하게 시작 (PaaS → 필요 시 K8s)
배포는 자동화, 롤백은 즉시 가능하게
비용 모니터링 — 클라우드 예산 알림 설정

참고 자료

references/dockerfile-templates.md — 언어별 Dockerfile 템플릿
references/ci-cd-templates.md — CI/CD 파이프라인 템플릿
references/iac-templates.md — IaC (Infrastructure as Code) 템플릿