GitOps 배포 | 개인 실습, 과정 자료로 자율 진행 | 2026.04.10 - 2026.04.20
이미지 빌드와 클러스터 배포 권한을 나눈 GKE 배포 경로
GitHub Actions는 키 없이 인증해 이미지만 올리고, 클러스터 배포는 Argo CD가 맡게 했습니다. CPU 부족으로 멈춘 배포는 교체 순서를 바꿔 해결했습니다.
클러스터
노드 2대
GKE 노드 Ready
배포
2/2
Pod 2개 모두 정상
외부 접속
HTTP 200
Ingress 응답 확인
GKE 배포 흐름
이미지 업로드와 배포 권한을 나눈 경로
Terraform 적용부터 외부 접속 HTTP 200까지 실습에서 확인했습니다.
01
Terraform
GKE, VPC, Registry, 인증 준비
02
Actions
키 없이 인증 → 이미지 빌드와 업로드
03
태그 반영
새 이미지 태그를 사람이 Git에 커밋
04
Argo CD
Git 내용대로 클러스터 동기화
05
Ingress
외부 IP로 HTTP 200 확인
인프라
Terraform 적용, 노드 2대 Ready
배포
이미지 업로드, 태그 확인
실행 상태
Synced/Healthy, HTTP 200
문제 해결 과정
작은 노드 2대에서 무중단 교체가 막혔고, 교체 순서를 바꿔 끝냈습니다. 그 대가도 함께 기록했습니다.
1문제
새 이미지로 교체하는 중 추가로 뜨는 Pod가 Pending 상태로 멈췄고, 이벤트에는 '2 Insufficient cpu'가 남았습니다.
2원인
e2-medium 노드 2대에는 기존 Pod를 유지한 채 새 Pod를 하나 더 띄울 CPU가 없었습니다.
3조치
maxSurge 0, maxUnavailable 1로 바꿔, 새 Pod를 더 띄우지 않고 기존 Pod를 하나씩 바꾸게 했습니다. 최종 2/2를 확인했습니다.
4남은 과제
이 방식은 교체하는 동안 Pod가 1개로 줄어듭니다. 운영에서는 노드 여유 용량이나 자동 확장부터 확보해야 한다는 점을 기록했습니다.
설계 배경
CI가 클러스터를 직접 바꿀 수 있으면 권한 사고가 곧 배포 사고가 됩니다. 그래서 CI에는 클러스터 접속 정보를 두지 않고, 이미지를 만드는 단계와 클러스터에 반영하는 단계를 나눴습니다.
핵심 코드
Actions는 키 없이 인증해 이미지를 올리는 권한만 갖고, 클러스터 반영은 Argo CD가 Git을 보고 합니다.
CI 권한과 Argo CD 동기화 설정
.github/workflows/ci.yml + gitops/argocd-app.yaml
permissions:
contents: read
id-token: write
- uses: google-github-actions/auth@v2
with:
workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
- name: Build and push image
run: docker push "${IMAGE_URI}"
spec:
source:
path: k8s
syncPolicy:
automated:
prune: true
selfHeal: true직접 확인하기
아래 링크에서 코드, 설계 문서, 실행 기록을 직접 확인할 수 있습니다.
범위와 한계: 2026년 4월 실습 결과이며 지금 운영 중인 서비스는 아닙니다.
GitHub GitHub 저장소 ↗
Terraform, CI, 매니페스트 전체 코드
문서 검증 결과 문서 ↗
노드 Ready부터 HTTP 200까지 단계별 확인 기록
문서 CI/CD 책임 분리 문서 ↗
Actions와 Argo CD가 맡는 범위
문서 트러블슈팅 문서 ↗
할당량, Ingress, CPU 부족 문제와 해결 과정
문서 아키텍처 문서 ↗
GCP 자원과 배포 흐름 구조
코드 GitHub Actions 워크플로 코드 ↗
OIDC/WIF 인증과 이미지 업로드 단계
이미지 전체 아키텍처 원본
GCP 실행 환경, Registry, Argo CD, GitHub Actions 관계도
