study.

Kustomize로 환경별 배포 구성하기 · Kubernetes

공통 선언은 유지하고 환경별 차이만 덧붙입니다.

← Kubernetes

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

Base와 overlay

공통 리소스와 환경별 변형을 분리하면 큰 YAML을 복사해 관리하는 일을 줄일 수 있습니다. Kustomize는 템플릿 문자열 치환과 다른 방식으로 리소스를 구성합니다.

렌더링 먼저

kubectl kustomize는 최종 YAML을 출력할 뿐 배포하지 않습니다. 이미지·namespace·replicas가 의도한 값인지 확인한 뒤 apply -k로 반영합니다.

GitOps와의 구분

파일을 Git에 두는 것만으로 자동 동기화가 생기지는 않습니다. GitOps에서는 별도 컨트롤러가 저장소의 선언과 클러스터 상태를 지속적으로 맞춥니다.

왜 필요한가요?

개발과 운영 YAML을 복사해 따로 관리하면 공통 수정이 한쪽에서 빠지기 쉽습니다. base에는 공통 자원을, overlay에는 환경 차이를 두어 변경 의도를 표현합니다.

차례대로 이해하기

렌더링 결과 읽기

kubectl kustomize는 입력을 합친 결과를 출력합니다. base의 replicas와 overlay의 변경이 최종 YAML에서 어떻게 보이는지 비교하고, 실제 적용 전에 이미지·namespace·리소스 이름을 검토합니다.

적용과 운영 방식 구분

apply -k는 렌더링한 결과를 클러스터에 반영합니다. Kustomize 자체는 Git 저장소 변경을 감시하며 자동 배포하는 서비스가 아니므로 GitOps 운영에는 별도 컨트롤러가 필요합니다.

직접 실행하며 익혀보세요.

kubectl과 개인 실습용 Kubernetes 클러스터, POSIX 셸이 필요합니다. 매 실습에서 context를 확인하고 전용 namespace를 사용하세요. 실습별 정리는 해당 namespace의 모든 리소스를 삭제합니다.

임시 폴더에 base와 dev overlay를 만들고 복제본 2개로 렌더링해 적용하세요. 이 예제는 GitOps 컨트롤러를 설치하지 않습니다.

kubectl config current-context
kubectl create namespace study-k8s-overlay --dry-run=client -o yaml | kubectl apply -f -
study_overlay_dir=$(mktemp -d)
mkdir -p "$study_overlay_dir/base" "$study_overlay_dir/dev"
cat > "$study_overlay_dir/base/deployment.yaml" <<'YAML'
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 1
  selector:
    matchLabels: {app: web}
  template:
    metadata:
      labels: {app: web}
    spec:
      containers:
      - name: web
        image: nginx:stable-alpine
YAML
printf 'resources:
- deployment.yaml
' > "$study_overlay_dir/base/kustomization.yaml"
cat > "$study_overlay_dir/dev/kustomization.yaml" <<'YAML'
resources:
- ../base
namespace: study-k8s-overlay
replicas:
- name: web
  count: 2
YAML
kubectl kustomize "$study_overlay_dir/dev"
kubectl apply -k "$study_overlay_dir/dev"
kubectl rollout status deployment/web -n study-k8s-overlay --timeout=120s
kubectl get deployment web -n study-k8s-overlay

이렇게 확인하세요

렌더링 결과에 namespace study-k8s-overlay와 replicas: 2가 있어야 합니다. 적용 뒤 Deployment가 2개 복제본을 준비하는지 확인하세요. 파일 경로 오류면 resources의 상대 경로를 살펴봅니다.

실습 리소스 정리

결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.

kubectl delete namespace study-k8s-overlay

응용해보기

base replicas=1, 개발 overlay=2입니다. 원본 base를 변경하지 않고 개발 결과가 2임을 어떻게 확인할까요?

생각해본 뒤 풀이 보기

개발 overlay를 kubectl kustomize로 렌더링하고 출력 Deployment의 spec.replicas를 읽습니다. 다른 overlay도 따로 렌더링해 원하지 않는 변경이 전파되지 않았는지 비교합니다.

잠깐, 이해했는지 확인해볼까요?

클러스터를 변경하지 않고 최종 YAML만 확인하는 명령은?

  1. kubectl apply -k
  2. kubectl kustomize
  3. kubectl delete -k
  4. kubectl rollout restart
생각해본 뒤 풀이 보기

kubectl kustomize

kubectl kustomize는 구성 결과를 출력합니다. apply -k가 실제 API에 변경을 반영합니다.

공식 문서 · Kustomize로 환경별 배포 구성하기