File contents Docker Commands Skill
ICJC 프로젝트의 Docker 서비스 관리를 위한 스킬입니다.
다음 키워드나 상황에서 이 스킬을 사용하세요:
"docker", "make", "컨테이너", "서비스", "재시작", "로그"
"백엔드 재시작", "프론트엔드 재시작", "빌드"
"컨테이너 접속", "로그 확인", "서비스 상태"
의존성 순서: MongoDB (27017) → Redis (6379) → Backend (8000) → Agent Gateway (8100→8080) → Frontend (3000)
서비스
컨테이너명
외부포트
내부포트
설명
mongodb-primary
mongodb-primary-dev
27017
27017
MongoDB Atlas Local
redis
redis-dev
6379
6379
Redis 캐시
backend
backend-dev
8000
8000
FastAPI 백엔드
agent-multi-gateway
agent-multi-gateway-dev
8100
8080
AI Agent Gateway
frontend
frontend-dev
3000
3000
Next.js 프론트엔드
빠른 시작
명령어
설명
사용 시점
make build전체 빌드 및 실행
첫 실행, 의존성 변경
make all빌드 없이 실행
이미 빌드된 상태
make devDocker Watch 개발 모드
개발 중
개별 서비스
명령어
설명
영향 범위
make backend백엔드 + Agent 재시작
DB/Frontend 유지
make frontend프론트엔드 재시작 (dev)
Frontend만
make frontend-prod프론트엔드 (prod)
Frontend만
make agentAgent Gateway만 실행
Agent만
make agents모든 Agent 재빌드
Agent 전체
make agents-light모든 Agent 재시작 (빌드X)
Agent 전체
make re-app앱 컨테이너만 재시작
DB 유지
로그
명령어
대상
make logs전체
make logs-backend백엔드
make logs-frontend프론트엔드
make logs-agentAgent Gateway
make logs-mongoMongoDB 초기화
docker logs -f backend-dev백엔드 (직접)
docker logs -f --tail 100 frontend-dev프론트엔드 최근 100줄
컨테이너 접근
명령어
대상
docker exec -it backend-dev bash백엔드
docker exec -it frontend-dev sh프론트엔드
docker exec -it mongodb-primary-dev mongoshMongoDB
docker exec -it agent-multi-gateway-dev bashAgent
클린업
명령어
설명
주의
make down컨테이너 중지 + 볼륨 삭제
데이터 유지됨
make fcleandown + 이미지/네트워크 정리
make purge모든 Docker 리소스 제거
매우 주의
MongoDB 관리
명령어
설명
make mongoMongoDB 레플리카셋 테스트
make mongo-resetMongoDB 완전 초기화 (데이터 삭제!)
make mongo-backup-devDev DB 백업
make mongo-restore백업 복원
make mongo-sync-dev백업 → 복원
make mongo-rebuild초기화 + 재시작 + 복원
문제 해결
명령어
설명
make fix-permissions파일 권한 문제 해결
make frontend-fix-next-perms.next 볼륨 권한 수정
make mem-watch메모리 모니터링
변수
기본값
설명
FRONTEND_MODE
development
프론트엔드 모드
USER_ID
$(id -u)
컨테이너 사용자 ID
GROUP_ID
$(id -g)
컨테이너 그룹 ID
# 프로덕션 모드로 빌드
make build FRONTEND_MODE=production
코드 변경 후 테스트
백엔드 변경 : make backend (빠른 재시작)프론트엔드 변경 : Hot reload 자동 적용 (재시작 불필요)Agent 변경 : make agents-light (빌드 없이 재시작)의존성 변경 : make build (전체 재빌드)
문제 발생 시
로그 확인: make logs-backend 또는 make logs-frontend
컨테이너 상태: docker ps
앱만 재시작: make re-app
그래도 안되면: make down && make build
깨끗한 환경으로 시작
make fclean && make build
명령어 실행 전 상황 파악 : 사용자가 원하는 작업을 정확히 이해하고, 최소한의 영향을 주는 명령어를 선택하세요.DB 보존 우선 : 가능하면 DB를 유지하는 명령어 (make backend, make re-app)를 먼저 시도하세요.로그 확인 습관화 : 서비스 재시작 후 반드시 로그를 확인하여 정상 동작을 검증하세요.purge 사용 주의 : make purge는 모든 Docker 리소스를 삭제합니다. 사용자에게 경고하세요.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1 --- 2 name: donggyun112-ai-librarian-docker-commands 3 description: Docker Commands Skill 4 --- 5 6 # Docker Commands Skill 7 8 ICJC 프로젝트의 Docker 서비스 관리를 위한 스킬입니다. 9 10 <trigger_conditions> 11 ## 사용 시점 12 13 다음 키워드나 상황에서 이 스킬을 사용하세요: 14 - "docker", "make", "컨테이너", "서비스", "재시작", "로그" 15 - "백엔드 재시작", "프론트엔드 재시작", "빌드" 16 - "컨테이너 접속", "로그 확인", "서비스 상태" 17 </trigger_conditions> 18 19 <service_architecture> 20 ## 서비스 아키텍처 21 22 **의존성 순서:** MongoDB (27017) → Redis (6379) → Backend (8000) → Agent Gateway (8100→8080) → Frontend (3000) 23 24 | 서비스 | 컨테이너명 | 외부포트 | 내부포트 | 설명 | 25 |--------|-----------|---------|---------|------| 26 | mongodb-primary | mongodb-primary-dev | 27017 | 27017 | MongoDB Atlas Local | 27 | redis | redis-dev | 6379 | 6379 | Redis 캐시 | 28 | backend | backend-dev | 8000 | 8000 | FastAPI 백엔드 | 29 | agent-multi-gateway | agent-multi-gateway-dev | 8100 | 8080 | AI Agent Gateway | 30 | frontend | frontend-dev | 3000 | 3000 | Next.js 프론트엔드 | 31 </service_architecture> 32 33 <commands> 34 ## 명령어 레퍼런스 35 36 ### 빠른 시작 37 | 명령어 | 설명 | 사용 시점 | 38 |--------|------|----------| 39 | `make build` | 전체 빌드 및 실행 | 첫 실행, 의존성 변경 | 40 | `make all` | 빌드 없이 실행 | 이미 빌드된 상태 | 41 | `make dev` | Docker Watch 개발 모드 | 개발 중 | 42 43 ### 개별 서비스 44 | 명령어 | 설명 | 영향 범위 | 45 |--------|------|----------| 46 | `make backend` | 백엔드 + Agent 재시작 | DB/Frontend 유지 | 47 | `make frontend` | 프론트엔드 재시작 (dev) | Frontend만 | 48 | `make frontend-prod` | 프론트엔드 (prod) | Frontend만 | 49 | `make agent` | Agent Gateway만 실행 | Agent만 | 50 | `make agents` | 모든 Agent 재빌드 | Agent 전체 | 51 | `make agents-light` | 모든 Agent 재시작 (빌드X) | Agent 전체 | 52 | `make re-app` | 앱 컨테이너만 재시작 | DB 유지 | 53 54 ### 로그 55 | 명령어 | 대상 | 56 |--------|------| 57 | `make logs` | 전체 | 58 | `make logs-backend` | 백엔드 | 59 | `make logs-frontend` | 프론트엔드 | 60 | `make logs-agent` | Agent Gateway | 61 | `make logs-mongo` | MongoDB 초기화 | 62 | `docker logs -f backend-dev` | 백엔드 (직접) | 63 | `docker logs -f --tail 100 frontend-dev` | 프론트엔드 최근 100줄 | 64 65 ### 컨테이너 접근 66 | 명령어 | 대상 | 67 |--------|------| 68 | `docker exec -it backend-dev bash` | 백엔드 | 69 | `docker exec -it frontend-dev sh` | 프론트엔드 | 70 | `docker exec -it mongodb-primary-dev mongosh` | MongoDB | 71 | `docker exec -it agent-multi-gateway-dev bash` | Agent | 72 73 ### 클린업 74 | 명령어 | 설명 | 주의 | 75 |--------|------|------| 76 | `make down` | 컨테이너 중지 + 볼륨 삭제 | 데이터 유지됨 | 77 | `make fclean` | down + 이미지/네트워크 정리 | | 78 | `make purge` | 모든 Docker 리소스 제거 | **매우 주의** | 79 80 ### MongoDB 관리 81 | 명령어 | 설명 | 82 |--------|------| 83 | `make mongo` | MongoDB 레플리카셋 테스트 | 84 | `make mongo-reset` | MongoDB 완전 초기화 (데이터 삭제!) | 85 | `make mongo-backup-dev` | Dev DB 백업 | 86 | `make mongo-restore` | 백업 복원 | 87 | `make mongo-sync-dev` | 백업 → 복원 | 88 | `make mongo-rebuild` | 초기화 + 재시작 + 복원 | 89 90 ### 문제 해결 91 | 명령어 | 설명 | 92 |--------|------| 93 | `make fix-permissions` | 파일 권한 문제 해결 | 94 | `make frontend-fix-next-perms` | .next 볼륨 권한 수정 | 95 | `make mem-watch` | 메모리 모니터링 | 96 </commands> 97 98 <environment_variables> 99 ## 환경 변수 100 101 | 변수 | 기본값 | 설명 | 102 |------|--------|------| 103 | FRONTEND_MODE | development | 프론트엔드 모드 | 104 | USER_ID | $(id -u) | 컨테이너 사용자 ID | 105 | GROUP_ID | $(id -g) | 컨테이너 그룹 ID | 106 107 ```bash 108 # 프로덕션 모드로 빌드 109 make build FRONTEND_MODE=production 110 ``` 111 </environment_variables> 112 113 <workflows> 114 ## 일반적인 워크플로우 115 116 ### 코드 변경 후 테스트 117 1. **백엔드 변경**: `make backend` (빠른 재시작) 118 2. **프론트엔드 변경**: Hot reload 자동 적용 (재시작 불필요) 119 3. **Agent 변경**: `make agents-light` (빌드 없이 재시작) 120 4. **의존성 변경**: `make build` (전체 재빌드) 121 122 ### 문제 발생 시 123 1. 로그 확인: `make logs-backend` 또는 `make logs-frontend` 124 2. 컨테이너 상태: `docker ps` 125 3. 앱만 재시작: `make re-app` 126 4. 그래도 안되면: `make down && make build` 127 128 ### 깨끗한 환경으로 시작 129 ```bash 130 make fclean && make build 131 ``` 132 </workflows> 133 134 <instructions> 135 ## 이 스킬 사용 시 지침 136 137 1. **명령어 실행 전 상황 파악**: 사용자가 원하는 작업을 정확히 이해하고, 최소한의 영향을 주는 명령어를 선택하세요. 138 2. **DB 보존 우선**: 가능하면 DB를 유지하는 명령어 (`make backend`, `make re-app`)를 먼저 시도하세요. 139 3. **로그 확인 습관화**: 서비스 재시작 후 반드시 로그를 확인하여 정상 동작을 검증하세요. 140 4. **purge 사용 주의**: `make purge`는 모든 Docker 리소스를 삭제합니다. 사용자에게 경고하세요. 141 </instructions> 142 143 --- 144 > Converted and distributed by [TomeVault](https://tomevault.io/claim/donggyun112) — claim your Tome and manage your conversions. 145 <!-- tomevault:4.0:skill_md:2026-04-11 -->
commit 796a768d26
Frequently asked questions How do I install the Donggyun112 AI Librarian Docker Commands skill? Run npx skillmds@latest add tomevault-io/donggyun112-ai-librarian-docker-commands in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Donggyun112 AI Librarian Docker Commands skill do? Docker Commands Skill It is listed under DevOps & Infra on SkillMD.
Is Donggyun112 AI Librarian Docker Commands safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Donggyun112 AI Librarian Docker Commands? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Donggyun112 AI Librarian Docker Commands free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Donggyun112 AI Librarian Docker Commands? tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io