القائمة
멀티 스테이지 빌드(multi-stage builds), docker-compose 오케스트레이션, 이미지 최적화, 디버깅 및 운영 모범 사례를 포함하는 포괄적인 Docker 컨테이너화 워크플로우입니다. 애플리케이션 컨테이너화, 개발 환경 구축 또는 Docker 배포 시 사용합니다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | docker-workflow |
| description | 멀티 스테이지 빌드(multi-stage builds), docker-compose 오케스트레이션, 이미지 최적화, 디버깅 및 운영 모범 사례를 포함하는 포괄적인 Docker 컨테이너화 워크플로우입니다. 애플리케이션 컨테이너화, 개발 환경 구축 또는 Docker 배포 시 사용합니다. |
Docker 컨테이너화는 애플리케이션과 그 종속성을 이식 가능하고 재현 가능한 컨테이너로 패키징하여 개발, 테스트 및 배포를 능률화합니다. 이 SKILL은 개발부터 운영에 이르기까지 전문적인 Docker 워크플로우를 안내합니다.
다음을 수행할 때 활성화하세요:
빌드 컨텍스트에서 불필요한 파일을 제외합니다:
node_modules/
__pycache__/
*.pyc
.git/
.env
*.log
dist/
build/
coverage/
포괄적인 템플릿은 examples/.dockerignore를 참조하세요.
핵심 원칙:
다음을 결정합니다:
멀티 스테이지 빌드는 최종 이미지 크기를 50-90% 줄여줍니다:
# Stage 1: Build
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
# Stage 2: Production
FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/index.js"]
Node.js, Python, Go, Java, Rust 템플릿은 examples/Dockerfile.multi-stage를 참조하세요.
순서가 중요합니다 - 자주 변경되는 콘텐츠는 마지막에 배치하세요:
# ✅ 좋음: 종속성이 별도로 캐시됨
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
# ❌ 나쁨: 파일이 하나만 변경되어도 캐시가 무효화됨
COPY . .
RUN npm ci
# 특정 버전 사용
FROM node:18.17.1-alpine
# non-root 사용자로 실행
RUN addgroup -g 1001 -S nodejs && adduser -S nodejs -u 1001
USER nodejs
# 소유권과 함께 복사
COPY --chown=nodejs:nodejs . .
보안 체크리스트:
docker-compose.yml을 생성합니다:
version: '3.8'
services:
app:
build:
context: .
dockerfile: Dockerfile
ports:
- "3000:3000"
environment:
- DATABASE_URL=postgresql://db:5432/myapp
depends_on:
db:
condition: service_healthy
volumes:
- ./src:/app/src # 개발 시 hot-reload
networks:
- app-network
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: myapp
volumes:
- postgres-data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U user"]
interval: 5s
networks:
- app-network
volumes:
postgres-data:
networks:
app-network:
모니터링, 큐, 캐싱이 포함된 전체 기능 설정은 examples/docker-compose.yml을 참조하세요.
환경별로 override 파일을 사용합니다:
개발용 (docker-compose.override.yml):
services:
app:
build:
target: development
volumes:
- ./src:/app/src
environment:
- NODE_ENV=development
command: npm run dev
운영용 (docker-compose.prod.yml):
services:
app:
build:
target: production
restart: always
environment:
- NODE_ENV=production
사용법:
# 개발 (override 파일이 자동으로 사용됨)
docker-compose up
# 운영
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
# 기본 빌드
docker build -t myapp:latest .
# 특정 스테이지 빌드
docker build --target production -t myapp:prod .
# BuildKit을 사용한 빌드 (빠름)
DOCKER_BUILDKIT=1 docker build -t myapp:latest .
# 단일 컨테이너
docker run -d -p 3000:3000 -e NODE_ENV=production myapp:latest
# Docker Compose
docker-compose up -d
# 로그 확인
docker-compose logs -f app
# 컨테이너 내 명령 실행
docker-compose exec app sh
# 중지 및 제거
docker-compose down -v
scripts/docker_helper.sh 유틸리티는 일반적인 디버깅 작업을 제공합니다:
# 컨테이너 상태 체크
./scripts/docker_helper.sh health myapp
# 상세 정보 조사
./scripts/docker_helper.sh inspect myapp
# 로그 확인
./scripts/docker_helper.sh logs myapp 200
# Shell 열기
./scripts/docker_helper.sh shell myapp
# 이미지 크기 분석
./scripts/docker_helper.sh size myapp:latest
# 리소스 정리 (Cleanup)
./scripts/docker_helper.sh cleanup
컨테이너가 즉시 종료되는 경우:
docker logs myapp
docker run -it --entrypoint sh myapp:latest
네트워크 연결성:
docker network inspect myapp_default
docker exec myapp ping db
볼륨 권한:
# Dockerfile에서 수정
RUN chown -R nodejs:nodejs /app/data
전략:
예시:
# ✅ 좋음: 결합 및 정리 완료
RUN apt-get update && \
apt-get install -y --no-install-recommends package1 && \
apt-get clean && \
rm -rf /var/lib/apt/lists/*
# BuildKit 활성화
export DOCKER_BUILDKIT=1
# 캐시 마운트(Cache mounts) 사용
RUN --mount=type=cache,target=/root/.cache/pip \
pip install -r requirements.txt
# 병렬 빌드
docker-compose build --parallel
FROM node:18-alpine AS production
# 보안: non-root 사용자
RUN addgroup -g 1001 -S nodejs && adduser -S nodejs -u 1001
WORKDIR /app
COPY --from=builder --chown=nodejs:nodejs /app/dist ./dist
USER nodejs
# Health check
HEALTHCHECK --interval=30s --timeout=3s \
CMD node healthcheck.js
EXPOSE 3000
CMD ["node", "dist/index.js"]
# Registry용 태그 지정
docker tag myapp:latest registry.example.com/myapp:v1.0.0
# Registry로 Push
docker push registry.example.com/myapp:v1.0.0
# 배포
docker-compose pull && docker-compose up -d
# 무중단 업데이트 (Rolling update)
docker-compose up -d --no-deps --build app
examples/docker-compose.yml 참조✅ latest가 아닌 구체적인 이미지 버전 사용
✅ non-root 사용자로 실행
✅ 민감한 데이터에는 secrets management 사용
✅ 이미지의 취약점 스캔 실시
✅ 최소한의 베이스 이미지 사용
✅ 멀티 스테이지 빌드 사용 ✅ 레이어 캐싱 최적화 ✅ .dockerignore 사용 ✅ RUN 명령 결합 ✅ BuildKit 사용
✅ 다중 컨테이너 앱에 docker-compose 사용 ✅ hot-reload를 위해 볼륨(Volumes) 사용 ✅ health checks 구현 ✅ 적절한 종속성 순서 적용
✅ 재시작 정책(Restart policies) 설정 ✅ 오케스트레이션(Swarm, Kubernetes) 사용 ✅ health checks로 모니터링 ✅ Reverse proxy 사용 ✅ Rolling updates 구현
# 빌드
docker build -t myapp .
docker-compose build
# 실행
docker run -d -p 3000:3000 myapp
docker-compose up -d
# 로그
docker logs -f myapp
docker-compose logs -f
# 실행 (Execute)
docker exec -it myapp sh
docker-compose exec app sh
# 중지
docker-compose down
# 정리 (Clean)
docker system prune -a
# 조사 (Inspect)
docker inspect myapp
# 상태 (Stats)
docker stats myapp
# 네트워크
docker network inspect bridge
# 볼륨
docker volume ls
OpenAPI/Swagger 사양, 인증 패턴, 버전 관리 전략 및 모범 사례를 사용하여 RESTful 및 GraphQL API를 설계하고 문서화합니다. 사용 사례: (1) API 사양 생성, (2) REST 엔드포인트 설계, (3) GraphQL 스키마 설계, (4) API 인증 및 권한 부여, (5) API 버전 관리 전략, (6) 문서 생성
코드나 구현 계획을 작성하기 전, 무언가를 생성하거나 개발할 때 사용합니다. 협력적인 질문, 대안 탐색 및 점진적 검증을 통해 거친 아이디어를 구체화된 설계로 발전시킵니다. 명확한 'Mechanical' 프로세스 중에는 사용하지 마십시오.
.NET 코드에서 정적 분석(Static analysis), 보안 스캔(Security scan) 및 종속성 체크(Dependency check)를 수행합니다. 코드 품질, 보안 감사 또는 취약점 탐지가 포함된 작업에서 사용합니다.
dotnet format, prettier 및 기타 포맷팅 도구를 사용하여 코드를 정리합니다. 코드 스타일 수정, 포맷 일관성 유지 또는 커밋 전 코드 준비가 필요한 작업에서 사용합니다.
보안 스캔, 품질 지표 및 모범 사례 분석을 포함한 자동화된 코드 리뷰입니다. 다음을 위한 코드 리뷰 시 사용합니다: (1) 보안 취약점 및 일반적인 공격 벡터, (2) 코드 품질 이슈 및 유지보수 문제, (3) 성능 병목 현상 및 최적화 기회, (4) 모범 사례 및 디자인 패턴, (5) 테스트 커버리지 및 테스트 전략, (6) 문서 품질 및 완전성
.NET/C#의 코딩 규약, 명명 규칙, 레이아웃, C# 12/13/14의 최신 기능 활용 가이드라인을 정의합니다. C#/.NET 코드 작성 시, 클래스·메서드 명명 시, 코드 포맷팅 시, 또는 사용자가 코딩 규약, 명명 규칙, C# 모범 사례, Primary Constructors, Collection Expressions, field 키워드에 대해 언급했을 때 사용합니다.