sysnet4admin/_Book_GitAIOps

< AI 시대에 개발자가 알아야 할 인프라 구성 배포 with 클로드 코드 >

26

stars

81

commits

Batchfile

primary language

Jun 13, 2026

updated

ai-ops
argocd
ci-cd
claude-code
cloud-native
devops
gitaiops
gitops
gke
grafana
infrastructure
korean-book
kubernetes
observability
prometheus

README

AI 시대에 개발자가 알아야 할 인프라 구성 배포 with 클로드 코드

한국어 | English



Claude Code AI Agent GitAIOps Go GKE Kubernetes
ArgoCD CI/CD Kafka OpenTelemetry Cloud Native

이 저장소는 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단계 흐름이 동작합니다:

  1. 탐색: "뭘 쓰면 돼?" → decision-guides/ 참조하여 추천 + 이유 설명
  2. 비교: "비교해줘" → decision-guides/ 비교 섹션으로 대안 비교
  3. 실행: "설치해줘" → prompt-guardrails/ 지침대로 작업 수행 → result-templates/로 검증

제공되는 챕터별 내용

구간내용스토리
도입ch1AI 시대, 개발자의 인프라왜 개발자가 인프라를 알아야 하는가
기반ch2환경 구성과 첫 서비스 배포스타트업 창업, 첫 서비스 배포
SMBch3첫 번째 배포 파이프라인배포할 때마다 긴장된다 → GitOps + CI 자동화
SMBch4관측 가능성 한번에 구축하기새벽에 고객이 "안 된다"고 연락 → 관측 가능성 구축
SMBch5무중단 배포배포할 때마다 끊긴다 → Gateway API + 무중단 배포
전환기ch6Enterprise를 위한 기반 정비고객이 늘면서 느려지고, 보안도 허술 → 캐시, 시크릿, Canary
Enterprisech7규모 확장대형 고객사 계약! → 인프라 확장과 테넌트 분리
Enterprisech8고도화서비스 간 호출이 꼬인다 → 이벤트 드리븐, 트레이싱, 배치 자동화
종합ch9GitAIOps: 살아있는 운영 표준돌아보니, 이 모든 기록이 운영 표준이 되어 있었다
부록부록AAI로 만든 온보딩 가이드9.3에서 언급한 온보딩 문서 생성 예시
부록부록BAI와 함께 설계하는 대규모 프로젝트대규모 프로젝트에서의 문서 체계 확장

다중 에이전트 지원

이 책은 Claude Code를 기준으로 쓰였지만, 같은 가드레일 시스템이 다른 AI 에이전트에서도 동작합니다.

에이전트진입점 파일실행 명령
Claude Code (기준)CLAUDE.md (자동 로드)claude --dangerously-skip-permissions
Codex CLIAGENTS.mdcodex --full-auto --sandbox danger-full-access
Gemini CLIGEMINI.mdgemini --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)

Contributors

sysnet4admin

81 commits

sysnet4admin/_Book_GitAIOps

< AI 시대에 개발자가 알아야 할 인프라 구성 배포 with 클로드 코드 >

26

stars

81

commits

Batchfile

primary language

Jun 13, 2026

updated

ai-ops
argocd
ci-cd
claude-code
cloud-native
devops
gitaiops
gitops
gke
grafana
infrastructure
korean-book
kubernetes
observability
prometheus

README

AI 시대에 개발자가 알아야 할 인프라 구성 배포 with 클로드 코드

한국어 | English



Claude Code AI Agent GitAIOps Go GKE Kubernetes
ArgoCD CI/CD Kafka OpenTelemetry Cloud Native

이 저장소는 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단계 흐름이 동작합니다:

  1. 탐색: "뭘 쓰면 돼?" → decision-guides/ 참조하여 추천 + 이유 설명
  2. 비교: "비교해줘" → decision-guides/ 비교 섹션으로 대안 비교
  3. 실행: "설치해줘" → prompt-guardrails/ 지침대로 작업 수행 → result-templates/로 검증

제공되는 챕터별 내용

구간내용스토리
도입ch1AI 시대, 개발자의 인프라왜 개발자가 인프라를 알아야 하는가
기반ch2환경 구성과 첫 서비스 배포스타트업 창업, 첫 서비스 배포
SMBch3첫 번째 배포 파이프라인배포할 때마다 긴장된다 → GitOps + CI 자동화
SMBch4관측 가능성 한번에 구축하기새벽에 고객이 "안 된다"고 연락 → 관측 가능성 구축
SMBch5무중단 배포배포할 때마다 끊긴다 → Gateway API + 무중단 배포
전환기ch6Enterprise를 위한 기반 정비고객이 늘면서 느려지고, 보안도 허술 → 캐시, 시크릿, Canary
Enterprisech7규모 확장대형 고객사 계약! → 인프라 확장과 테넌트 분리
Enterprisech8고도화서비스 간 호출이 꼬인다 → 이벤트 드리븐, 트레이싱, 배치 자동화
종합ch9GitAIOps: 살아있는 운영 표준돌아보니, 이 모든 기록이 운영 표준이 되어 있었다
부록부록AAI로 만든 온보딩 가이드9.3에서 언급한 온보딩 문서 생성 예시
부록부록BAI와 함께 설계하는 대규모 프로젝트대규모 프로젝트에서의 문서 체계 확장

다중 에이전트 지원

이 책은 Claude Code를 기준으로 쓰였지만, 같은 가드레일 시스템이 다른 AI 에이전트에서도 동작합니다.

에이전트진입점 파일실행 명령
Claude Code (기준)CLAUDE.md (자동 로드)claude --dangerously-skip-permissions
Codex CLIAGENTS.mdcodex --full-auto --sandbox danger-full-access
Gemini CLIGEMINI.mdgemini --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)

Contributors

sysnet4admin

81 commits

Languages

Batchfile

100.0%