Kubelet 配置目录合并

当使用 kubelet 的 --config-dir 标志指定配置的放置目录时,关于不同类型如何合并存在一些特定的行为。

以下是一些不同数据类型在配置合并期间如何表现的示例

结构字段

YAML 结构中有两种类型的结构字段:单数(或标量类型)和嵌入式(包含标量类型的结构)。配置合并过程处理单数和嵌入式结构字段的覆盖,以创建最终的 kubelet 配置。

例如,您可能希望所有节点都有一个基准 kubelet 配置,但您可能希望自定义 addressauthorization 字段。这可以按如下方式完成

主 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 配置的切片/列表值。但是,在合并过程中,整个列表会被覆盖。例如,您可以按如下方式覆盖 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[string][]string,与特定字段关联的整个列表会被覆盖。让我们通过一个例子更好地理解这一点,特别是像 featureGatesstaticPodURLHeader 这样的字段

主 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: 更新 KubeletConfigDropinDir 文档信息 (c306367734)