본문으로 건너뛰기

Kustomize

시작하기 전에

이 섹션을 위한 환경을 준비합니다:

~$prepare-environment


Kustomize를 사용하면 선언적 "kustomization" 파일을 사용하여 Kubernetes 매니페스트 파일을 관리할 수 있습니다. Kubernetes 리소스에 대한 "base" 매니페스트를 표현한 다음 composition, customization을 사용하여 변경 사항을 적용하고 여러 리소스에 걸쳐 교차 변경을 쉽게 수행할 수 있는 기능을 제공합니다.


예를 들어, checkout Deployment에 대한 다음 매니페스트 파일을 살펴보겠습니다:


~/environment/eks-workshop/base-application/checkout/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: checkout
  labels:
    app.kubernetes.io/created-by: eks-workshop
    app.kubernetes.io/type: app
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: checkout
      app.kubernetes.io/instance: checkout
      app.kubernetes.io/component: service
  template:
    metadata:
      annotations:
        prometheus.io/path: /metrics
        prometheus.io/port: "8080"
        prometheus.io/scrape: "true"
      labels:
        app.kubernetes.io/name: checkout
        app.kubernetes.io/instance: checkout
        app.kubernetes.io/component: service
        app.kubernetes.io/created-by: eks-workshop
    spec:
      serviceAccountName: checkout
      securityContext:
        fsGroup: 1000
      containers:
        - name: checkout
          envFrom:
            - configMapRef:
                name: checkout
          securityContext:
            capabilities:
              drop:
                - ALL
            readOnlyRootFilesystem: true
          image: "public.ecr.aws/aws-containers/retail-store-sample-checkout:1.2.1"
          imagePullPolicy: IfNotPresent
          ports:
            - name: http
              containerPort: 8080
              protocol: TCP
          livenessProbe:
            httpGet:
              path: /health
              port: 8080
            initialDelaySeconds: 30
            periodSeconds: 3
          resources:
            limits:
              memory: 512Mi
            requests:
              cpu: 250m
              memory: 512Mi
          volumeMounts:
            - mountPath: /tmp
              name: tmp-volume
      volumes:
        - name: tmp-volume
          emptyDir:
            medium: Memory



이 파일은 이미 이전 시작하기 실습에서 적용되었지만, Kustomize를 사용하여 replicas 필드를 업데이트하여 이 컴포넌트를 수평으로 스케일링하려고 한다고 가정해 봅시다. 이 YAML 파일을 수동으로 업데이트하는 대신, Kustomize를 사용하여 spec/replicas 필드를 1에서 3으로 업데이트하겠습니다.


이를 위해 다음 kustomization을 적용합니다.


    

  • 첫 번째 탭은 적용할 kustomization을 보여줍니다
    • 

  • 두 번째 탭은 kustomization이 적용된 후 업데이트된 Deployment/checkout 파일의 미리보기를 보여줍니다
    • 

  • 마지막으로 세 번째 탭은 변경된 내용의 차이만 보여줍니다
    • 



~/environment/eks-workshop/modules/introduction/kustomize/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: checkout
spec:
  replicas: 3


kubectl kustomize 명령을 사용하여 이 kustomization을 적용하는 최종 Kubernetes YAML을 생성할 수 있습니다. 이 명령은 kubectl CLI에 번들로 제공되는 kustomize를 호출합니다:


~$kubectl kustomize ~/environment/eks-workshop/modules/introduction/kustomize


이렇게 하면 많은 YAML 파일이 생성되며, 이는 Kubernetes에 직접 적용할 수 있는 최종 매니페스트를 나타냅니다. kustomize의 출력을 kubectl apply로 직접 파이프하여 이를 시연해 보겠습니다:


~$kubectl kustomize ~/environment/eks-workshop/modules/introduction/kustomize | kubectl apply -f -
namespace/checkout unchanged
serviceaccount/checkout unchanged
configmap/checkout unchanged
service/checkout unchanged
service/checkout-redis unchanged
deployment.apps/checkout configured
deployment.apps/checkout-redis unchanged


여러 checkout 관련 리소스가 "unchanged"로 표시되고 deployment.apps/checkout만 "configured"로 표시되는 것을 볼 수 있습니다. 이는 의도적입니다 — checkout deployment에만 변경 사항을 적용하려고 합니다. 이는 이전 명령을 실행하면 실제로 두 개의 파일이 적용되기 때문입니다: 위에서 본 Kustomize deployment.yaml과 ~/environment/eks-workshop/base-application/checkout 폴더의 모든 파일과 일치하는 다음 kustomization.yaml 파일입니다. patches 필드는 패치할 특정 파일을 지정합니다:


~/environment/eks-workshop/modules/introduction/kustomize/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - ../../../base-application/checkout
patches:
  - path: deployment.yaml



replicas 수가 업데이트되었는지 확인하려면 다음 명령을 실행하세요:


~$kubectl get pod -n checkout -l app.kubernetes.io/component=service
NAME                        READY   STATUS    RESTARTS   AGE
checkout-585c9b45c7-c456l   1/1     Running   0          2m12s
checkout-585c9b45c7-b2rrz   1/1     Running   0          2m12s
checkout-585c9b45c7-xmx2t   1/1     Running   0          40m


kubectl kustomize와 kubectl apply의 조합을 사용하는 대신 kubectl apply -k <kustomization_directory>로 동일한 작업을 수행할 수 있습니다(-f 플래그 대신 -k 플래그 사용). 이 방법은 이 워크샵 전체에서 사용되며 매니페스트 파일의 변경 사항을 쉽게 적용하면서 적용할 변경 사항을 명확하게 표시합니다.


시도해 봅시다:


~$kubectl apply -k ~/environment/eks-workshop/modules/introduction/kustomize


애플리케이션 매니페스트를 초기 상태로 재설정하려면 원래 매니페스트 세트를 간단히 적용하면 됩니다:


~$kubectl apply -k ~/environment/eks-workshop/base-application


일부 실습 연습에서 볼 수 있는 또 다른 패턴은 다음과 같습니다:


~$kubectl kustomize ~/environment/eks-workshop/base-application \
  | envsubst | kubectl apply -f-


이는 envsubst를 사용하여 특정 환경에 따라 Kubernetes 매니페스트 파일의 환경 변수 자리 표시자를 실제 값으로 대체합니다. 예를 들어 일부 매니페스트에서는 $EKS_CLUSTER_NAME으로 EKS 클러스터 이름을 참조하거나 $AWS_REGION으로 AWS 리전을 참조해야 합니다.


이제 Kustomize가 어떻게 작동하는지 이해했으므로 Helm 모듈로 진행하거나 Fundamentals 모듈로 직접 이동할 수 있습니다.


Kustomize에 대해 자세히 알아보려면 공식 Kubernetes 문서를 참조하세요.