kubeadm 配置 (v1beta3)

概述

包 v1beta3 定义了 kubeadm 配置文件格式的 v1beta3 版本。此版本通过修复一些小问题并添加一些新字段来改进 v1beta2 格式。

自 v1beta2 以来更改的列表

  • 已弃用的“ClusterConfiguration.useHyperKubeImage”字段已删除。Kubeadm 不再支持 hyperkube 镜像。
  • 已删除“ClusterConfiguration.DNS.Type”字段,因为 CoreDNS 是 kubeadm 支持的唯一 DNS 服务器类型。
  • 在包含密钥的字段上包含“datapolicy”标签。这会导致在使用 klog 打印 API 结构时省略字段值。
  • 添加“InitConfiguration.SkipPhases”、“JoinConfiguration.SkipPhases” 以允许在 kubeadm init/join 命令执行期间跳过阶段列表。
  • 添加“InitConfiguration.NodeRegistration.ImagePullPolicy” 和 “JoinConfiguration.NodeRegistration.ImagePullPolicy” 以允许在 kubeadm“init”和“join”期间指定镜像拉取策略。该值必须是“Always”、“Never”或“IfNotPresent”之一。“IfNotPresent”是默认值,它一直是此添加之前的现有行为。
  • 添加“InitConfiguration.Patches.Directory”、“JoinConfiguration.Patches.Directory” 以允许用户配置一个目录,从中获取 kubeadm 部署的组件的补丁。
  • 将 BootstrapToken* API 和相关实用程序从“kubeadm”API 组移到一个新的组“bootstraptoken”。kubeadm API 版本 v1beta3 不再包含 BootstrapToken* 结构。

从旧的 kubeadm 配置版本迁移

  • kubeadm v1.15.x 及更高版本可用于从 v1beta1 迁移到 v1beta2。
  • kubeadm v1.22.x 及更高版本不再支持 v1beta1 和更旧的 API,但可用于将 v1beta2 迁移到 v1beta3。
  • kubeadm v1.27.x 及更高版本不再支持 v1beta2 和更旧的 API,

基础知识

配置 kubeadm 的首选方法是使用--config选项传递一个 YAML 配置文件。kubeadm 配置文件中定义的一些配置选项也作为命令行标志可用,但只有最常见/简单的用例支持这种方法。

kubeadm 配置文件可能包含使用三个破折号(---)分隔的多种配置类型。

kubeadm 支持以下配置类型

apiVersion: kubeadm.k8s.io/v1beta3
kind: InitConfiguration

apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration

apiVersion: kubeproxy.config.k8s.io/v1alpha1
kind: KubeProxyConfiguration

apiVersion: kubeadm.k8s.io/v1beta3
kind: JoinConfiguration

要打印“init”和“join”操作的默认值,请使用以下命令

kubeadm config print init-defaults
kubeadm config print join-defaults

配置文件中必须包含的配置类型列表取决于您正在执行的操作(initjoin)以及您将使用的配置选项(默认值或高级自定义)。

如果某些配置类型未提供或仅部分提供,kubeadm 将使用默认值;kubeadm 提供的默认值还包括在必要时强制组件间的值一致性(例如,控制器管理器的--cluster-cidr标志和kube-proxy上的clusterCIDR)。

用户始终允许覆盖默认值,唯一的例外是与安全相关的设置子集(例如,在 api 服务器上强制执行授权模式节点和 RBAC)。

如果用户提供的配置类型与您正在执行的操作不匹配,kubeadm 将忽略这些类型并打印警告。

Kubeadm init 配置类型

当使用--config选项执行 kubeadm init 时,可以使用以下配置类型:InitConfiguration、ClusterConfiguration、KubeProxyConfiguration、KubeletConfiguration,但 InitConfiguration 和 ClusterConfiguration 之间只有一个是强制性的。

apiVersion: kubeadm.k8s.io/v1beta3
kind: InitConfiguration
bootstrapTokens:
  ...
