Kubelet 配置目录合并

当使用 kubelet 的 --config-dir 标志来指定配置的落地区域时，不同类型的配置合并方式有一些特定的行为。

以下是一些在配置合并过程中，不同数据类型行为的示例：

结构体字段

YAML 结构体中有两种类型的字段：单一字段（或标量类型）和嵌入式字段（包含标量类型的结构体）。配置合并过程通过覆盖单一字段和嵌入式结构体字段来创建最终的 kubelet 配置。

例如，你可能希望为所有节点提供一个基础的 kubelet 配置，但又想自定义 address 和 authorization 字段。这可以通过以下方式完成：

主 kubelet 配置文件内容

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
port: 20250
authorization:
  mode: Webhook
  webhook:
    cacheAuthorizedTTL: "5m"
    cacheUnauthorizedTTL: "30s"
serializeImagePulls: false
address: "192.168.0.1"

--config-dir 目录中文件的内容

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
authorization:
  mode: AlwaysAllow
  webhook:
    cacheAuthorizedTTL: "8m"
    cacheUnauthorizedTTL: "45s"
address: "192.168.0.8"

最终的配置将是这样的：

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
port: 20250
serializeImagePulls: false
authorization:
  mode: AlwaysAllow
  webhook:
    cacheAuthorizedTTL: "8m"
    cacheUnauthorizedTTL: "45s"
address: "192.168.0.8"

列表

你可以覆盖 kubelet 配置中的 slices/lists 值。但是，在合并过程中，整个列表都会被覆盖。例如，你可以像这样覆盖 clusterDNS 列表：

主 kubelet 配置文件内容

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
port: 20250
serializeImagePulls: false
clusterDNS:
  - "192.168.0.9"
  - "192.168.0.8"

--config-dir 目录中文件的内容

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
clusterDNS:
  - "192.168.0.2"
  - "192.168.0.3"
  - "192.168.0.5"

最终的配置将是这样的：

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
port: 20250
serializeImagePulls: false
clusterDNS:
  - "192.168.0.2"
  - "192.168.0.3"
  - "192.168.0.5"

Map（包括嵌套结构）

Map 中的单个字段，无论其值类型（boolean、string 等）如何，都可以被选择性地覆盖。但是，对于 map[string][]string 类型，与特定字段关联的整个列表都会被覆盖。让我们通过一个例子来更好地理解这一点，特别是对于 featureGates 和 staticPodURLHeader 等字段。

主 kubelet 配置文件内容

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
port: 20250
serializeImagePulls: false
featureGates:
  AllAlpha: false
  MemoryQoS: true
staticPodURLHeader:
  kubelet-api-support:
  - "Authorization: 234APSDFA"
  - "X-Custom-Header: 123"
  custom-static-pod:
  - "Authorization: 223EWRWER"
  - "X-Custom-Header: 456"

--config-dir 目录中文件的内容

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
featureGates:
  MemoryQoS: false
  KubeletTracing: true
  DynamicResourceAllocation: true
staticPodURLHeader:
  custom-static-pod:
  - "Authorization: 223EWRWER"
  - "X-Custom-Header: 345"

最终的配置将是这样的：

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
port: 20250
serializeImagePulls: false
featureGates:
  AllAlpha: false
  MemoryQoS: false
  KubeletTracing: true
  DynamicResourceAllocation: true
staticPodURLHeader:
  kubelet-api-support:
  - "Authorization: 234APSDFA"
  - "X-Custom-Header: 123"
  custom-static-pod:
  - "Authorization: 223EWRWER"
  - "X-Custom-Header: 345"
最后修改于 2024 年 3 月 8 日 上午 10:41 PST：docs: Update KubeletConfigDropinDir doc information (c306367734)