kubeadm config

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

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

有关 `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

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 对象都将在写入标准输出或 --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: add the "config validate" command (77e403d643)