nodeRegistration:
  ...

InitConfiguration 类型应用于配置运行时设置,在 kubeadm init 的情况下,是引导令牌的配置以及在执行 kubeadm 的节点上特有的所有设置,包括

  • NodeRegistration,它包含与将新节点注册到集群相关的字段;使用它来自定义节点名称、要使用的 CRI 套接字或仅适用于此节点的任何其他设置(例如,节点 IP)。

  • LocalAPIEndpoint,它表示要在此节点上部署的 API 服务器实例的端点;使用它(例如)来自定义 API 服务器的广告地址。

apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
networking:
  ...
etcd:
  ...
apiServer:
  extraArgs:
    ...
  extraVolumes:
    ...
...

ClusterConfiguration 类型应用于配置集群范围的设置,包括以下设置

  • networking,它包含有关集群网络拓扑的配置;使用它(例如)来自定义 Pod 子网或服务子网。

  • etcd:使用它(例如)来自定义本地 etcd 或配置 API 服务器以使用外部 etcd 集群。

  • kube-apiserver、kube-scheduler、kube-controller-manager 配置;使用它通过添加自定义设置或覆盖 kubeadm 默认设置来自定义控制平面组件。

apiVersion: kubeproxy.config.k8s.io/v1alpha1
kind: KubeProxyConfiguration
  ...

KubeProxyConfiguration 类型应用于更改传递给集群中部署的 kube-proxy 实例的配置。如果此对象未提供或仅部分提供,kubeadm 将应用默认值。

有关 kube-proxy 的官方文档,请参见 https://kubernetes.ac.cn/docs/reference/command-line-tools-reference/kube-proxy/ 或 https://pkg.go.dev/k8s.io/kube-proxy/config/v1alpha1#KubeProxyConfiguration。

apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
  ...

KubeletConfiguration 类型应用于更改将传递给集群中部署的所有 kubelet 实例的配置。如果此对象未提供或仅部分提供,kubeadm 将应用默认值。

有关 kubelet 的官方文档,请参见 https://kubernetes.ac.cn/docs/reference/command-line-tools-reference/kubelet/ 或 https://pkg.go.dev/k8s.io/kubelet/config/v1beta1#KubeletConfiguration。

以下是一个完全填充的单个 YAML 文件示例,其中包含在kubeadm init运行期间使用的多个配置类型。

apiVersion: kubeadm.k8s.io/v1beta3
kind: InitConfiguration
bootstrapTokens:
  - token: "9a08jv.c0izixklcxtmnze7"
    description: "kubeadm bootstrap token"
    ttl: "24h"
  - token: "783bde.3f89s0fje9f38fhf"
    description: "another bootstrap token"
    usages:
      - authentication
      - signing
    groups:
      - system:bootstrappers:kubeadm:default-node-token
nodeRegistration:
  name: "ec2-10-100-0-1"
  criSocket: "/var/run/dockershim.sock"
  taints:
    - key: "kubeadmNode"
      value: "someValue"
      effect: "NoSchedule"
  kubeletExtraArgs:
    v: 4
  ignorePreflightErrors:
    - IsPrivilegedUser
  imagePullPolicy: "IfNotPresent"
localAPIEndpoint:
  advertiseAddress: "10.100.0.1"
  bindPort: 6443
certificateKey: "e6a2eb8581237ab72a4f494f30285ec12a9694d750b9785706a83bfcbbbd2204"
skipPhases:
  - addon/kube-proxy
---
apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
etcd:
  # one of local or external
  local:
    imageRepository: "registry.k8s.io"
    imageTag: "3.2.24"
    dataDir: "/var/lib/etcd"
    extraArgs:
      listen-client-urls: "http://10.100.0.1:2379"
    serverCertSANs:
      -  "ec2-10-100-0-1.compute-1.amazonaws.com"
    peerCertSANs:
      - "10.100.0.1"
  # external:
    # endpoints:
    # - "10.100.0.1:2379"
    # - "10.100.0.2:2379"
    # caFile: "/etcd/kubernetes/pki/etcd/etcd-ca.crt"
    # certFile: "/etcd/kubernetes/pki/etcd/etcd.crt"
    # keyFile: "/etcd/kubernetes/pki/etcd/etcd.key"
