[Claude] 개요, 실습 환경 구성(GKE)

안녕하세요. AI 시대에 개발자가 알아야 할 인프라 구성 배포 with 클로드 코드 책을 읽고 학습한 내용을 정리했습니다.

 

1장. [도입] AI 시대, 개발자의 인프라

개발자가 인프라를 다루게 된 시대적 배경, 쿠버네티스가 좋은 출발점인 이유, GitOps에서 GitAIOps로의 전환, 그리고 이 책의 가드레일 시스템을 소개합니다.

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

클라우드와 컨테이너가 보편화되면서 개발자가 직접 인프라를 다루는 일이 늘어나고 있습니다. 이런 변화에는 아래와 같은 배경이 있습니다.

- DevOps 문화 확산

- 클라우드 네이티브 전환

- 풀스택 범위 확장

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

개발자가 인프라를 배우려면 어디서 시작해야할까요? k8s가 좋은 출발점입니다. 

- 특정 클라우드에 종속되지 않습니다. 

- 일종의 클라우드 운영체제입니다.

- 개념이 클라우드 인프라 전반과 겹칩니다. 

 

다만, k8s에는 높은 벽이 있습니다. 소수의 엔지니어가 클러스터 구축부터 배포 파이프라인, 모니터링, 장애 대응, 보안까지 모든 것을 감당합니다. 도구를 고르는 것만으로도 벅찬데 각 도구의 설치와 설정, 그리고 도구 간의 연동까지 챙겨야합니다. 거기에 문서화까지 하려면 시간이 모자랍니다. 이를 해결하기 위해 클로드 코드와 같은 에이전트형 AI를 활용하여 대화하면서 k8s 인프라를 처음부터 끝까지 구축해볼 수 있습니다. 

 

1.3 GitOps에서 GitAIOps로

- GitOps는 깃에 선언된 상태를 클러스터에 자동으로 반영합니다. 하지만 그 상태를 '정의하는 작업'은 여전히 사람의 몫입니다. GitOps가 배포 자동화를 해결해줬지만 그 앞단의 작업량은 그대로입니다. 따라서 에이전트형 AI를 활용할 수 있습니다. 

"사람이 도구를 결정하기만 하면 설치부터 설정 그리고 필요한 검증 과정까지 모두 AI가 맡아 실행한다는 점"입니다. 

 

GitAIOps = GitOps의 자동화된 상태 관리 + AI 실행 능력

 

1.6 가드레일: Claude Code가 정확하게 동작하는 이유

- 클로드 코드는 CLAUDE.md 파일을 자동으로 읽어 동작 규칙을 삼습니다. 가드레일은 클로드 코드가 '검증된 경로'를 따르도록 안내합니다. 클로드 코드가 이 가드레일을 참조하면서 작업하기 때문에 사용자는 자연어로 지시하면서도 안정적인 결과를 얻을 수 있습니다. 

 

2장. [기반] 환경 구성

 스토리: 스타트업 창업, 첫 서비스 배포

Claude Code와 대화하면서 GCP 인증, GKE 클러스터 생성, Notiflex 앱 빌드/배포, GitHub 첫 커밋까지 개발 환경을 처음부터 구성합니다.

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

- GCP의 무료 크레딧 활용

 

2.2 Claude Code 설치

- 자동 승인 모드로 진행 

claude --dangerously-skip-permissions

 

[프롬프트]

안녕! 나는 Notiflex라는 B2B 알림 SaaS 플랫폼의 DevOps 엔지니어야. 이 책을 따라가면서 쿠버네티스 운영 환경을 처음부터 구축하려고 해.

 

클로드 코드는 언어 모델이라 같은 입력에도 응답 표현이 조금씩 달라질 수 있습니다. 

 

[프롬프트]

클로드 코드 설치 확인

 

 

statusline 설정하기 

- statusline 설정을 통해 현재 모델, 컨텍스트 사용량, 쿠버네티스 컨텍스트 등 실습에 필요한 정보를 한눈에 볼 수 있습니다.

 

[프롬프트]

statusline 설정해줘

 

2.3 gcloud CLI 설치

 

[프롬프트]

gcloud CLI 설치해줘

 

GCP 인증

gcloud auth login

 

프로젝트 및 리전 설정

[프롬프트]

프로젝트는 hayley-gitaiops-project로, 리전은 서울(asia-northeast3)로 gcloud 기본값을 설정해줘

 

Artifact Registry 인증 설정

[프롬프트]

Artifact Registry 인증 설정해줘(서울 리전).

2.4 GitHub 저장소 구성

[프롬프트]

깃허브 저장소 만들어줘

2.5 GKE 클러스터 생성

[프롬프트]

GKE 클러스터 생성해줘

 

 

[프롬프트]

노드 상태 확인해줘

2.6 Notiflex 앱 빌드와 배포

[프롬프트]

Notiflex 앱 만들고 배포해줘

 

2.7 GitHub에 첫 커밋

[프롬프트]

커밋하고 푸시해줘

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

- 각 장의 실습이 끝나면 '지금까지 작업한 내용을 문서로 정리'하는 작업이 필요합니다. 매번 긴 프롬프트를 입력하는 대신 클로드 코드의 커스텀 스킬을 만들어두면 한 마디로 해결됩니다. 

 

[프롬프트]

/update-docs라는 커스텀 스킬을 만들어줘. 각 장 마지막에 저장소 문서의 신규 추가와 기존 내용 변경을 모두 감지해 그 시점까지의 작업 기준으로 갱신하고 변경 사항을 커밋하는 거야. 이후 장에서 새 문서가 추가되어도 같은 스킬이 그대로 동작하도록 설계해줘.

 

이후부터는 /update-docs 명령어로 위 절차가 자동 실행됩니다.