자연어로 구축하고 운영하는 AI 네이티브 시대의 첫 인프라 실습서!

가상의 스타트업 Notiflex가 창업하는 순간부터 엔터프라이즈 규모까지 성장하는 여정을 따라 클로드 코드로 직접 구현해보면서 학습한다!

 

바이브 코딩이 ‘자연어로 코드를 만드는’ 흐름을 열었다면, 이 책은 '자연어로 인프라를 구축하고 운영하는 방법'을 소개한다. 자연어로 내린 지시가 깃에 선언으로 기록되고, 그 선언이 실제 인프라에 반영되도록 하여 '말이 곧 인프라가 되는 시대'의 새로운 업무 방식인 GitAIOps를 경험할 수 있다. 클로드 코드를 활용해 클라우드 네이티브 환경에서 인프라를 설계하고 구축하며, 배포하고 운영하는 전 과정을 실습 중심으로 다룬다. 가상의 스타트업 Notiflex가 성장하는 여정을 따라가며, 이 과정에서 다양한 핵심 기술을 자연스럽게 익힐 수 있다. 또한 AI를 단순한 자동화 도구가 아닌 학습 파트너로 활용해 문제를 탐색하고, 비교하고, 검증하는 새로운 학습 방식을 제시한다. 인프라를 완벽히 알고 시작할 필요 없이 직접 배포하고 질문하며 답을 확인하는 과정을 통해 실무 감각을 익힐 수 있도록 설계했다. 기술 자체보다는 AI 시대에 필요한 ‘일하는 감각'과 '질문하는 감각’을 키우도록 돕는 것이 이 책의 목표이다. AI 시대에 경쟁력을 갖춘 개발자와 인프라 엔지니어로 성장하고 싶은 분들에게 든든한 길잡이가 되어줄 것이다.

• 완성된 플랫폼 보기: https://github.com/sysnet4admin/notiflex-platform

[목 차]
  

1장. AI 시대, 개발자의 인프라

1.1 개발자에게 인프라가 다가온 시대

__1.1.1 DevOps 문화의 확산

__1.1.2 클라우드 네이티브 전환

__1.1.3 풀스택의 범위 확장

1.2 쿠버네티스, 클라우드 인프라의 공통 언어

__1.2.1 왜 쿠버네티스인가

__1.2.2 가파른 학습 곡선

__1.2.3 AI라는 새로운 동료

1.3 GitOps에서 GitAIOps로

__1.3.1 GitOps: 선언적 관리의 시작

__1.3.2 GitOps만으로는 부족한 이유

__1.3.3 AI가 채우는 빈자리

__1.3.4 GitAIOps: Git + AI + Ops

1.4 이 책의 구성과 실습 흐름

__1.4.1 이 책의 흐름

__1.4.2 실습 환경

__1.4.3 이 책의 저장소

1.5 Notiflex 스타트업 시나리오 소개

__1.5.1 Notiflex란?

__1.5.2 성장 타임라인

__1.5.3 여러분의 역할

1.6 가드레일: 클로드 코드가 정확하게 동작하는 이유

__1.6.1 CLAUDE.md와 가드레일

__1.6.2 3단계 흐름: 탐색 → 비교 → 실행

__1.6.3 왜 가드레일이 필요한가

 

2장. 환경 구성

2.1 GCP 계정 생성과 무료 크레딧 활용 전략

__2.1.1 계정 생성

2.2 클로드 코드 설치

__2.2.1 클로드 코드 요금제

__2.2.2 클로드 코드 설치

__2.2.3 클로드 코드 첫 실행과 인사

__2.2.4 statusline 설정하기

2.3 gcloud CLI 설치

__2.3.1 gcloud CLI 설치와 인증

__2.3.2 GCP 인증

__2.3.3 프로젝트 및 리전 설정

__2.3.4 Artifact Registry 인증 설정

2.4 깃허브 저장소 구성

2.5 GKE 클러스터 생성

__2.5.1 클러스터 생성

__2.5.2 kubeconfig 설정

__2.5.3 클러스터 상태 확인

2.6 Notiflex 앱 빌드와 배포

__2.6.1 Go API 서버 작성

__2.6.2 Dockerfile 작성

