GitAIOps – Cpt2, 환경 구성(GKE+Claude Code)

Log on Me

Activities / Study / GitAIOps

GitAIOps – Cpt2, 환경 구성(GKE+Claude Code)

Kubernetes, AWS, Terraform, Linux 운영 경험을 정리한 기술 블로그입니다.

JongJin Kim GitAIOps

Summary

  • GCP, Claude Code, Github 등 실습 필요 환경 구성
  • 초기버전의 Notiflex 앱 구성 후 GKE 환경에 배포 수행
  • JOURNEY.md, /update-docs 스킬을 구축해 작업 이력 문서화를 자동화

Thoughts

  • 잘 구축된 시스템의 편리함
    • 진짜 대 딸깍의 시대다.. 기존에는 각종 설치문서등을 뒤져서 설치명령어/환경변수 등록하던것을 단순 자연어 입력으로 수행가능
    • 보이지 않는곳에 잘 짜여져있는 실행지침때문이겠지만, 과거 설치과정 공식문서/블로그들 돌아다니던것 생각하면 장족의 발전. AI 모델 성능 이전에 활용하기 위한 기반 구축의 중요성
  • 반복 작업의 추상화
    • 기존에도 자주쓰는 명령어 및 옵션등을 alias로 단축하거나 커스텀 명령어로 사용해왔었음
    • AI 환경의 커스텀 커맨드는 단순 명령어 조합을 넘어서 일련의 과정 및 분기처리?까지 자동화 할 수 있어 활용도가 넓어질듯함
    • k8s pod status/events만 골라서 위험 지표만 보여주는 cluster-healtcheck 식으로도 만들어 쓸 수 있을듯
  • statusline
    • 상태바 활용에 있어 긱뉴스에서 본 claude-recall 사용중
    • 터미널 여러개 쪼개서 작업하다보면 각 터미널에서 무슨 작업중인지 종종 잊어버림 > 세션내용 요약 및 표시

2장. 환경 구성

  • GCP(GKE)+ClaudeCode+GitHub를 사용해 Notiflex 앱을 배포 및 운영
교재 그림 재구성
  • GCP 신규 계정 생성시 300$ 무료 크레딧을 제공하므로 실질적으로 Claude Code 구독료 정도만 소모
서비스비용비고
GCP (GKE, Artifact Registry 등)$300 무료 크레딧신규 계정, 90일
Claude Code최소 $22/월(Pro)Max($110/월) 권장
GitHub무료Public 저장소 + GitHub Actions 무료

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

  • GCP 계정 생성 및 콘솔 활성화 등은 변경될 수 있어 교재 및 Google Cloud Platform 사이트 참조
  • 26년 7월 현재 무료 크레딧 정책은 첫 90일간 $300달러 크레딧 제공 > 이후 리소스 중지
  • 미사용중 클러스터 제거, Spot VM등으로 효율적인 비용 사용 가능

2.2 클로드 코드 설치

  • 클로드 코드는 터미널에서 동작하는 에이전트형 AI 서비스

2.2.1 클로드 코드 요금제

요금제특징권장 여부
Free사용량 제한이 큼실습용 비추천
Pro ($22/월)대부분 실습 가능기본 권장
Max ($110+/월)더 높은 사용량 제공장시간 실습 권장

2.2.2 클로드 코드 설치

curl -fsSL https://claude.ai/install.sh | bash

2.2.3 클로드 코드 첫 실행과 인사

  • 실습 저장소 준비: _Book_GitAIOps 가이드 저장소 클론
    • CLAUDE.md, guardrail 파일, 실습 설정등이 들어있음
git clone https://github.com/sysnet4admin/_Book_GitAIOps
cd _Book_GitAIOps
  • Claude Code 자동 승인모드 실행
    • –dangerously-skip-permissions (bypassPermissions) 모드 사용
    • 가이드 디렉토리에서만 작업 / 프로덕션 환경 아님 / 가드레일에 따른 작업범위 제한이기에 괜찮음
claude --dangerously-skip-permissions

2.2.4 statusline 설정하기

  • cc 하단의 실시간 정보를 표시하는 상태바(statusline) 설정
    • 현재 모델 / 컨텍스트 사용량 / 토큰 사용량 / 현재 프로젝트 / 등
  • cc내부에서 자연어로 statusline 구성해줘 라고 요청

2.3 gcloud CLI 설치

  • 콘솔에 직접 작업하는 대신 PC에서/에이전트가 작업할수 있도록 gcp용 cli도구 gcloud 설치 및 구성

2.3.1 gcloud CLI 설치와 인증

  • cc내부에서 자연어로 gcloud CLI 설치해줘 라고 요청

2.3.2 GCP 인증

  • gcp 인증과정에서 브라우저 로그인이 필요하므로 cc 자체적으로는 수행불가
  • 아래 명령어로 팝업된 브라우저에 로그인
