---

name: docker-commands description: "ICJC Docker 서비스 관리 및 Make 명령어. Use when: (1) docker, make, 컨테이너, 서비스, 재시작, 로그 관련 요청, (2) 백엔드/프론트엔드/에이전트 재시작, (3) 빌드, 컨테이너 접속, 로그 확인, 서비스 상태 확인 필요시."

Docker Commands Skill

ICJC 프로젝트의 Docker 서비스 관리를 위한 스킬입니다.

<trigger_conditions>

사용 시점

다음 키워드나 상황에서 이 스킬을 사용하세요:

• "docker", "make", "컨테이너", "서비스", "재시작", "로그"
• "백엔드 재시작", "프론트엔드 재시작", "빌드"
• "컨테이너 접속", "로그 확인", "서비스 상태" </trigger_conditions>

<service_architecture>

서비스 아키텍처

의존성 순서: MongoDB (27017) → Redis (6379) → Backend (8000) → Agent Gateway (8100→8080) → Frontend (3000)

빠른 시작

개별 서비스

로그

컨테이너 접근

클린업

MongoDB 관리

문제 해결

<environment_variables>

환경 변수

Copy# 프로덕션 모드로 빌드
make build FRONTEND_MODE=production

</environment_variables>

코드 변경 후 테스트

1. 백엔드 변경: make backend (빠른 재시작)
2. 프론트엔드 변경: Hot reload 자동 적용 (재시작 불필요)
3. Agent 변경: make agents-light (빌드 없이 재시작)
4. 의존성 변경: make build (전체 재빌드)

문제 발생 시

1. 로그 확인: make logs-backend 또는 make logs-frontend
2. 컨테이너 상태: docker ps
3. 앱만 재시작: make re-app
4. 그래도 안되면: make down && make build

깨끗한 환경으로 시작

Copymake fclean && make build

1. 명령어 실행 전 상황 파악: 사용자가 원하는 작업을 정확히 이해하고, 최소한의 영향을 주는 명령어를 선택하세요.
2. DB 보존 우선: 가능하면 DB를 유지하는 명령어 (make backend, make re-app)를 먼저 시도하세요.
3. 로그 확인 습관화: 서비스 재시작 후 반드시 로그를 확인하여 정상 동작을 검증하세요.
4. purge 사용 주의: make purge는 모든 Docker 리소스를 삭제합니다. 사용자에게 경고하세요.