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

打印帮助

从父命令继承的选项

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

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

--rootfs string

指向“真实”主机根文件系统的路径。这将导致 kubeadm chroot 进入提供的路径。

kubeadm config print init-defaults

打印可用于“kubeadm init”的默认初始化配置

概要

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

请注意,为了通过验证但不执行创建令牌的真实计算,Bootstrap 令牌字段等敏感值已替换为诸如“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 chroot 进入提供的路径。

kubeadm config print join-defaults

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

概要

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

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

kubeadm config print join-defaults [flags]

选项

-h, --help

join-defaults 帮助

从父命令继承的选项

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

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

--rootfs string

指向“真实”主机根文件系统的路径。这将导致 kubeadm chroot 进入提供的路径。

kubeadm config migrate

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

概要

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

  • kubeadm.k8s.io/v1beta4

此外,kubeadm 只能写出版本为“kubeadm.k8s.io/v1beta4”的配置,但可以读取两种类型。因此,无论你在此处传递给 --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 chroot 进入提供的路径。

kubeadm config validate

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

概要

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

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

  • kubeadm.k8s.io/v1beta4
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 chroot 进入提供的路径。

kubeadm config images list

打印 kubeadm 将使用的镜像列表。如果自定义了任何镜像或镜像仓库,则使用配置文件

概要

打印 kubeadm 将使用的镜像列表。如果自定义了任何镜像或镜像仓库,则使用配置文件

kubeadm config images list [flags]

选项

--allow-missing-template-keys     默认值: true

如果为 true,则当模板中缺少字段或映射键时,忽略模板中的任何错误。仅适用于 golang 和 jsonpath 输出格式。

--config string

kubeadm 配置文件的路径。

--feature-gates string

一组键值对,描述各种功能的特性门控。选项为
ControlPlaneKubeletLocalMode=true|false (ALPHA - 默认值=false)
EtcdLearnerMode=true|false (默认值=true)
PublicKeysECDSA=true|false (已弃用 - 默认值=false)
RootlessControlPlane=true|false (ALPHA - 默认值=false)
WaitForAllControlPlaneComponents=true|false (ALPHA - 默认值=false)

-h, --help

list 帮助

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

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

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

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

-o, --output string     默认值: "text"

输出格式。选项之一:text|json|yaml|go-template|go-template-file|template|templatefile|jsonpath|jsonpath-as-json|jsonpath-file。

--show-managed-fields

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

从父命令继承的选项

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

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

--rootfs string

指向“真实”主机根文件系统的路径。这将导致 kubeadm chroot 进入提供的路径。

kubeadm config images pull

拉取 kubeadm 使用的镜像

概要

拉取 kubeadm 使用的镜像

kubeadm config images pull [flags]

选项

--config string

kubeadm 配置文件的路径。

--cri-socket string

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

--feature-gates string

一组键值对,描述各种功能的特性门控。选项为
ControlPlaneKubeletLocalMode=true|false (ALPHA - 默认值=false)
EtcdLearnerMode=true|false (默认值=true)
PublicKeysECDSA=true|false (已弃用 - 默认值=false)
RootlessControlPlane=true|false (ALPHA - 默认值=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

指向“真实”主机根文件系统的路径。这将导致 kubeadm chroot 进入提供的路径。

下一步

最后修改于 2024 年 8 月 17 日下午 4:50 PST:更新对生成的页面的引用 (3b6f229424)