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行為守則的管轄。