kubeadm config

kubeadm init 期间,kubeadm 会将 ClusterConfiguration 对象上传到您集群的 kube-system 命名空间中的名为 kubeadm-config 的 ConfigMap 中。此配置随后会在 kubeadm joinkubeadm resetkubeadm upgrade 期间读取。

您可以使用 kubeadm config print 打印 kubeadm 用于 kubeadm initkubeadm join 的默认静态配置。

有关 initjoin 的更多信息,请导航到 使用配置文件运行 kubeadm init使用配置文件运行 kubeadm join

有关使用 kubeadm 配置 API 的更多信息,请导航到 使用 kubeadm API 自定义组件

您可以使用 kubeadm config migrate 将包含已弃用 API 版本的旧配置文件转换为较新的受支持的 API 版本。

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

kubeadm config images listkubeadm config images pull 可用于列出和拉取 kubeadm 所需的镜像。

kubeadm config print

打印配置

概要

此命令打印为子命令提供的配置。有关详细信息,请参见:https://pkg.go.dev/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#section-directories

kubeadm config print [flags]

选项

-h, --help

print 的帮助信息

从父命令继承的选项

--kubeconfig string     默认值:"/etc/kubernetes/admin.conf"

与集群通信时要使用的 kubeconfig 文件。如果未设置此标志,则可以搜索一组标准位置以查找现有的 kubeconfig 文件。

--rootfs string

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

kubeadm config print init-defaults

打印默认的 init 配置,可用于“kubeadm init”

概要

此命令打印诸如用于“kubeadm init”的默认 init 配置之类的对象。

请注意,敏感值(如 Bootstrap Token 字段)将被替换为占位符值(如“abcdef.0123456789abcdef”),以通过验证,但不会执行创建令牌的实际计算。

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

打印默认的 join 配置,可用于“kubeadm join”

概要

此命令打印诸如用于“kubeadm join”的默认 join 配置之类的对象。

请注意,敏感值(如 Bootstrap Token 字段)将被替换为占位符值(如“abcdef.0123456789abcdef”),以通过验证,但不会执行创建令牌的实际计算。

kubeadm config print join-defaults [flags]

选项

-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

此外,kubeadm 只能写入版本为“kubeadm.k8s.io/v1beta3”的配置,但可以读取两种类型。因此,无论您在此处将什么版本传递给 --old-config 参数,API 对象都将在写入 stdout 或 --new-config(如果指定)时被读取、反序列化、设置默认值、转换、验证和重新序列化。

换句话说,此命令的输出是如果您将此文件提交给“kubeadm init”,kubeadm 在内部实际读取的内容。

kubeadm config migrate [flags]

选项

--allow-experimental-api

允许迁移到实验性的、未发布的 API。

-h, --help

migrate 的帮助信息

--new-config string

使用新 API 版本的等效 kubeadm 配置文件的路径。可选,如果未指定,则输出将发送到 STDOUT。

--old-config string

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

从父命令继承的选项

--kubeconfig string     默认值:"/etc/kubernetes/admin.conf"

与集群通信时要使用的 kubeconfig 文件。如果未设置此标志,则可以搜索一组标准位置以查找现有的 kubeconfig 文件。

--rootfs string

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

kubeadm config validate

读取包含 kubeadm 配置 API 的文件并报告任何验证问题

概要

此命令允许您验证 kubeadm 配置 API 文件并报告任何警告和错误。如果没有错误,则退出状态将为零,否则将为非零。任何反序列化问题(例如未知 API 字段)都将触发错误。未知 API 版本和具有无效值的字段也将触发错误。根据输入文件的内容,可能会报告任何其他错误或警告。

在此版本的 kubeadm 中,支持以下 API 版本

  • kubeadm.k8s.io/v1beta3
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 将使用的镜像列表。如果任何镜像或镜像存储库已自定义,则会使用配置文件。

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

描述各种功能的特性开关的键值对集。选项是
EtcdLearnerMode=true|false (BETA - 默认值=true)
PublicKeysECDSA=true|false (已弃用 - 默认值=false)
RootlessControlPlane=true|false (ALPHA - 默认值=false)
UpgradeAddonsBeforeControlPlane=true|false (已弃用 - 默认值=false)
WaitForAllControlPlaneComponents=true|false (ALPHA - 默认值=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 文件。如果未设置此标志,则可以搜索一组标准位置以查找现有的 kubeconfig 文件。

--rootfs string

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

kubeadm config images pull

拉取 kubeadm 使用的镜像

概要

拉取 kubeadm 使用的镜像

kubeadm config images pull [flags]

选项

--config string

指向 kubeadm 配置文件的路径。

--cri-socket string

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

--feature-gates string

描述各种功能的特性开关的键值对集。选项是
EtcdLearnerMode=true|false (BETA - 默认值=true)
PublicKeysECDSA=true|false (已弃用 - 默认值=false)
RootlessControlPlane=true|false (ALPHA - 默认值=false)
UpgradeAddonsBeforeControlPlane=true|false (已弃用 - 默认值=false)
WaitForAllControlPlaneComponents=true|false (ALPHA - 默认值=false)

-h, --help

pull 的帮助信息

--image-repository string     默认值: "registry.k8s.io"

选择一个容器注册表来从中拉取控制平面镜像。

--kubernetes-version string     默认值: "stable-1"

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

从父命令继承的选项

--kubeconfig string     默认值:"/etc/kubernetes/admin.conf"

与集群通信时要使用的 kubeconfig 文件。如果未设置此标志,则可以搜索一组标准位置以查找现有的 kubeconfig 文件。

--rootfs string

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

下一步

上次修改时间:2023 年 5 月 15 日下午 3:23 PST:kubeadm:添加“config validate”命令 (77e403d643)