Kustomize에 대한 간략한 소개

메모. 번역: 이 기사는 IT 분야에서 폭넓은 경험을 보유한 엔지니어이자 2016권의 인쇄본(주로 VMware vSphere 관련)의 저자/공동 저자인 Scott Lowe가 작성했습니다. 그는 현재 클라우드 컴퓨팅과 Kubernetes를 전문으로 하는 VMware 자회사 Heptio(XNUMX년 인수)에서 근무하고 있습니다. 텍스트 자체는 기술을 사용하는 Kubernetes의 구성 관리에 대한 간결하고 이해하기 쉬운 소개 역할을 합니다. 사용자 정의, 최근 K8s의 일부가 되었습니다.

Kustomize는 사용자가 "원본 YAML을 그대로 유지하고 사용 가능한 상태로 유지하면서 다양한 목적으로 템플릿이 없는 간단한 YAML 파일을 사용자 정의"할 수 있는 도구입니다(설명은 다음에서 직접 차용함). GitHub의 kustomize 저장소). Kustomize는 직접 실행하거나 Kubernetes 1.14부터 사용할 수 있습니다. kubectl -k 해당 기능에 액세스합니다(Kubernetes 1.15부터 별도의 바이너리가 kubectl에 내장된 기능보다 최신임). (메모. 번역: 그리고 최근 출시로 쿠버네티스 1.16 커스터마이제이션 에 의해 지원 kubeadm 유틸리티에도 있습니다.) 이 게시물에서는 독자들에게 Kustomize의 기본 사항을 소개하고 싶습니다.

가장 간단한 형태/애플리케이션에서 kustomize는 단순히 리소스 모음(Kubernetes 개체: 배포, 서비스 등을 정의하는 YAML 파일)과 해당 리소스에 적용해야 하는 변경 사항에 대한 지침 목록입니다. make가 다음에 포함된 명령어 세트를 사용하는 것처럼 Makefile, Docker는 다음 지침에 따라 컨테이너를 빌드합니다. Dockerfile,용도 사용자 정의 kustomization.yaml 사용자가 리소스 세트에 적용하려는 변경 사항에 대한 지침을 저장합니다.

다음은 예제 파일입니다. kustomization.yaml:

resources:
- deployment.yaml
- service.yaml
namePrefix: dev-
namespace: development
commonLabels:
  environment: development

파일에서 가능한 모든 필드에 대해 이야기하지는 않겠습니다. kustomization.yaml (이것은 잘 쓰여졌습니다. 여기에), 그러나 구체적인 예에 ​​대해 간략하게 설명하겠습니다.

• 분야 resources kustomize가 변경할 내용(어떤 리소스)을 나타냅니다. 이 경우 파일에서 리소스를 찾습니다. deployment.yaml и service.yaml 디렉터리에 있습니다(필요한 경우 전체 또는 상대 경로를 지정할 수 있습니다).
• 분야 namePrefix kustomize에 특정 접두사를 추가하도록 지시합니다(이 경우 - dev-) 속성 name 필드에 정의된 모든 리소스 resources. 따라서 배포가 있는 경우 name 의미를 가지고 nginx-deployment, 맞춤설정하여 만들겠습니다. dev-nginx-deployment.
• 분야 namespace kustomize에 지정된 네임스페이스를 모든 리소스에 추가하도록 지시합니다. 이 경우 배포 및 서비스는 네임스페이스에 속합니다. development.
• 마지막으로 해당 분야 commonLabels 모든 리소스에 추가될 라벨 세트가 포함되어 있습니다. 이 예에서 kustomize는 이름이 있는 리소스에 라벨을 할당합니다. environment 그리고 의미 development.

사용자가 그런 경우 kustomize build . 파일이 있는 디렉토리에 kustomization.yaml 및 필요한 리소스(예: 파일 deployment.yaml и service.yaml), 그러면 출력 시에 지정된 변경 사항이 포함된 텍스트를 받게 됩니다. kustomization.yaml.

메모. 번역: kustomize의 "간단한" 사용에 관한 프로젝트 문서의 그림

변경 사항을 커밋해야 하는 경우 출력을 리디렉션할 수 있습니다.

kustomize build . > custom-config.yaml

출력 데이터는 결정적이므로(동일한 입력 데이터는 동일한 출력 결과를 생성함) 결과를 파일에 저장할 필요가 없습니다. 대신 다른 명령으로 직접 전달할 수 있습니다.

kustomize build . | kubectl apply -f -

Kustomize 기능은 다음을 통해 액세스할 수도 있습니다. kubectl -k (Kubernetes 버전 1.14부터). 그러나 독립형 kustomize 패키지는 통합 kubectl 패키지보다 더 빠르게 업데이트된다는 점을 명심하세요(적어도 Kubernetes 1.15 릴리스의 경우).

