본문으로 건너뛰기
PDF ↓
← 대표 사례로

PF-02 · GCP · IaC

GCP Terraform GKE 플랫폼

노드 풀 업그레이드 중에도 용량을 유지하는 SURGE 설정과, VPN 대역만 허용하는 방화벽 기본선을 코드로 담은 모듈 모음입니다.

22
공개한 Terraform 모듈
5
max_surge로 먼저 뜨는 새 노드
0
max_unavailable, 동시에 빠지는 노드
역할
설계 · 구현
기간
개인 프로젝트 · 2026.11 공개
규모
모듈 22종 · 예제 3개
클라우드
GCP
기술
Terraform · GCP · GKE · Cloud Logging · Cloud Monitoring
GKE 노드 풀 SURGE 업그레이드max_surge = 5 max_unavailable = 0새 노드기존 노드기존 노드를 하나씩 제거 · 사용 불가 0새 노드 5개로 교체 완료 · 사용 불가 노드 0soak 3600s는 BLUE_GREEN 전략에서만 적용
교체가 끝납니다. soak 3600s는 BLUE_GREEN으로 바꿀 때만 읽히는 값입니다.
문제

GKE 노드를 업그레이드하는 동안 서비스 용량이 줄면 안 됐고, 관리 포트는 VPN 대역에서만 열려야 했습니다.

접근

노드 풀 업그레이드 전략을 SURGE로 두어 새 노드 5대를 먼저 올리고 사용 불가 노드를 0으로 유지합니다. c2sfirewall 모듈은 우선순위 1000으로 VPN의 관리 포트만 열고, 우선순위 65534로 그 외 tcp와 udp 아웃바운드를 막습니다.

결과

새 노드가 준비된 뒤에야 기존 노드가 빠집니다. 호스트 장애는 hostError 감사 로그에서 로그 기반 지표, 알림 정책, Slack 채널 순으로 이어지도록 구성했습니다.

배운 점

설정 이름만 보고 동작을 판단하면 틀릴 수 있다는 점을 배웠습니다. soak 시간처럼 이름만 보면 모든 업그레이드에 적용될 것 같은 값도 실제로는 BLUE_GREEN 전략에서만 읽히기 때문에, SURGE 예제에서는 이 값이 동작하지 않는다는 사실을 주석으로 분명히 남겼습니다. 업그레이드 중 용량을 지키는 것도 "새 노드를 먼저 올리고(max_surge 5), 빠지는 노드는 0으로 둔다"처럼 의도를 숫자로 고정해야 운영자가 바뀌어도 같은 결과가 나옵니다. 방화벽 역시 필요한 관리 포트만 우선순위 1000으로 열고 나머지를 65534에서 막는 기본선을 모듈에 넣어, 새 환경이 처음부터 같은 규칙으로 시작하게 했습니다.

Control Plane에서 전체 기록 보기 ↗

© 2026 김준현 · 이 사이트의 인프라도 코드로 관리합니다

테마 고르기

사원증을 누르면 그 테마로, 보던 내용과 같은 곳으로 이동합니다. 끌면 흔들리기만 합니다.

처음 화면으로 →