__2.6.3 빌드와 푸시

__2.6.4 쿠버네티스 매니페스트 생성

__2.6.5 배포와 동작 확인

2.7 깃허브에 첫 커밋

__2.7.1 JOURNEY.md 생성

__2.7.2 커밋과 푸시

2.8 마무리: /update-docs 스킬 만들기

2.9 2장 가드레일 살펴보기

 

3장. 첫 번째 배포 파이프라인

3.1 푸시 기반 배포의 한계

__3.1.1 클러스터에 무엇이 있는지 확신할 수 있는가

__3.1.2 명령형 vs 선언형: 사고 방식이 다르다

3.2 ArgoCD 설치 및 GitOps 연결

__3.2.1 클로드 코드에게 배포 자동화 도구 물어보기

__3.2.2 다른 도구는 없는지 비교해보기

__3.2.3 ArgoCD 설치하기

__3.2.4 깃 저장소 연결하기

3.3 ArgoCD로 롤링 업데이트: 깃 푸시만으로 배포

__3.3.1 새 기능 추가 및 배포

__3.3.2 롤백 테스트

3.4 깃허브 액션 CI: 빌드 자동화

__3.4.1 아직 남은 수동 작업

__3.4.2 깃허브 액션 CI 만들기

3.5 CI + ArgoCD 연결: 빌드부터 배포까지

__3.5.1 마지막 빠진 조각

__3.5.2 연결하기

__3.5.3 전체 파이프라인 테스트

3.6 마무리: CLAUDE.md에 행동 규칙 추가하기

3.7 3장 가드레일 살펴보기

 

4장. 관측 가능성 한 번에 구축하기

4.1 관측 가능성이란

4.2 메트릭 모니터링: 프로메테우스 + 그라파나

__4.2.1 클로드 코드에게 메트릭 수집과 시각화 도구 물어보기

__4.2.2 다른 도구는 없는지 비교해보기

__4.2.3 프로메테우스 + 그라파나 설치하기

__4.2.4 그라파나에 접속하기

__4.2.5 프로메테우스 메트릭 확인하기

4.3 로그 수집: Loki + Fluent Bit

__4.3.1 클로드 코드에게 로그 수집 도구 물어보기

__4.3.2 다른 도구는 없는지 비교해보기

__4.3.3 Loki + Fluent Bit 설치하기

__4.3.4 그라파나에서 로그 확인하기

4.4 알림 설정: PrometheusRule

__4.4.1 클로드 코드에게 알림 도구 물어보기

__4.4.2 다른 방식은 없는지 비교해보기

__4.4.3 알림 규칙 만들기

__4.4.4 알림 규칙 확인하기

4.5 마무리: 메모리에 작업 컨텍스트 기록

4.6 4장 가드레일 살펴보기

 

5장. 무중단 배포

5.1 Rolling Update는 왜 서비스가 끊기는가

5.2 외부 트래픽 관리: Gateway API

__5.2.1 클로드 코드에게 트래픽 관리 도구 물어보기

__5.2.2 다른 도구는 없는지 비교해보기

__5.2.3 Gateway API 설정하기

5.3 무중단 전환: Blue/Green 배포

__5.3.1 클로드 코드에게 무중단 배포 도구 물어보기

__5.3.2 다른 도구는 없는지 비교해보기

__5.3.3 Blue/Green 배포 설정하기

__5.3.4 v0.2.0 배포하고 전환 과정 지켜보기

5.4 마무리: 아키텍처 결정 기록하기

5.5 5장 가드레일 살펴보기

 

6장. 엔터프라이즈를 위한 기반 정비

6.1 Pod 간 상태 공유: Valkey 캐시

__6.1.1 클로드 코드에게 캐시 도구 물어보기

__6.1.2 다른 도구는 없는지 비교해보기

__6.1.3 Valkey 설치하고 앱 연동하기

6.2 시크릿 관리: Google Secret Manager

__6.2.1 클로드 코드에게 시크릿 관리 방법 물어보기

__6.2.2 다른 도구는 없는지 비교해보기

__6.2.3 Secret Manager 설정하기

6.3 점진적 배포: Canary

__6.3.1 클로드 코드에게 더 안전한 배포 방법 물어보기