독자들은 "파일을 직접 편집할 수 있다면 왜 이렇게 복잡합니까?"라고 물을 수 있습니다. 좋은 질문입니다. 우리의 예에서는 실제로 하나는 수 파일 수정 deployment.yaml и service.yaml 직접적으로, 그러나 다른 사람의 프로젝트에서 포크된 것이라면 어떻게 될까요? 파일을 직접 변경하면 원본/소스가 변경될 때 포크를 리베이스하는 것이 (불가능하지는 않더라도) 어렵습니다. kustomize를 사용하면 이러한 변경 사항을 파일에 중앙 집중화할 수 있습니다. kustomization.yaml, 원본 파일을 그대로 유지하므로 필요한 경우 원본 파일을 더 쉽게 리베이스할 수 있습니다.

Kustomize의 이점은 보다 복잡한 사용 사례에서 더욱 분명해집니다. 위의 예에서 kustomization.yaml 리소스는 동일한 디렉터리에 있습니다. 그러나 kustomize는 기본 구성과 이에 대한 다양한 변형이 있는 사용 사례를 지원합니다. 오버레이. 예를 들어, 사용자가 제가 예로 사용한 nginx용 배포 및 서비스를 사용하여 해당 파일의 개발, 준비 및 프로덕션 버전(또는 변형)을 만들고 싶어했습니다. 이를 위해서는 위에서 언급한 오버레이와 실제로 기본 리소스 자체가 필요합니다.

오버레이 및 기본 리소스에 대한 아이디어를 설명하기 위해 (기본 자원), 디렉토리의 구조가 다음과 같다고 가정해 보겠습니다.

- base
  - deployment.yaml
  - service.yaml
  - kustomization.yaml
- overlays
  - dev
    - kustomization.yaml
  - staging
    - kustomization.yaml
  - prod
    - kustomization.yaml

파일에서 base/kustomization.yaml 필드를 사용하는 사용자 resources kustomize에 포함해야 하는 리소스를 선언하기만 하면 됩니다.

각 파일에는 overlays/{dev,staging,prod}/kustomization.yaml 사용자는 현장에서 기본 구성을 참조합니다. resources을 선택한 다음 다음에 대한 특정 변경 사항을 나타냅니다. 주어진 환경. 예를 들어, 파일 overlays/dev/kustomization.yaml 이전에 제공된 예와 같을 수 있습니다.

resources:
- ../../base
namePrefix: dev-
namespace: development
commonLabels:
  environment: development

이 경우 파일 overlays/prod/kustomization.yaml 완전히 다를 수 있습니다.

resources:
- ../../base
namePrefix: prod-
namespace: production
commonLabels:
  environment: production
  sre-team: blue

사용자가 실행할 때 kustomize build . 카탈로그에 overlays/dev, kustomize가 개발 옵션을 생성합니다. 당신이 실행하는 경우 kustomize build . 카탈로그에 overlays/prod - 생산 옵션을 얻을 수 있습니다. 그리고 이 모든 것 - 원본을 변경하지 않고 (베이스) 모든 파일을 선언적이고 결정적인 방식으로 관리합니다. 기본 구성 및 오버레이 디렉터리를 버전 제어에 직접 커밋할 수 있으며 이러한 파일을 기반으로 언제든지 원하는 구성을 재현할 수 있습니다.

메모. 번역: Kustomize에서 오버레이 사용에 대한 프로젝트 문서의 그림

사용자 정의할 수 있습니다 많이 이 기사에서 다루는 것보다 더 많은 것입니다. 그러나 이것이 좋은 소개가 되기를 바랍니다.

추가 리소스

Kustomize에 관한 좋은 기사와 출판물이 많이 있습니다. 특히 유용하다고 생각되는 몇 가지 사항은 다음과 같습니다.

• Kustomize를 사용하여 다양한 환경 생산/테스트에 대한 기본 YAML 구성 변경;
• Kustomize — Kubernetes에서 템플릿을 작성하는 올바른 방법;
• Customize를 사용한 Kubernetes 객체의 선언적 관리;
• Customize를 사용하여 업스트림 Helm 차트 사용자 정의.

메모. 번역: 게시된 링크 블록을 추천할 수도 있습니다. 자료 유틸리티 웹사이트에서 Kustomize에 대한 최신 보고서가 포함된 비디오 컬렉션을 확인하세요.

이 자료를 개선하기 위한 질문이나 제안 사항이 있는 경우 언제든지 피드백을 받을 수 있습니다. 다음 주소로 저에게 연락하실 수 있습니다. 트위터 또는 쿠버네티스 슬랙 채널. kustomize를 사용하여 매니페스트를 재미있게 수정해 보세요!

번역가의 추신

블로그에서도 읽어보세요.

• «Kubernetes에서 실행되는 애플리케이션 개발자를 위한 도구";
• «Kubernetes 1.14: 주요 혁신 개요";
• «암스테르담에서 열린 Helm Summit 2019의 XNUMX가지 주요 결과";
• «Kubernetes용 패키지 관리자에 대한 실제 소개 - Helm".

출처 : habr.com