networking:
  serviceSubnet: "10.96.0.0/16"
  podSubnet: "10.244.0.0/24"
  dnsDomain: "cluster.local"
kubernetesVersion: "v1.21.0"
controlPlaneEndpoint: "10.100.0.1:6443"
apiServer:
  extraArgs:
    authorization-mode: "Node,RBAC"
  extraVolumes:
    - name: "some-volume"
      hostPath: "/etc/some-path"
      mountPath: "/etc/some-pod-path"
      readOnly: false
      pathType: File
  certSANs:
    - "10.100.1.1"
    - "ec2-10-100-0-1.compute-1.amazonaws.com"
  timeoutForControlPlane: 4m0s
controllerManager:
  extraArgs:
    "node-cidr-mask-size": "20"
  extraVolumes:
    - name: "some-volume"
      hostPath: "/etc/some-path"
      mountPath: "/etc/some-pod-path"
      readOnly: false
      pathType: File
scheduler:
  extraArgs:
    bind-address: "10.100.0.1"
  extraVolumes:
    - name: "some-volume"
      hostPath: "/etc/some-path"
      mountPath: "/etc/some-pod-path"
      readOnly: false
      pathType: File
certificatesDir: "/etc/kubernetes/pki"
imageRepository: "registry.k8s.io"
clusterName: "example-cluster"
---
apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration
# kubelet specific options here
---
apiVersion: kubeproxy.config.k8s.io/v1alpha1
kind: KubeProxyConfiguration
# kube-proxy specific options here

Kubeadm join 配置类型

当使用--config选项执行kubeadm join时,应提供 JoinConfiguration 类型。

apiVersion: kubeadm.k8s.io/v1beta3
kind: JoinConfiguration
  ...

JoinConfiguration 类型应用于配置运行时设置,在kubeadm join的情况下,是用于访问集群信息的发现方法以及在执行 kubeadm 的节点上特有的所有设置,包括

  • nodeRegistration,它包含与将新节点注册到集群相关的字段;使用它来自定义节点名称、要使用的 CRI 套接字或仅适用于此节点的任何其他设置(例如,节点 IP)。

  • apiEndpoint,它表示最终要在此节点上部署的 API 服务器实例的端点。

资源类型

BootstrapToken

出现于

BootstrapToken 描述一个引导令牌,存储在集群中的 Secret 中

字段描述
token [Required]
BootstrapTokenString

token 用于在节点和控制平面之间建立双向信任。用于加入集群中的节点。

description
string

description 设置一个人性化的消息,说明此令牌存在的原因及其用途,以便其他管理员可以了解其用途。

ttl
meta/v1.Duration

ttl 定义此令牌的生存时间。默认为24hexpiresttl是互斥的。

expires
meta/v1.Time

expires 指定此令牌过期的时间戳。默认情况下,根据ttl在运行时动态设置。expiresttl是互斥的。

usages
[]string

usages 描述此令牌的使用方式。默认情况下,可用于建立双向信任,但可以在此处更改。

groups
[]string

groups 指定此令牌在用于身份验证时/如果用于身份验证将作为其身份验证的额外组

BootstrapTokenString

出现于

BootstrapTokenString 是格式为abcdef.abcdef0123456789的令牌,用于验证从加入节点的角度来看 API 服务器的实用性,以及作为“kubeadm join”引导阶段中节点的身份验证方法。此令牌是短期的,也应该是短期的。

字段描述
- [Required]
string
未提供描述。
- [Required]
string
未提供描述。

ClusterConfiguration

ClusterConfiguration 包含 kubeadm 集群的集群范围配置。

