kubeadm config

在 kubeadm init 执行期间，kubeadm 将 ClusterConfiguration 对象上传 到你的集群的 kube-system 名字空间下名为 kubeadm-config 的 ConfigMap 对象中。 然后在 kubeadm join、kubeadm reset 和 kubeadm upgrade 执行期间读取此配置。

你可以使用 kubeadm config print 命令打印默认静态配置， kubeadm 运行 kubeadm init and kubeadm join 时将使用此配置。

说明： 此命令的输出旨在作为示例。你必须手动编辑此命令的输出来适配你的设置。 删除你不确定的字段，kubeadm 将通过检查主机来尝试在运行时给它们设默认值。

更多有关 init 和 join 的信息请浏览使用带配置文件的 kubeadm init 或使用带配置文件的 kubeadm join。

有关使用 kubeadm 的配置 API 的更多信息， 请浏览使用 kubeadm API 来自定义组件。

你可以使用 kubeadm config migrate 来转换旧配置文件， 把其中已弃用的 API 版本更新为受支持的 API 版本。

kubeadm config validate 可用于验证配置文件。

kubeadm config images list 和 kubeadm config images pull 可以用来列出和拉取 kubeadm 所需的镜像。

kubeadm config print

打印配置

概要

此命令打印子命令所提供的配置信息。相关细节可参阅： https://pkg.go.dev/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#section-directories

  1. kubeadm config print [flags]

选项

-h, —help

print 命令的帮助信息。

从父命令继承而来的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

与集群通信时使用的 kubeconfig 文件。如此标志未设置，将在一组标准位置中搜索现有的 kubeconfig 文件。

—rootfs string

[实验] 到 ‘真实’ 主机根文件系统的路径。

kubeadm config print init-defaults

打印用于 ‘kubeadm init’ 的默认 init 配置。

概要

此命令打印对象，例如用于 ‘kubeadm init’ 的默认 init 配置对象。

请注意，Bootstrap Token 字段之类的敏感值已替换为 “abcdef.0123456789abcdef” 之类的占位符值以通过验证，但不执行创建令牌的实际计算。

  1. kubeadm config print init-defaults [flags]

选项

—component-configs strings

以逗号分隔的组件配置 API 对象的列表，打印其默认值。可用值：[KubeProxyConfiguration KubeletConfiguration]。 如果未设置此参数，则不会打印任何组件配置。

-h, —help

init-defaults 操作的帮助命令。

从父命令继承的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

与集群通信时使用的 kubeconfig 文件。如果未设置该参数，则可以在一组标准位置中搜索现有的 kubeconfig 文件。

—rootfs string

[实验] 到 ‘真实’ 主机根文件系统的路径。

kubeadm config print join-defaults

打印默认的节点添加配置，该配置可用于 ‘kubeadm join’ 命令。

概要

此命令打印对象，例如用于 ‘kubeadm join’ 的默认 join 配置对象。

请注意，诸如启动引导令牌字段之类的敏感值已替换为 “abcdef.0123456789abcdef” 之类的占位符值以通过验证， 但不执行创建令牌的实际计算。

  1. kubeadm config print join-defaults [flags]

选项

—component-configs strings/td>

以逗号分隔的组件配置 API 对象的列表，打印其默认值。可用值：[KubeProxyConfiguration KubeletConfiguration]。 如果未设置此参数，则不会打印任何组件配置。

-h, —help

join-defaults 操作的帮助命令。

从父命令继承的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

与集群通信时使用的 kubeconfig 文件。如果未设置该参数，则可以在一组标准位置中搜索现有的 kubeconfig 文件。

—rootfs string

[实验] 到 ‘真实’ 主机根文件系统的路径。

kubeadm config migrate

从文件中读取旧版本的 kubeadm 配置的 API 类型，并为新版本输出类似的配置对象

概要

此命令允许你在 CLI 工具中将本地旧版本的配置对象转换为最新支持的版本，而无需变更集群中的任何内容。 在此版本的 kubeadm 中，支持以下 API 版本：

  • kubeadm.k8s.io/v1beta3

因此，无论你在此处传递 —old-config 参数的版本是什么，当写入到 stdout 或 —new-config （如果已指定）时， 都会读取、反序列化、默认、转换、验证和重新序列化 API 对象。

换句话说，如果你将此文件传递给 “kubeadm init”，则该命令的输出就是 kubeadm 实际上在内部读取的内容。

  1. kubeadm config migrate [flags]

选项

-h, —help

migrate 操作的帮助信息。

—new-config string

使用新的 API 版本生成的 kubeadm 配置文件的路径。这个路径是可选的。如果没有指定，输出将被写到 stdout。

—old-config string

