Alauda Container Platform GitOps Docs
  • 简体中文

    • Kustomize

    目录

    介绍Kustomize 的核心概念优势使用场景

    介绍

    Kustomize 是一个 Kubernetes 原生的配置管理工具，允许用户通过覆盖层和组合来自定义 Kubernetes 资源定义（YAML 文件），而无需直接修改原始文件。

    Kustomize 的核心概念

    • Base：包含通用 Kubernetes 资源定义的基础配置。
    • Overlay：用于修改 Base 配置的自定义层。
    • kustomization.yaml：定义资源如何组合和修改的配置文件。

    Argo CD 与 Kustomize 的集成通过支持声明式持续交付，增强了 GitOps 实践。示例：

    apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: kustomize-example
spec:
  project: default
  source:
    path: examples/helloWorld
    repoURL: 'https://github.com/kubernetes-sigs/kustomize'
    targetRevision: HEAD
  destination:
    namespace: default
    server: 'https://kubernetes.default.svc'

    如果在 repoURL 和 path 位置存在 kustomization.yaml 文件，Argo CD 将使用 Kustomize 渲染清单。

    Kustomize 支持以下配置选项：

    • namePrefix：添加到 Kustomize 生成资源名称的前缀。
    • nameSuffix：添加到 Kustomize 生成资源名称的后缀。
    • images：Kustomize 镜像覆盖列表。
    • replicas：Kustomize 从节点覆盖列表。
    • commonLabels：添加到所有资源的标签映射。
    • labelWithoutSelector：布尔值，定义公共标签是否应用于资源选择器和模板。
    • forceCommonLabels：布尔值，允许覆盖已有标签。
    • commonAnnotations：添加到所有资源的注解映射。
    • namespace：Kubernetes 资源命名空间。
    • forceCommonAnnotations：布尔值，允许覆盖已有注解。
    • commonAnnotationsEnvsubst：布尔值，启用注解值中的环境变量替换。
    • patches：支持内联更新的 Kustomize 补丁列表。
    • components：Kustomize 组件列表。

    使用带有覆盖层的 Kustomize 时，请将路径指向 overlay 目录。

    优势

    • 声明式配置：通过 kustomization.yaml 使用 YAML 文件定义资源组合和修改。

    • 无模板：通过补丁和覆盖层自定义配置，无需模板引擎。

    • Kubernetes 原生集成：Kustomize 已内置于 kubectl，无需额外工具。

    使用场景

    • 多环境分发：通过 Base 和 Overlay 实现环境特定配置（如应用、集群）。

    • 配置复用：适合跨项目复用基础配置。

    • 渐进式交付：通过补丁逐步调整资源配置。

    参考资料

    更多详细信息，请参阅：Kustomize