字段描述
apiVersion
string
kubeadm.k8s.io/v1beta3
kind
string
ClusterConfiguration
etcd
Etcd

etcd 包含 etcd 的配置。

networking
网络

networking 包含有关集群网络拓扑的配置。

kubernetesVersion
string

kubernetesVersion 是控制平面的目标版本。

controlPlaneEndpoint
string

controlPlaneEndpoint 为控制平面设置一个稳定的 IP 地址或 DNS 名称。它可以是一个有效的 IP 地址或一个 RFC-1123 DNS 子域,两者都可以带有可选的 TCP 端口。如果未指定controlPlaneEndpoint,则使用advertiseAddress + bindPort;如果指定了controlPlaneEndpoint但没有 TCP 端口,则使用bindPort。可能的用法是

  • 在具有多个控制平面实例的集群中,此字段应分配给控制平面实例前面的外部负载均衡器的地址。
  • 在强制执行节点循环利用的环境中,controlPlaneEndpoint 可用于为控制平面分配稳定的 DNS。
apiServer
APIServer

apiServer 包含 API 服务器的额外设置。

controllerManager
ControlPlaneComponent

controllerManager 包含控制器管理器的额外设置。

scheduler
ControlPlaneComponent

scheduler 包含调度程序的额外设置。

dns
DNS

dns 定义在集群中安装的 DNS 附加组件的选项。

certificatesDir
string

certificatesDir 指定存储或查找所有必需证书的位置。

imageRepository
string

imageRepository 设置拉取镜像的容器注册表。如果为空,默认情况下将使用registry.k8s.io。如果 kubernetes 版本是 CI 构建(kubernetes 版本以ci/开头),则gcr.io/k8s-staging-ci-images将用作控制平面组件和 kube-proxy 的默认值,而registry.k8s.io将用于所有其他镜像。

featureGates
map[string]bool

featureGates 包含用户启用的功能门。

clusterName
string

集群名称。

InitConfiguration

InitConfiguration 包含一个元素列表,该列表是特定于“kubeadm init”的运行时信息。kubeadm init专用的信息。这些字段仅在第一次运行kubeadm init时使用。之后,这些字段中的信息将不会上传到kubeadm-config ConfigMap,例如kubeadm upgrade使用该 ConfigMap。这些字段必须是 omitempty。

字段描述
apiVersion
string
kubeadm.k8s.io/v1beta3
kind
string
InitConfiguration
bootstrapTokens
[]BootstrapToken

bootstrapTokenskubeadm init 时会被尊重,并描述要创建的一组 Bootstrap Token。 此信息不会上传到 kubeadm 集群的 configmap 中,部分原因是它的敏感性。

节点注册
NodeRegistrationOptions

nodeRegistration 包含与将新的控制平面节点注册到集群相关的字段。

本地 API 端点
APIEndpoint

localAPIEndpoint 代表在此控制平面节点上部署的 API 服务器实例的端点。 在 HA 设置中,这与 ClusterConfiguration.controlPlaneEndpoint 不同,因为 controlPlaneEndpoint 是集群的全局端点,它将请求负载均衡到每个单独的 API 服务器。 此配置对象允许您自定义本地 API 服务器在其上宣布可访问的 IP/DNS 名称和端口。 默认情况下,kubeadm 尝试自动检测默认接口的 IP 并使用它,但如果该过程失败,您可以在此处设置所需的值。

证书密钥
string

certificateKey 设置用于在 uploadcerts init 阶段在集群中将证书和密钥上传到 Secret 之前加密证书和密钥的密钥。 证书密钥是十六进制编码的字符串,它是大小为 32 字节的 AES 密钥。

跳过阶段
[]string

skipPhases 是在命令执行期间要跳过的阶段列表。 阶段列表可以通过 kubeadm init --help 命令获得。 “--skip-phases” 标志优先于此字段。

补丁
Patches

patches 包含与在 kubeadm init 期间将补丁应用到 kubeadm 部署的组件相关的选项。