使用旧 API 版本且应转换的 kubeadm 配置文件的路径。此参数是必需的。

从父命令继承的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

用于和集群通信的 kubeconfig 文件。如果未设置，那么 kubeadm 将会搜索一个已经存在于标准路径的 kubeconfig 文件。

—rootfs string

[实验] 到 ‘真实’ 主机根文件系统的路径。

kubeadm config validate

读取包含 kubeadm 配置 API 的文件，并报告所有验证问题。

概要

这个命令允许你验证 kubeadm 配置 API 文件并报告所有警告和错误。 如果没有错误，退出状态将为零；否则，将为非零。 诸如未知 API 字段等任何解包问题都会触发错误。 未知的 API 版本和具有无效值的字段也会触发错误。 根据输入文件的内容，可能会报告任何其他错误或警告。

在这个版本的 kubeadm 中，支持以下 API 版本：

  • kubeadm.k8s.io/v1beta3
  1. kubeadm config validate [flags]

选项

—allow-experimental-api

允许验证试验性的、未发布的 API。

—config string

指向 kubeadm 配置文件的路径。

-h, —help

validate 的帮助命令。

从父命令继承而来的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

在与集群通信时要使用的 kubeconfig 文件。 如果此标志未被设置，则会在一组标准位置中搜索现有的 kubeconfig 文件。

—rootfs string

[试验性] 指向“真实”主机根文件系统的路径。

kubeadm config images list

打印 kubeadm 要使用的镜像列表。配置文件用于自定义镜像或镜像存储库。

概要

打印 kubeadm 要使用的镜像列表。配置文件用于自定义镜像或镜像存储库。

  1. kubeadm config images list [flags]

选项

—allow-missing-template-keys     默认值：true

如果设置为 true，则在模板中缺少字段或哈希表的键时忽略模板中的任何错误。 仅适用于 golang 和 jsonpath 输出格式。

—config string

kubeadm 配置文件的路径。

-o, —experimental-output string     默认值：”text”

输出格式：text|json|yaml|go-template|go-template-file|template|templatefile|jsonpath|jsonpath-as-json|jsonpath-file 其中之一。

—feature-gates string

一组键值对（key=value），用于描述各种特性。这些选项是：
EtcdLearnerMode=true|false (ALPHA - 默认值=false)
PublicKeysECDSA=true|false (ALPHA - 默认值=false)
RootlessControlPlane=true|false (ALPHA - 默认值=false)
UpgradeAddonsBeforeControlPlane=true|false (DEPRECATED - 默认值=false)

-h, —help

list 操作的帮助命令。

—image-repository string     默认值：”registry.k8s.io”

选择要从中拉取控制平面镜像的容器仓库。

—kubernetes-version string     默认值：”stable-1”

为控制平面选择一个特定的 Kubernetes 版本。

—show-managed-fields

如果为 true，则在以 JSON 或 YAML 格式打印对象时保留 managedFields。

从父命令继承的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

用于和集群通信的 kubeconfig 文件。如果它没有被设置，那么 kubeadm 将会搜索一个已经存在于标准路径的 kubeconfig 文件。

—rootfs string

[实验] 到“真实”主机根文件系统的路径。

kubeadm config images pull

拉取 kubeadm 使用的镜像。

概要

拉取 kubeadm 使用的镜像。

  1. kubeadm config images pull [flags]

选项

—config string

kubeadm 配置文件的路径。

—cri-socket string

要连接的 CRI 套接字的路径。如果为空，则 kubeadm 将尝试自动检测此值；仅当安装了多个 CRI 或具有非标准 CRI 插槽时，才使用此选项。

—feature-gates string
一系列键值对（key=value），用于描述各种特性。可选项是：
EtcdLearnerMode=true|false (ALPHA - 默认值=false)
PublicKeysECDSA=true|false (ALPHA - 默认值=false)
RootlessControlPlane=true|false (ALPHA - 默认值=false)
UpgradeAddonsBeforeControlPlane=true|false (DEPRECATED - 默认值=false)
-h, —help

pull 操作的帮助命令。

—image-repository string     默认值：”registry.k8s.io”

选择用于拉取控制平面镜像的容器仓库。

—kubernetes-version string     默认值：”stable-1”

为控制平面选择一个特定的 Kubernetes 版本。

从父命令继承的选项

—kubeconfig string     默认值：”/etc/kubernetes/admin.conf”

用于和集群通信的 kubeconfig 文件。如果它没有被设置，那么 kubeadm 将会搜索一个已经存在于标准路径的 kubeconfig 文件。

—rootfs string

[实验] 到 ‘真实’ 主机根文件系统的路径。

接下来

  • kubeadm upgrade 将 Kubernetes 集群升级到更新版本 [kubeadm upgrade]