__6.3.2 다른 도구는 없는지 비교해보기

__6.3.3 Canary 배포 설정하기

6.4 마무리: claude-context/로 현재 아키텍처 정리하기

6.5 6장 가드레일 살펴보기

 

7장. 규모 확장

7.1 성장통: SMB 구조의 한계

7.2 워크로드별 노드 배치: 멀티 노드풀

__7.2.1 클로드 코드에게 노드 분리 방법 물어보기

__7.2.2 다른 도구는 없는지 비교해보기

__7.2.3 멀티 노드풀 생성하기

7.3 다수 앱 관리: App of Apps 패턴 + Sync Wave

__7.3.1 클로드 코드에게 여러 앱 관리 방법 물어보기

__7.3.2 다른 도구는 없는지 비교해보기

__7.3.3 App of Apps 패턴 적용하기

__7.3.4 Sync Wave로 설치 순서 정하기

7.4 멀티 테넌시: 네임스페이스 격리

__7.4.1 클로드 코드에게 멀티 테넌시 방법 물어보기

__7.4.2 다른 도구는 없는지 비교해보기

__7.4.3 멀티 테넌시 구성하기

7.5 마무리: settings.local.json으로 권한 분리 체험

__7.5.1 자연어 규칙의 한계

__7.5.2 settings.local.json 만들기

__7.5.3 차단(deny) 체험

__7.5.4 승인(ask) 체험

__7.5.5 CLAUDE.md에서 settings.local.json으로

__7.5.6 체험 정리

7.6 7장 가드레일 살펴보기

 

8장. 고도화

8.1 이벤트 드리븐: 카프카

__8.1.1 클로드 코드에게 메시지 큐 물어보기

__8.1.2 다른 도구는 없는지 비교해보기

__8.1.3 카프카를 설치하고 이벤트 드리븐 구성하기

8.2 분산 트레이싱: 템포

__8.2.1 클로드 코드에게 분산 트레이싱 도구 물어보기

__8.2.2 다른 도구는 없는지 비교해보기

__8.2.3 템포 설치하고 트레이싱 설정하기

8.3 배치 자동화: 크론잡

__8.3.1 클로드 코드에게 주기적 작업 방법 물어보기

__8.3.2 크론잡 생성하기

8.4 마무리: command-guardrails/로 위험 작업 절차 정리

__8.4.1 시스템이 복잡해지면

__8.4.2 command-guardrails/ 작성

__8.4.3 7장 settings.local.json 체험과의 비교

8.5 8장 가드레일 살펴보기

 

9장. GitAIOps, 살아있는 운영 표준의 탄생

9.1 AI에게 저장소 분석시키기

__9.1.1 저장소 구조 분석

__9.1.2 커밋 히스토리 분석

__9.1.3 클러스터 현재 상태

9.2 쌓인 것들을 돌아보기

__9.2.1 도구 선택 의사결정 종합

__9.2.2 자원 사용 현황과 의사결정 회고

9.3 기대하지 않았던 효과

__9.3.1 살아있는 문서

__9.3.2 사람이 보는 문서, AI가 읽는 문서

__9.3.3 이 구조가 만들어내는 것

9.4 GitAIOps의 출현

__9.4.1 Git + AI + Ops 연결 분석

__9.4.2 GitOps와의 차이

__9.4.3 작위적이지 않다

__9.4.4 진행 방향에 따라 달라지는 구조

9.5 마무리: 다음 단계

__9.5.1 프로덕션 전환 제안

__9.5.2 AI와 대화하는 습관

__9.5.3 다시 처음부터

9.6 9장 가드레일 살펴보기

 

부록 A. AI로 만든 온보딩 가이드

 

부록 B. AI와 함께 설계하는 대규모 프로젝트

B.1.1 전체 흐름

B.1.2 1단계: 사람이 읽는 계획서(work-plans)

B.1.3 2단계: AI가 읽을 수 있게 증류한다(claude-context)

B.1.4 3단계: 실행 절차를 고정한다

B.1.5 4~5단계: DEV에서 PROD로

B.1.6 조직 도입 로드맵

[본 문]
  