JoinConfiguration

JoinConfiguration 包含描述特定节点的元素。

字段描述
apiVersion
string
kubeadm.k8s.io/v1beta3
kind
string
JoinConfiguration
节点注册
NodeRegistrationOptions

nodeRegistration 包含与将新的控制平面节点注册到集群相关的字段。

caCertPath
string

caCertPath 是用于保护节点和控制平面之间通信的 SSL 证书颁发机构的路径。 默认值为“/etc/kubernetes/pki/ca.crt”。

discovery [必需]
Discovery

discovery 指定 kubelet 在 TLS 引导过程中使用的选项。

控制平面
JoinControlPlane

controlPlane 定义要部署在加入节点上的额外控制平面实例。 如果为 nil,则不会部署任何其他控制平面实例。

跳过阶段
[]string

skipPhases 是在命令执行期间要跳过的阶段列表。 阶段列表可以通过 kubeadm join --help 命令获得。 --skip-phases 标志优先于此字段。

补丁
Patches

patches 包含与在 kubeadm join 期间将补丁应用到 kubeadm 部署的组件相关的选项。

APIEndpoint

出现于

APIEndpoint 结构体包含在节点上部署的 API 服务器实例的元素。

字段描述
公告地址
string

advertiseAddress 设置 API 服务器要公告的 IP 地址。

绑定端口
int32

bindPort 设置 API 服务器要绑定到的安全端口。 默认值为 6443。

APIServer

出现于

APIServer 包含集群中 API 服务器部署所需的设置

字段描述
ControlPlaneComponent [必需]
ControlPlaneComponent
(ControlPlaneComponent 的成员嵌入到此类型中。) 未提供描述。
certSANs
[]string

certSANs 设置 API 服务器签名证书的额外主体备用名称 (SAN)。

控制平面超时
meta/v1.Duration

timeoutForControlPlane 控制我们等待 API 服务器出现的时间。

BootstrapTokenDiscovery

出现于

BootstrapTokenDiscovery 用于设置基于引导令牌的发现的选项。

字段描述
token [Required]
string

token 是用于验证从控制平面获取的集群信息的令牌。

apiServerEndpoint
string

apiServerEndpoint 是将从其获取信息的 API 服务器的 IP 或域名。

caCertHashes
[]string

caCertHashes 指定在使用基于令牌的发现时验证的一组公钥固定。 在发现期间找到的根 CA 必须与这些值之一匹配。 指定一个空集将禁用根 CA 固定,这可能不安全。 每个哈希都指定为 <type>:<value>,其中目前唯一支持的类型是“sha256”。 这是一个 DER 编码的 ASN.1 中的主题公钥信息 (SPKI) 对象的十六进制编码 SHA-256 哈希。 例如,可以使用 OpenSSL 计算这些哈希。

unsafeSkipCAVerification
bool

unsafeSkipCAVerification 允许在没有 caCertHashes 通过 CA 验证的情况下进行基于令牌的发现。 这会削弱 kubeadm 的安全性,因为其他节点可以冒充控制平面。

ControlPlaneComponent

出现于

ControlPlaneComponent 包含集群控制平面组件的通用设置

字段描述
额外参数
map[string]string

extraArgs 是传递给控制平面组件的额外一组标志。 此映射中的一个键是标志名称,因为它出现在命令行上,只是没有前导连字符(或连字符)。

额外卷
[]HostPathMount

extraVolumes 是额外的一组主机卷,挂载到控制平面组件。

DNS

出现于

DNS 定义了集群中应该使用的 DNS 附加组件

字段描述
ImageMeta [必需]
ImageMeta
(ImageMeta 的成员嵌入到此类型中。)

imageMeta 允许自定义用于 DNS 组件的镜像。

Discovery

出现于

Discovery 指定 kubelet 在 TLS 引导过程中使用的选项。

字段描述
bootstrapToken
BootstrapTokenDiscovery

