kustomize可让您自定义原始的,无模板的YAML文件以进行多种目的,使原始的YAML未触及和可用。
kustomize目标Kubernetes;它可以理解并可以修补Kubernetes样式API对象。就像make一样,它的作用在文件中声明,就像sed一样,它发出了编辑的文本。
该工具由Sig-CLI(KEP)赞助。
要查找最近版本Kubectl中嵌入的kustomize版本,请运行kubectl version :
> kubectl version --client
Client Version: v1.31.0
Kustomize Version: v5.4.2将v2.0.3处的kustomize构建流量添加到kubectl v1.14中。 kubectl中的kustomize流量保持在v2.0.3的冷冻,直到kubectl v1.21,将其更新为v4.0.5。它将定期更新,并将反映在Kubernetes发行说明中。
| kubectl版本 | kustomize版本 |
|---|---|
| <v1.14 | N/A。 |
| V1.14-V1.20 | v2.0.3 |
| v1.21 | v4.0.5 |
| V1.22 | v4.2.0 |
| V1.23 | v4.4.1 |
| V1.24 | v4.5.4 |
| v1.25 | v4.5.7 |
| v1.26 | v4.5.7 |
| V1.27 | v5.0.1 |
有关使用Kubectl集成的示例和指南,请参阅Kubernetes文档。
在包含您的yaml资源文件(部署,服务,配置等)的某些目录中,创建一个kustomization文件。
该文件应声明这些资源,以及任何适用于它们的自定义,例如添加一个通用标签。
base: kustomization + resources
kustomization.yaml deployment.yaml service.yaml
+---------------------------------------------+ +-------------------------------------------------------+ +-----------------------------------+
| apiVersion: kustomize.config.k8s.io/v1beta1 | | apiVersion: apps/v1 | | apiVersion: v1 |
| kind: Kustomization | | kind: Deployment | | kind: Service |
| commonLabels: | | metadata: | | metadata: |
| app: myapp | | name: myapp | | name: myapp |
| resources: | | spec: | | spec: |
| - deployment.yaml | | selector: | | selector: |
| - service.yaml | | matchLabels: | | app: myapp |
| configMapGenerator: | | app: myapp | | ports: |
| - name: myapp-map | | template: | | - port: 6060 |
| literals: | | metadata: | | targetPort: 6060 |
| - KEY=value | | labels: | +-----------------------------------+
+---------------------------------------------+ | app: myapp |
| spec: |
| containers: |
| - name: myapp |
| image: myapp |
| resources: |
| limits: |
| memory: "128Mi" |
| cpu: "500m" |
| ports: |
| - containerPort: 6060 |
+-------------------------------------------------------+
文件结构:
~/someApp ├── deployment.yaml ├── kustomization.yaml └── service.yaml
该目录中的资源可能是他人配置的叉子。如果是这样,您可以轻松地从源材料中反弹以捕获改进,因为您不会直接修改资源。
生成自定义的yaml:
kustomize build ~/someApp
YAML可以直接应用于群集:
kustomize build ~/someApp | kubectl apply -f -
使用修改共同基础的叠加层来管理配置的传统变体(例如开发,分期和生产)。
overlay: kustomization + patches
kustomization.yaml replica_count.yaml cpu_count.yaml
+-----------------------------------------------+ +-------------------------------+ +------------------------------------------+
| apiVersion: kustomize.config.k8s.io/v1beta1 | | apiVersion: apps/v1 | | apiVersion: apps/v1 |
| kind: Kustomization | | kind: Deployment | | kind: Deployment |
| commonLabels: | | metadata: | | metadata: |
| variant: prod | | name: myapp | | name: myapp |
| resources: | | spec: | | spec: |
| - ../../base | | replicas: 80 | | template: |
| patches: | +-------------------------------+ | spec: |
| - path: replica_count.yaml | | containers: |
| - path: cpu_count.yaml | | - name: myapp |
+-----------------------------------------------+ | resources: |
| limits: |
| memory: "128Mi" |
| cpu: "7000m" |
+------------------------------------------+
文件结构:
~/someApp ├── base │ ├── deployment.yaml │ ├── kustomization.yaml │ └── service.yaml └── overlays ├── development │ ├── cpu_count.yaml │ ├── kustomization.yaml │ └── replica_count.yaml └── production ├── cpu_count.yaml ├── kustomization.yaml └── replica_count.yaml
从上面的步骤(1)进行工作,将其移至称为base的someApp子目录中,然后将叠加层放在兄弟姐妹目录中。
覆盖只是另一个kustomization,它是指基础,而是指适用于该基础的补丁。
这种安排使使用git管理配置变得容易。基础可以从其他人管理的上游存储库中拥有文件。叠加层可能位于您拥有的存储库中。在磁盘上安排唱片克隆作为兄弟姐妹避免需要git子模型(尽管您是子模块的风扇,但可以正常运行)。
生成yaml
kustomize build ~ /someApp/overlays/productionYAML可以直接应用于群集:
kustomize build ~ /someApp/overlays/production | kubectl apply -f -
参加Kubernetes社区的参与受Kubernetes行为守则的管辖。