kubeadm config

kubeadm init 期间,kubeadm 将 ClusterConfiguration 对象作为名为 kubeadm-config 的 ConfigMap 上传到集群的 kube-system 命名空间中。随后,在 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 chroot 到指定的路径中。

kubeadm config print init-defaults

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

概要

此命令打印默认初始化配置等对象,这些配置用于 'kubeadm init'。

请注意,Bootstrap Token 字段等敏感值已替换为占位符值,例如“abcdef.0123456789abcdef”,以便通过验证,但不执行创建 token 的实际计算。

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 Token 字段等敏感值已替换为占位符值,例如“abcdef.0123456789abcdef”,以便通过验证,但不执行创建 token 的实际计算。

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 参数的是哪个版本,当写入标准输出或指定了 --new-config 时,都会读取、反序列化、设置默认值、转换、验证并重新序列化该 API 对象。

换句话说,此命令的输出就是如果你将此文件提交给 "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,则在模板中缺少字段或 map key 时忽略模板中的任何错误。仅适用于 golang 和 jsonpath 输出格式。

--config string

kubeadm 配置文件的路径。

--feature-gates string

一组描述各种特性门控的键值对。选项如下:
ControlPlaneKubeletLocalMode=true|false (测试版 - 默认值=true)
NodeLocalCRISocket=true|false (Alpha 版 - 默认值=false)
PublicKeysECDSA=true|false (已弃用 - 默认值=false)
RootlessControlPlane=true|false (Alpha 版 - 默认值=false)
WaitForAllControlPlaneComponents=true|false (测试版 - 默认值=true)

-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 socket 路径。如果为空,kubeadm 将尝试自动检测此值;仅当你安装了多个 CRI 或拥有非标准 CRI socket 时才使用此选项。

--feature-gates string

一组描述各种特性门控的键值对。选项如下:
ControlPlaneKubeletLocalMode=true|false (测试版 - 默认值=true)
NodeLocalCRISocket=true|false (Alpha 版 - 默认值=false)
PublicKeysECDSA=true|false (已弃用 - 默认值=false)
RootlessControlPlane=true|false (Alpha 版 - 默认值=false)
WaitForAllControlPlaneComponents=true|false (测试版 - 默认值=true)

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