“이제는 코드뿐 아니라 인프라를 설계하고, 배포하고, 운영하고, 성장시키는 전 과정을 인공지능 에이전트와 함께 다룰 수 있는 시대가 되었습니다. 바이브 코딩이 ‘자연어로 코드를 만드는’ 흐름을 열었다면, 이 책은 인프라를 자연어로 다루기 위한 기반을 소개합니다. 바로 GitAIOps입니다. 자연어로 내린 지시가 깃(Git)에 선언으로 기록되고, 그 선언이 실제 인프라에 반영됩니다. ‘말이 곧 인프라가 되는 시대’의 배포 운영 방식입니다.

이 책은 인프라를 완전히 알고 시작해야 하는 책이 아닙니다. 오히려 독자가 직접 배포하고, 그 과정에서 생긴 궁금증을 클로드 코드에게 묻고, 답을 확인하면서 진행하는 방식으로 설계했습니다. 기술 자체를 가르치기보다, AI 시대에 맞는 ‘일하는 감각과 질문하는 감각’이 독자의 것이 되도록 돕는 것이 이 책의 목표입니다.”

-지은이의 말 중에서-

 

이 책은 ‘인프라 실습을 AI 튜터와 함께하도록 설계된 첫 책’으로, ‘인프라를 자연어로 다루기 위한 기반’을 소개합니다. 독자가 직접 배포하고, 그 과정에서 생긴 궁금증을 클로드 코드에게 묻고, 답을 확인하면서 진행하도록 설계했습니다. 기술 자체를 가르치기보다, AI 시대에 맞는 ‘일하는 감각과 질문하는 감각’이 독자 여러분의 것이 되도록 돕는 것이 이 책의 목표입니다.

 

이 책은 총 9개 장과 2개의 부록으로 구성되어 있으며, 가상의 스타트업 Notiflex가 창업하는 순간부터 엔터프라이즈 규모까지 성장하는 여정을 따라갑니다. 각 장에서 다루는 내용은 다음과 같으며, 이전 장의 결과물 위에 다음 장이 쌓이는 구조이므로, 순서대로 진행하는 것을 권합니다.

 

• 1장. AI 시대, 개발자의 인프라: 인프라가 개발자의 일상이 된 배경을 살펴보고, 쿠버네티스와 GitOps가 자리잡은 흐름을 짚어봅니다. GitAIOps가 등장한 이유와 이 책에서 함께 만들어갈 Notiflex 시나리오, 가드레일 시스템을 소개합니다.

 

• 2장. 환경 구성: GCP 계정과 무료 크레딧을 소개하고, 클로드 코드와 gcloud CLI를 설치합니다. 이어서 깃허브 저장소 구성 및 GKE 클러스터를 생성해보고, Notiflex 앱을 빌드하고 배포합니다.

 

• 3장. 첫 번째 배포 파이프라인: 수동 배포 방식의 한계를 확인하고, ArgoCD로 GitOps를 연결해 Rolling Update를 실습합니다. 이어서 깃허브 액션으로 CI를 구성하고, CI와 ArgoCD를 연결해 코드 변경부터 배포까지 이어지는 파이프라인을 완성합니다.

 

• 4장. 관측 가능성 한 번에 구축하기: 프로메테우스와 그라파나로 메트릭을 수집하고 시각화하며, Loki와 Fluent Bit로 로그를 통합합니다. 그리고 PrometheusRule로 알림 규칙을 설정해 이상 상황을 자동으로 감지합니다.

 

• 5장. 무중단 배포: Gateway API로 외부 트래픽 진입점을 만들고, Argo Rollouts를 활용해 Blue/Green 배포 전략을 적용합니다. 배포 중에도 서비스가 끊기지 않는 구조를 완성합니다.

• 6장. 엔터프라이즈를 위한 기반 정비: Valkey로 캐시를 도입하고, Google Secret Manager와 연동해 시크릿을 안전하게 관리합니다. Canary 배포로 트래픽을 점진적으로 전환하는 방법도 경험합니다.

 

• 7장. 규모 확장: 멀티 노드풀로 워크로드를 역할별로 분리하고, App of Apps 패턴과 Sync Wave로 여러 애플리케이션을 체계적으로 관리합니다. 네임스페이스 기반 멀티 테넌시로 팀별 격리 환경도 구성합니다.

 