gcloud auth login
gcloud auth application-default login

2.3.3 프로젝트 및 리전 설정

  • 기본 프로젝트, 리전, 존을 설정해두고 고정
  • cc내부에서 자연어로 프로젝트는 <고유한프로젝트명>, 리전은 서울(asia-northeast3)로 gcloud 기본값 설정 라고 요청

기본 리전/존설정 해줘

2.3.4 Artifact Registry 인증 설정

  • GCP 내부의 컨테이너 이미지 저장소인 Artifact Registry 인증 설정

Artifact Registry 설정 해줘

2.4 깃허브 저장소 구성

  • cc 내부에서 자연어로 깃허브 저장소 만들어줘 하면 생성
  • gh 명령어등을 통해 notiflex-platform 레포지토리 생성 및 구성

GitHub 저장소 만들어줘

2.5 GKE 클러스터 생성

  • Notiflex 애플리케이션을 배포할 GKE(Google Kubernetes Engine) 클러스터를 생성

2.5.1 클러스터 생성

  • cc에게 자연어로 GKE 클러스터 생성해줘 하면 GKE 클러스터가 생성됨
항목설정
클러스터 이름notiflex-cluster
타입GKE Standard (Zonal)
리전/존asia-northeast3-a (서울)
노드e2-medium × 2
VMSpot VM
Gateway API활성화
디스크30GB

GKE 클러스터 생성해줘

2.5.2 kubeconfig 설정

  • 생성된 클러스터에 접근하기 위해서는 kubectl 명령어가 해당 클러스터를 보도록 kubeconfig 업데이트 필요

2.5.3 클러스터 상태 확인

  • 생성이후 node/spot 여부/gatewayclass등 몇가지 리소스 동작 확인 절차 수행

2.6 Notiflex 앱 빌드와 배포

  • 생성된 GKE 클러스터에 Notiflex 앱 작성, 컨테이너 이미지 빌드, 배포 수행
  • cc에게 자연어로 Notiflex 앱 만들고 배포해줘 하면 애플리케이션 생성 및 배포 진행
    • Go API 작성 (main.go, go.mod)
    • Dockerfile 작성
    • 이미지 빌드 및 Artifact Registry 푸시
    • Kubernetes 매니페스트 생성
    • GKE 배포 및 동작 확인

Notiflex 앱 만들고 배포해줘

2.7 깃허브에 첫 커밋

  • 작성된 코드와 k8s manifest를 깃허브에 저장하여 2장 마무리
  • cc에게 자연어로 커밋하고 푸시해줘 하면 JOURNEY.md를 작성하고 커밋하여 푸시함

커밋하고 푸시해줘

2.7.1 JOURNEY.md 생성

  • 실습진행상황을 기록하는 진행상황 확인 문서, 체크리스트 형태로 진행 현황 기록

2.7.2 커밋과 푸시

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

  • 매 장이 끝날때 프로젝트 문서를 갱신하는 cc 커스텀스킬(/update-docs)를 생성
  • 문서를 수정하라는 프롬프트 입력 대신 일련의 명령어로 문서업데이트와 커밋 자동화
  • cc에게 자연어로/update-docs라는 커스텀 스킬 만들어줘 하면 .claude/commands/update-docs.md 생성
  • cc에서는 커스텀 슬래시 명령이 skills 체계에 통합됨

update-docs

2.9 2장 가드레일 살펴보기

  • 2장의 경우 소개되었던 3가지 가드레일(의사결정/실행/결과) 중 실행 가드레일이 주로 사용됨
서브챕터가드레일 파일역할
2.2 클로드 코드 설치prompt-guardrails/ch2/2.2-install-check.md클로드 코드 설치 확인, statusline 설정
2.3 gcloud CLI 설치prompt-guardrails/ch2/2.3-gcloud.mdgcloud 설치, 인증, 프로젝트와 리전, 존 설정 순서
2.4 GitHub 저장소prompt-guardrails/ch2/2.4-github-repo.md저장소 생성, CLAUDE.md, 디렉터리 구조
2.5 GKE 클러스터prompt-guardrails/ch2/2.5-gke-cluster.md클러스터 사양, kubeconfig, Gateway API 확인
2.6 빌드/배포prompt-guardrails/ch2/2.6-build-deploy.mdGo 앱, Dockerfile, 매니페스트, 배포
2.7 첫 커밋prompt-guardrails/ch2/2.7-first-commit.mdJOURNEY.md 생성, Git commit/push
  • 각 파일은 실행지침, 트러블 슈팅, 질문 블록으로 구성되어있음
  • 2장에는 기본 환경 구성 단계라 도구를 선택할 일이 없어 prompt-guardrails만 사용
  • decision-guide등은 3장이후에서 활용

Leave A Comment