Kubernetes对象声明式管理：Kustomize深度指南

Kubernetes对象声明式管理：Kustomize深度指南

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website

概述

Kustomize是Kubernetes生态中一个强大的配置管理工具，它通过kustomization文件实现对Kubernetes对象的定制化。自Kubernetes 1.14版本起，kubectl已原生集成Kustomize功能，使得开发者可以直接使用kubectl命令来管理基于Kustomize的配置。

核心功能

1. 资源生成

Kustomize能够从多种来源生成Kubernetes资源，特别是ConfigMap和Secret这两种常用资源。

ConfigMap生成

ConfigMap生成有三种主要方式：

1. 从文件生成：将整个文件内容作为ConfigMap的值

configMapGenerator:
- name: app-config
  files:
  - application.properties

2. 从环境文件生成：将.env文件中的键值对转换为ConfigMap条目

configMapGenerator:
- name: env-config
  envs:
  - .env

3. 从字面量生成：直接指定键值对

configMapGenerator:
- name: literal-config
  literals:
  - FOO=Bar

Secret生成

类似地，Secret也支持从文件和字面量生成：

secretGenerator:
- name: db-secret
  files:
  - password.txt
  literals:
  - username=admin

2. 跨资源字段设置

Kustomize允许为所有资源设置统一的元数据：

namespace: production
namePrefix: prod-
nameSuffix: "-v2"
commonLabels:
  env: production
commonAnnotations:
  owner: devops-team

3. 资源组合与定制

资源组合

可以将多个资源组合在一起管理：

resources:
- deployment.yaml
- service.yaml
- ingress.yaml

资源定制

Kustomize提供两种补丁方式：

1. Strategic Merge Patch：基于资源结构的合并

patches:
- path: increase_replicas.yaml

2. JSON Patch：RFC 6902标准的JSON补丁

patches:
- target:
    group: apps
    version: v1
    kind: Deployment
    name: my-app
  path: patch.json

高级特性

1. 镜像定制

无需修改原始YAML即可更新容器镜像：

images:
- name: nginx
  newName: my-registry/nginx
  newTag: 1.19.0

2. 变量替换

动态注入其他资源的字段值：

replacements:
- source:
    kind: Service
    name: my-service
    fieldPath: metadata.name
  targets:
  - select:
      kind: Deployment
      name: my-app
    fieldPaths:
    - spec.template.spec.containers.0.env.0.value

3. 生成器选项

控制生成的ConfigMap和Secret行为：

generatorOptions:
  disableNameSuffixHash: true
  labels:
    generated-by: kustomize

最佳实践

1. 模块化设计：将不同环境的配置分离到不同目录
2. 小规模补丁：每个补丁只做一件事
3. 版本控制：将生成的资源也纳入版本控制
4. 命名规范：使用一致的命名前缀和后缀
5. 文档注释：在kustomization.yaml中添加必要注释

总结

Kustomize为Kubernetes配置管理提供了声明式、可复用的解决方案。通过合理使用其各种功能，可以实现：

• 环境差异的优雅管理
• 配置的版本控制
• 资源的批量修改
• 敏感数据的安全管理

掌握Kustomize能显著提升Kubernetes配置管理的效率和可靠性，是每个Kubernetes使用者应当具备的核心技能。

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website