• 8장. 고도화: 카프카로 이벤트 드리븐 아키텍처를 도입하고, 템포로 분산 트레이싱을 구성합니다. 크론잡으로 주기적인 배치 작업도 자동화합니다.

 

• 9장. GitAIOps: 살아있는 운영 표준의 탄생: 8장까지 만든 저장소를 분석하고 전체 여정을 돌아봅니다. 기대하지 않았던 효과를 짚어보고, Git, AI, Ops가 결합한 GitAIOps의 출현을 확인한 뒤, 다음 단계로 나아갈 방향을 제안합니다.

 

• 부록 A. AI로 만든 온보딩 가이드: “온보딩 문서 만들어줘” 한 마디로 AI가 현재 클러스터 상태를 분석하고, 새 팀원이 바로 활용할 수 있는 가이드를 자동으로 생성합니다. 그 과정과 결과물을 담았습니다.

 

• 부록 B. AI와 함께 설계하는 대규모 프로젝트: 전면 재설계나 대규모 마이그레이션처럼 전체 그림을 먼저 그려야 할 때, 사람이 계획을 세우고 AI가 정확히 실행하도록 구조를 설계하는 방법을 소개합니다. 이 책과는 반대 방향에서 AI와 협업하는 흐름을 살펴봅니다.

-들어가며 중에서-

문성주 (데이터 플랫폼 엔지니어(실습 환경: macOS / ARM64))

인프라를 구성하는 것은 크게 설계와 구현으로 나눌 수 있습니다. 최근 AI, LLM, 에이전틱 도구와 더불어 클라우드 및 SaaS를 이용해 인프라를 매우 빠르게 설계하고 구축할 수 있게 되었습니다. 하지만 역설적으로 이런 도구들을 사용하여 인프라를 구성하다 보니 최종 결과물이 제대로 구축되었는지 판단하기 위해서는 각 도구들의 장/단점들을 모두 알아야 합니다. AI 시대가 되어도 사람이 평가하고 책임지는 구조에는 변함이 없기 때문입니다.

이런 관점에서 이 책은 AI를 활용해 실제 현업과 동일한 인프라를 구축하고 이를 확장하는 경험을 체험할 수 있어, 여러 도구의 쓰임새와 장/단점을 이해하고, 다양한 노하우를 얻을 수 있습니다. 단순하게 웹 검색만으로 지식을 습득하는 방식이 아닌 AI를 사용해 자료를 수집하고 학습하여, 이를 기준으로 판단하고, 이 내용을 기반으로 AI로 구축해보면서 익힐 수 있도록 구성되어 있습니다. 이런 경험을 통해 AI 도구의 이해를 넓히고 인프라 세계관을 확장할 수 있으며, 이를 통해 AI 시대에 경쟁력을 쌓을 수 있다고 생각합니다.

 

김지원 (피에프씨테크놀로지스 DevOps 엔지니어(실습 환경: Windows 11))

인프라를 직접 구축하던 시대에서 AI와 함께 설계하고 운영하는 시대로 넘어가고 있습니다. 이 책은 이런 흐름을 실제 실습을 통해 체감할 수 있는 책입니다. 단순히 클라우드에 인프라를 올리는 데 그치지 않고, 예상치 못한 문제와 마주했을 때 AI와 소통하며 원인을 분석하고 시스템을 견고하게 다듬어가는 실무적인 과정을 경험할 수 있습니다. 책의 흐름을 따라가다 보면 복잡한 빌드/배포 환경과 모니터링 시스템을 구성하는 방법뿐만 아니라, AI와 함께 인프라를 고도화해 나가는 감각까지 자연스레 익히게 됩니다. 인프라 구성에 막막함을 느끼는 분들에게는 흐름을 익힐 수 있는 입문서로, 자동화와 고도화를 고민하는 엔지니어에게는 GitAIOps라는 새로운 작업 방식을 시도해볼 수 있는 좋은 지침서가 될 것입니다.

결국 AI가 만들어낸 결과물을 엮어 시스템으로 완성하는 것은 사람의 몫입니다. AI를 다루는 능력이 곧 엔지니어의 역량이 된 시대에, 한 걸음 더 나아가고 싶은 분들께 추천드립니다.