bootstrapToken 用于设置基于引导令牌的发现的选项。 bootstrapTokenfile 是互斥的。

文件
FileDiscovery

file 用于指定一个文件或 URL 到一个 kubeconfig 文件,从中加载集群信息。 bootstrapTokenfile 是互斥的。

tlsBootstrapToken
string

tlsBootstrapToken 是用于 TLS 引导的令牌。 如果设置了 bootstrapToken,则此字段默认为 .bootstrapToken.token,但可以覆盖。 如果设置了 file,则在 KubeConfigFile 不包含任何其他身份验证信息的情况下,必须设置此字段

超时
meta/v1.Duration

timeout 修改发现超时。

Etcd

出现于

Etcd 包含描述 Etcd 配置的元素。

字段描述
本地
LocalEtcd

local 提供用于配置本地 etcd 实例的配置旋钮。 localexternal 是互斥的。

外部
ExternalEtcd

external 描述如何连接到外部 etcd 集群。 localexternal 是互斥的。

ExternalEtcd

出现于

ExternalEtcd 描述了一个外部 etcd 集群。 Kubeadm 不知道证书文件在哪里,必须提供它们。

字段描述
endpoints [必需]
[]string

endpoints 包含 etcd 成员列表。

caFile [必需]
string

caFile 是用于保护 etcd 通信的 SSL 证书颁发机构 (CA) 文件。 如果使用 TLS 连接,则需要它。

certFile [必需]
string

certFile 是用于保护 etcd 通信的 SSL 证书文件。 如果使用 TLS 连接,则需要它。

keyFile [必需]
string

keyFile 是用于保护 etcd 通信的 SSL 密钥文件。 如果使用 TLS 连接,则需要它。

FileDiscovery

出现于

FileDiscovery 用于指定一个文件或 URL 到一个 kubeconfig 文件,从中加载集群信息。

字段描述
kubeConfigPath [必需]
string

kubeConfigPath 用于指定实际的文件路径或 URL 到一个 kubeconfig 文件,从中加载集群信息。

HostPathMount

出现于

HostPathMount 包含描述从主机挂载的卷的元素。

字段描述
name [必需]
string

name 是 Pod 模板中卷的名称。

hostPath [必需]
string

hostPath 是主机中将被挂载到 Pod 中的路径。

mountPath [必需]
string

mountPath 是 Pod 中 hostPath 将被挂载到的路径。

只读
bool

readOnly 控制对卷的写入访问权限。

pathType
core/v1.HostPathType

pathTypehostPath 的类型。

ImageMeta

出现于

ImageMeta 允许自定义用于未来自 Kubernetes/Kubernetes 发布过程的组件的镜像

字段描述
imageRepository
string

imageRepository 设置容器注册表以从中拉取镜像。 如果未设置,将改为使用 ClusterConfiguration 中定义的 imageRepository

imageTag
string

imageTag 允许指定镜像的标签。 如果设置了此值,kubeadm 不会在升级期间自动更改上述组件的版本。

JoinControlPlane

出现于

JoinControlPlane 包含描述要部署在加入节点上的额外控制平面实例的元素。

字段描述
本地 API 端点
APIEndpoint

localAPIEndpoint 代表要部署在此节点上的 API 服务器实例的端点。

证书密钥
string

certificateKey 是在加入新控制平面节点后从 secret 中下载证书后用于解密证书的密钥。 相应的加密密钥位于 InitConfiguration 中。 证书密钥是十六进制编码的字符串,它是大小为 32 字节的 AES 密钥。

LocalEtcd

出现于

LocalEtcd 描述了 kubeadm 应该在本地运行一个 etcd 集群。

字段描述
ImageMeta [必需]
ImageMeta
(ImageMeta 的成员嵌入到此类型中。)

ImageMeta 允许自定义用于 etcd 的容器。

dataDir [必需]
string

dataDir 是 etcd 将放置其数据的目录。 默认值为“/var/lib/etcd”。

额外参数
map[string]string

