使用 kubeadm API 自定义组件
本页介绍如何自定义 kubeadm 部署的组件。对于控制平面组件,您可以使用 ClusterConfiguration
结构中的标志或每个节点的补丁。对于 kubelet 和 kube-proxy,您可以分别使用 KubeletConfiguration
和 KubeProxyConfiguration
。
所有这些选项都可通过 kubeadm 配置 API 实现。有关配置中每个字段的更多详细信息,您可以导航到我们的 API 参考页面。
注意
目前不支持自定义 kubeadm 的 CoreDNS 部署。您必须手动修补kube-system/coredns
ConfigMap 并重新创建 CoreDNS Pods。或者,您可以跳过默认 CoreDNS 部署并部署您自己的变体。有关这方面的更多详细信息,请参阅 使用 kubeadm 的 init 阶段。注意
要重新配置已创建的集群,请参阅 重新配置 kubeadm 集群。使用 ClusterConfiguration
中的标志自定义控制平面
kubeadm ClusterConfiguration
对象提供了一种方法,允许用户覆盖传递给控制平面组件(例如 APIServer、ControllerManager、Scheduler 和 Etcd)的默认标志。组件使用以下结构定义
apiServer
controllerManager
scheduler
etcd
这些结构包含一个通用的 extraArgs
字段,该字段由 name
/ value
对组成。要覆盖控制平面组件的标志
- 将适当的
extraArgs
添加到您的配置中。 - 将标志添加到
extraArgs
字段。 - 使用
--config <YOUR CONFIG YAML>
运行kubeadm init
。
注意
您可以通过运行kubeadm config print init-defaults
并将输出保存到您选择的某个文件中,来生成一个具有默认值的 ClusterConfiguration
对象。注意
ClusterConfiguration
对象目前在 kubeadm 集群中是全局的。这意味着您添加的任何标志都将应用于不同节点上相同组件的所有实例。要对不同节点上的每个组件应用单独的配置,您可以使用 补丁。APIServer 标志
有关详细信息,请参阅 kube-apiserver 的参考文档。
示例用法
apiVersion: kubeadm.k8s.io/v1beta4
kind: ClusterConfiguration
kubernetesVersion: v1.16.0
apiServer:
extraArgs:
- name: "enable-admission-plugins"
value: "AlwaysPullImages,DefaultStorageClass"
- name: "audit-log-path"
value: "/home/johndoe/audit.log"
ControllerManager 标志
有关详细信息,请参阅 kube-controller-manager 的参考文档。
示例用法
apiVersion: kubeadm.k8s.io/v1beta4
kind: ClusterConfiguration
kubernetesVersion: v1.16.0
controllerManager:
extraArgs:
- name: "cluster-signing-key-file"
value: "/home/johndoe/keys/ca.key"
- name: "deployment-controller-sync-period"
value: "50"
Scheduler 标志
有关详细信息,请参阅 kube-scheduler 的参考文档。
示例用法
apiVersion: kubeadm.k8s.io/v1beta4
kind: ClusterConfiguration
kubernetesVersion: v1.16.0
scheduler:
extraArgs:
- name: "config"
value: "/etc/kubernetes/scheduler-config.yaml"
extraVolumes:
- name: schedulerconfig
hostPath: /home/johndoe/schedconfig.yaml
mountPath: /etc/kubernetes/scheduler-config.yaml
readOnly: true
pathType: "File"
Etcd 标志
有关详细信息,请参阅 etcd 服务器文档。
示例用法
apiVersion: kubeadm.k8s.io/v1beta4
kind: ClusterConfiguration
etcd:
local:
extraArgs:
- name: "election-timeout"
value: 1000
使用补丁进行自定义
Kubernetes v1.22 [beta]
Kubeadm 允许您将包含补丁文件的目录传递给各个节点上的 InitConfiguration
和 JoinConfiguration
。这些补丁可以用作在将组件配置写入磁盘之前进行的最后自定义步骤。
您可以使用 --config <YOUR CONFIG YAML>
将此文件传递给 kubeadm init
。
apiVersion: kubeadm.k8s.io/v1beta4
kind: InitConfiguration
patches:
directory: /home/user/somedir
注意
对于kubeadm init
,您可以传递一个文件,该文件包含由 ---
分隔的 ClusterConfiguration
和 InitConfiguration
。您可以使用 --config <YOUR CONFIG YAML>
将此文件传递给 kubeadm join
。
apiVersion: kubeadm.k8s.io/v1beta4
kind: JoinConfiguration
patches:
directory: /home/user/somedir
该目录必须包含名为 target[suffix][+patchtype].extension
的文件。例如,kube-apiserver0+merge.yaml
或 etcd.json
。
target
可以是kube-apiserver
、kube-controller-manager
、kube-scheduler
、etcd
和kubeletconfiguration
之一。suffix
是一个可选字符串,可用于确定哪些补丁按字母数字顺序先应用。patchtype
可以是strategic
、merge
或json
之一,这些必须与 kubectl 支持的补丁格式 相匹配。默认的patchtype
为strategic
。extension
必须是json
或yaml
。
注意
如果您使用kubeadm upgrade
升级 kubeadm 节点,则必须再次提供相同的补丁,以便在升级后保留自定义设置。为此,您可以使用 --patches
标志,该标志必须指向同一个目录。kubeadm upgrade
目前不支持可以用于相同目的的配置 API 结构。自定义 kubelet
要自定义 kubelet,您可以在 ClusterConfiguration
或 InitConfiguration
旁边添加一个 KubeletConfiguration
,并使用同一个配置文件中的 ---
分隔它们。然后,您可以将此文件传递给 kubeadm init
,kubeadm 会将相同的基 KubeletConfiguration
应用于集群中的所有节点。
要对基 KubeletConfiguration
应用特定于实例的配置,您可以使用 kubeletconfiguration
补丁目标。
或者,您可以使用 kubelet 标志作为覆盖,通过将它们传递到 InitConfiguration
和 JoinConfiguration
都支持的 nodeRegistration.kubeletExtraArgs
字段。某些 kubelet 标志已弃用,因此在使用它们之前,请在 kubelet 参考文档 中检查其状态。
有关更多详细信息,请参阅 使用 kubeadm 配置集群中的每个 kubelet
自定义 kube-proxy
要自定义 kube-proxy,您可以将 KubeProxyConfiguration
传递到 ClusterConfiguration
或 InitConfiguration
旁边,并将它们传递给 kubeadm init
,并使用 ---
分隔它们。
有关更多详细信息,您可以导航到我们的 API 参考页面。