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

打印帮助

从父命令继承的选项

--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)