extraArgs 是在静态 Pod 中运行时提供给 etcd 二进制文件的额外参数。 此映射中的一个键是标志名称,因为它出现在命令行上,只是没有前导连字符(或连字符)。

serverCertSANs
[]string

serverCertSANs 设置 etcd 服务器签名证书的额外主体备用名称 (SAN)。

peerCertSANs
[]string

peerCertSANs 设置 etcd 对等签名证书的额外主体备用名称 (SAN)。

网络

出现于

Networking 包含描述集群网络配置的元素。

字段描述
serviceSubnet
string

serviceSubnet 是 Kubernetes 服务使用的子网。 默认值为“10.96.0.0/12”。

podSubnet
string

podSubnet 是 Pod 使用的子网。

dnsDomain
string

dnsDomain 是 Kubernetes 服务使用的 DNS 域名。 默认值为“cluster.local”。

NodeRegistrationOptions

出现于

NodeRegistrationOptions 包含与通过 kubeadm initkubeadm join 将新的控制平面或节点注册到集群相关的字段。

字段描述
名字
string

name 是将在 kubeadm initkubeadm join 操作中创建的 Node API 对象的 .metadata.name 字段。 此字段也用于 kubelet 对 API 服务器的客户端证书的 CommonName 字段。 如果未提供,则默认为节点的主机名。

criSocket
string

criSocket 用于检索容器运行时信息。 此信息将被注释到 Node API 对象中,以便以后重用。

taints [必需]
[]core/v1.Taint

taints 指定 Node API 对象应该注册的污点。 如果此字段未设置,即为 nil,它将使用控制平面节点的控制平面污点默认。 如果您不想给控制平面节点添加污点,请将此字段设置为一个空列表,即 YAML 文件中的 taints: []。 此字段仅用于节点注册。

kubeletExtraArgs
map[string]string

kubeletExtraArgs 将额外参数传递给 kubelet。 此处的参数通过 kubeadm 在运行时为 kubelet 编写以供其源的环境文件传递给 kubelet 命令行。 这将覆盖 kubelet-config ConfigMap 中的通用基本级配置。 解析时,标志具有更高的优先级。 这些值是本地的,并且特定于 kubeadm 正在执行的节点。 此映射中的一个键是标志名称,因为它出现在命令行上,只是没有前导连字符(或连字符)。

ignorePreflightErrors
[]string

ignorePreflightErrors 提供了在注册当前节点时要忽略的预检错误列表,例如 IsPrevilegedUser,Swap。 值 all 会忽略所有检查的错误。

imagePullPolicy
core/v1.PullPolicy

imagePullPolicy 指定 kubeadm "init" 和 "join" 操作期间拉取镜像的策略。此字段的值必须是 "Always"、"IfNotPresent" 或 "Never" 之一。如果未设置此字段,kubeadm 将默认将其设置为 "IfNotPresent",或者在主机上不存在时拉取所需的镜像。

Patches

出现于

Patches 包含与将补丁应用于 kubeadm 部署的组件相关的选项。

字段描述
directory
string

directory 是一个指向目录的路径,该目录包含名为 "target[suffix][+patchtype].extension" 的文件。例如,"kube-apiserver0+merge.yaml" 或仅 "etcd.json"。"target" 可以是 "kube-apiserver"、"kube-controller-manager"、"kube-scheduler" 或 "etcd" 之一。"patchtype" 可以是 "strategic"、"merge" 或 "json" 之一,它们与 kubectl 支持的补丁格式匹配。默认的 "patchtype" 是 "strategic"。"extension" 必须是 "json" 或 "yaml" 之一。"suffix" 是一个可选字符串,可用于按字母数字顺序确定先应用哪些补丁。

此页面是自动生成的。

如果您要报告此页面的问题,请在问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目中的其他地方进行。

上次修改于 2024 年 4 月 18 日下午 7:57 PST:v1.30 的 Config API 参考 (6fa7b80ae3)