이 저장소는 AI 시대에 개발자가 알아야 할 인프라 구성 배포 with 클로드 코드 책의 실습을 위한 코드를 제공합니다.
Claude Code와 함께 GKE 위에서 SMB → Enterprise 수준의 배포 파이프라인을 구축하고, 그 과정에서 자연스럽게 살아있는 운영 표준(GitAIOps)을 만들어갑니다.
├── ch1~ch9/ # 장별 요약 (README.md)
├── apx/ # 부록 (부록A: 온보딩 가이드, 부록B: 대규모 프로젝트)
├── decision-guides/ # 도구 선택 가이드: "뭐 쓰면 돼?", "비교해줘" 시 참조
├── prompt-guardrails/ # 실행 가드레일: "설치해줘", "진행해줘" 시 참조
├── result-templates/ # 검증 체크리스트: 실행 후 결과 대조용
├── CLAUDE.md # Claude Code 동작 규칙: clone 후 자동 적용
├── AGENTS.md # Codex CLI 한정 차이점 어댑터
├── GEMINI.md # Gemini CLI 한정 차이점 어댑터
└── README.md
이 저장소를 clone한 디렉터리에서 Claude Code를 실행하면, CLAUDE.md가 자동으로 로드됩니다. 이후 자연어로 질문하면 3단계 흐름이 동작합니다:
- 탐색: "뭘 쓰면 돼?" →
decision-guides/참조하여 추천 + 이유 설명 - 비교: "비교해줘" →
decision-guides/비교 섹션으로 대안 비교 - 실행: "설치해줘" →
prompt-guardrails/지침대로 작업 수행 →result-templates/로 검증
| 구간 | 장 | 내용 | 스토리 |
|---|---|---|---|
| 도입 | ch1 | AI 시대, 개발자의 인프라 | 왜 개발자가 인프라를 알아야 하는가 |
| 기반 | ch2 | 환경 구성과 첫 서비스 배포 | 스타트업 창업, 첫 서비스 배포 |
| SMB | ch3 | 첫 번째 배포 파이프라인 | 배포할 때마다 긴장된다 → GitOps + CI 자동화 |
| SMB | ch4 | 관측 가능성 한번에 구축하기 | 새벽에 고객이 "안 된다"고 연락 → 관측 가능성 구축 |
| SMB | ch5 | 무중단 배포 | 배포할 때마다 끊긴다 → Gateway API + 무중단 배포 |
| 전환기 | ch6 | Enterprise를 위한 기반 정비 | 고객이 늘면서 느려지고, 보안도 허술 → 캐시, 시크릿, Canary |
| Enterprise | ch7 | 규모 확장 | 대형 고객사 계약! → 인프라 확장과 테넌트 분리 |
| Enterprise | ch8 | 고도화 | 서비스 간 호출이 꼬인다 → 이벤트 드리븐, 트레이싱, 배치 자동화 |
| 종합 | ch9 | GitAIOps: 살아있는 운영 표준 | 돌아보니, 이 모든 기록이 운영 표준이 되어 있었다 |
| 부록 | 부록A | AI로 만든 온보딩 가이드 | 9.3에서 언급한 온보딩 문서 생성 예시 |
| 부록 | 부록B | AI와 함께 설계하는 대규모 프로젝트 | 대규모 프로젝트에서의 문서 체계 확장 |
이 책은 Claude Code를 기준으로 쓰였지만, 같은 가드레일 시스템이 다른 AI 에이전트에서도 동작합니다.
| 에이전트 | 진입점 파일 | 실행 명령 |
|---|---|---|
| Claude Code (기준) | CLAUDE.md (자동 로드) |
claude --dangerously-skip-permissions |
| Codex CLI | AGENTS.md |
codex --full-auto --sandbox danger-full-access |
| Gemini CLI | GEMINI.md |
gemini --yolo --model gemini-2.5-pro |
각 어댑터 파일에는 해당 에이전트의 제약과 차이점만 담겨 있습니다. decision-guides/, prompt-guardrails/, result-templates/ 세 디렉터리는 어느 에이전트에서나 동일하게 동작합니다.
이 저장소는 가이드 저장소입니다. 독자는 notiflex-platform 이름으로 자신의 실습 저장소를 직접 생성합니다. 저자가 완성한 GitAIOps 플랫폼의 구조와 상태는 아래에서 확인할 수 있습니다.
본 도서의 쇄(edition)별 정정 사항은 Releases에서 확인하실 수 있습니다.
✔️ 조 훈 ( GitHub · LinkedIn · YouTube · Tech Blog )
본 도서는 각 온오프라인 서점에서 만나보실 수 있습니다. (ISBN 979-11-407-1917-4)