diff --git a/content/zh-cn/docs/reference/config-api/kubeadm-config.v1beta3.md b/content/zh-cn/docs/reference/config-api/kubeadm-config.v1beta3.md index e5af2a42506..ed2534f4e86 100644 --- a/content/zh-cn/docs/reference/config-api/kubeadm-config.v1beta3.md +++ b/content/zh-cn/docs/reference/config-api/kubeadm-config.v1beta3.md @@ -2,7 +2,6 @@ title: kubeadm 配置 (v1beta3) content_type: tool-reference package: kubeadm.k8s.io/v1beta3 -auto_generated: true --- +

BootstrapToken 描述的是一个启动引导令牌,以 Secret 形式存储在集群中。

@@ -467,9 +468,11 @@ node only (e.g. the node ip).

BootstrapTokenString @@ -477,8 +480,10 @@ Used for joining nodes in the cluster.string @@ -487,8 +492,10 @@ for, so other administrators can know its purpose.meta/v1.Duration @@ -497,8 +504,10 @@ for, so other administrators can know its purpose.meta/v1.Time @@ -518,8 +529,10 @@ for establishing bidirectional trust, but that can be changed here.[]string @@ -535,10 +548,12 @@ used for authentication - [BootstrapToken](#BootstrapToken) - +"kubeadm join". This token is and should be short-lived. +-->

BootstrapTokenString 形式为 abcdef.abcdef0123456789 的一个令牌, 用来从加入集群的节点角度验证 API 服务器的身份,或者 "kubeadm join" 在节点启动引导是作为一种身份认证方法。 @@ -552,8 +567,7 @@ of view and as an authentication method for the node in the bootstrap phase of

+ 无描述。 +
- -

token 用来在节点与控制面之间建立双向的信任关系。 + +

token 用来在节点与控制面之间建立双向的信任关系。 在向集群中添加节点时使用。

- +

description 设置一个对人友好的消息,说明为什么此令牌 会存在以及其目标用途,这样其他管理员能够知道其目的。

- +

ttl 定义此令牌的声明周期。默认为 24hexpiresttl 是互斥的。

- +

expires 设置此令牌过期的时间戳。默认为在运行时基于 ttl 来决定。 expiresttl 是互斥的。

@@ -508,8 +517,10 @@ dynamically at runtime based on the ttl. expires and < []string
- +

usages 描述此令牌的可能使用方式。默认情况下,令牌可用于 建立双向的信任关系;不过这里可以改变默认用途。

- +

groups 设定此令牌被用于身份认证时对应的附加用户组。

- 无描述 - + 无描述。
- [必需]
@@ -561,7 +575,8 @@ of view and as an authentication method for the node in the bootstrap phase of
- 无描述
@@ -1023,11 +1038,16 @@ APIServer 包含集群中 API 服务器部署所必需的设置。 字段描述 -ControlPlaneComponent [必需]-->[必需]
+ControlPlaneComponent [必需]
ControlPlaneComponent -(ControlPlaneComponent 结构的字段被嵌入到此类型中) - 无描述. + + +(ControlPlaneComponent 结构的字段被嵌入到此类型中。) + + 无描述。 certSANs
@@ -1077,7 +1097,7 @@ BootstrapTokenDiscovery 用来设置基于引导令牌的服务发现选项。 字段描述 -token [必需]-->[必需]
+token [必需]
string @@ -1095,10 +1115,10 @@ BootstrapTokenDiscovery 用来设置基于引导令牌的服务发现选项。

- apiServerEndpoint

为 API 服务器的 IP 地址或者域名,从该端点可以获得集群信息。 + apiServerEndpoint 为 API 服务器的 IP 地址或者域名,从该端点可以获得集群信息。

@@ -1287,12 +1307,12 @@ cluster information. tlsBootstrapToken 是 TLS 启动引导过程中使用的令牌。 如果设置了 bootstrapToken,则此字段默认值为 .bootstrapToken.token,不过可以被重载。 -如果设置了 file,此字段必须被设置,以防 kubeconfig 文件 +如果设置了 file,此字段必须被设置,以防 kubeconfig 文件 中不包含其他身份认证信息。

@@ -1475,7 +1495,9 @@ file from which to load cluster information.

- [ControlPlaneComponent](#kubeadm-k8s-io-v1beta3-ControlPlaneComponent) - +

HostPathMount 包含从宿主节点挂载的卷的信息。 @@ -1486,7 +1508,9 @@ file from which to load cluster information.

string @@ -1494,7 +1518,9 @@ file from which to load cluster information.

string @@ -1502,7 +1528,9 @@ file from which to load cluster information.

string @@ -1510,15 +1538,19 @@ file from which to load cluster information.

bool @@ -1535,8 +1567,10 @@ file from which to load cluster information.

- [DNS](#kubeadm-k8s-io-v1beta3-DNS) - [LocalEtcd](#kubeadm-k8s-io-v1beta3-LocalEtcd) - +

ImageMeta 用来配置来源不是 Kubernetes/kubernetes 发布过程的组件所使用的镜像。

@@ -1548,8 +1582,10 @@ originated from the Kubernetes/Kubernetes release processstring @@ -1558,9 +1594,11 @@ If not set, the imageRepository defined in ClusterConfiguration wil string @@ -1577,8 +1615,10 @@ the above components during upgrades. - [JoinConfiguration](#kubeadm-k8s-io-v1beta3-JoinConfiguration) - +

JoinControlPlane 包含在正在加入集群的节点上要部署的额外的控制面组件的 设置。

@@ -1590,8 +1630,10 @@ to be deployed on the joining node.APIEndpoint @@ -1600,9 +1642,11 @@ deployed on this node.string @@ -1619,7 +1663,9 @@ Secret 中的证书的秘钥。对应的加密秘钥在 InitConfiguration 结构 - [Etcd](#kubeadm-k8s-io-v1beta3-Etcd) - +

LocalEtcd 描述的是 kubeadm 要使用的本地 etcd 集群。

- +

name 为卷在 Pod 模板中的名称。

- +

hostPath 是要在 Pod 中挂载的卷在宿主系统上的路径。

- +

mountPathhostPath 在 Pod 内挂载的路径。

- +

readOnly 控制卷的读写访问模式。

pathType
-core/v1.HostPathType +core/v1.HostPathType
- +

pathTypehostPath 的类型。

- +

imageRepository 设置镜像拉取所用的容器仓库。 若未设置,则使用 ClusterConfiguration 中的 imageRepository

- +the above components during upgrades. + -->

imageTag 允许用户设置镜像的标签。 如果设置了此字段,则 kubeadm 不再在集群升级时自动更改组件的版本。

- +

localAPIEndpoint 代表的是将在此节点上部署的 API 服务器实例 的端点。

- +The corresponding encryption key is in the InitConfiguration. + -->

certificateKey 是在添加新的控制面节点时用来解密所下载的 Secret 中的证书的秘钥。对应的加密秘钥在 InitConfiguration 结构中。

@@ -1634,7 +1680,9 @@ Secret 中的证书的秘钥。对应的加密秘钥在 InitConfiguration 结构 (Members of ImageMeta are embedded into this type.) --> (ImageMeta 结构的字段被嵌入到此类型中。) - +

ImageMeta 允许用户为 etcd 定制要使用的容器。

@@ -1642,8 +1690,10 @@ Secret 中的证书的秘钥。对应的加密秘钥在 InitConfiguration 结构 string @@ -1652,9 +1702,11 @@ Defaults to "/var/lib/etcd".map[string]string @@ -1674,8 +1728,10 @@ server signing certificate.[]string @@ -1692,7 +1748,9 @@ signing certificate. - [ClusterConfiguration](#kubeadm-k8s-io-v1beta3-ClusterConfiguration) - +

Networking 中包含描述集群网络配置的元素。

- +

dataDir 是 etcd 用来存放数据的目录。 默认值为 "/var/lib/etcd"。

- +command line except without leading dash(es). + -->

extraArgs 是为 etcd 可执行文件提供的额外参数,用于在静态 Pod 中运行 etcd。映射中的每一个键对应命令行上的一个标志参数,只是去掉了 前置的连字符。

@@ -1664,8 +1716,10 @@ Pod 中运行 etcd。映射中的每一个键对应命令行上的一个标志 []string
- +

serverCertSANs 为 etcd 服务器的签名证书设置额外的 主体替代名(Subject Alternative Names,SAN)。

- +

peerCertSANs 为 etcd 的对等端签名证书设置额外的 主体替代名(Subject Alternative Names,SAN)。

@@ -1703,7 +1761,9 @@ signing certificate.string @@ -1712,7 +1772,9 @@ signing certificate.string @@ -1720,7 +1782,9 @@ signing certificate.string @@ -1738,8 +1802,10 @@ signing certificate. - [InitConfiguration](#kubeadm-k8s-io-v1beta3-InitConfiguration) - [JoinConfiguration](#kubeadm-k8s-io-v1beta3-JoinConfiguration) - +

NodeRegistrationOptions 包含向集群中注册新的控制面或节点所需要的信息; 节点注册可能通过 "kubeadm init" 或 "kubeadm join" 完成。

@@ -1751,11 +1817,13 @@ node to the cluster, either via "kubeadm init" or "kubeadm join&q string @@ -1793,13 +1862,15 @@ i.e. taints: [] in the YAML file. This field is solely used for Nod map[string]string @@ -1823,11 +1896,13 @@ the current node is registered.core/v1.PullPolicy
- +

serviceSubnet 是 Kubernetes 服务所使用的的子网。 默认值为 "10.96.0.0/12"。

- +

podSubnet 为 Pod 所使用的子网。

- +

dnsDomain 是 Kubernetes 服务所使用的的 DNS 域名。 默认值为 "cluster.local"。

- +Defaults to the hostname of the node if not provided. + -->

name 是 Node API 对象的 .metadata.name 字段值; 该 API 对象会在此 kubeadm initkubeadm join 操作期间创建。 在提交给 API 服务器的 kubelet 客户端证书中,此字段也用作其 CommonName。 @@ -1766,25 +1834,26 @@ Defaults to the hostname of the node if not provided. string

- +

criSocket 用来读取容器运行时的信息。 此信息会被以注解的方式添加到 Node API 对象至上,用于后续用途。

taints [必需]
-[]core/v1.Taint +[]core/v1.Taint
- +i.e. taints: [] in the YAML file. This field is solely used for Node registration. + -->

taints 设定 Node API 对象被注册时要附带的污点。 -若未设置此字段(即字段值为 null),在 kubeadm init 期间,默认为控制平面节点添加控制平面污点。 +若未设置此字段(即字段值为 null),默认为控制平面节点添加控制平面污点。 如果你不想污染你的控制平面节点,可以将此字段设置为空列表(即 YAML 文件中的 taints: []), 这个字段只用于节点注册。

- +command line except without leading dash(es). + -->

kubeletExtraArgs 用来向 kubelet 传递额外参数。 这里的参数会通过 kubeadm 在运行时写入的、由 kubelet 来读取的环境文件来 传递给 kubelet 命令行。 @@ -1813,8 +1884,10 @@ command line except without leading dash(es). []string

- +

ignorePreflightErrors 提供一组在当前节点被注册时可以 忽略掉的预检错误。

- +images if not present on the host. + -->

imagePullPolicy 设定 "kubeadm init" 和 "kubeadm join" 操作期间的镜像拉取策略。此字段的取值可以是 "Always"、"IfNotPresent" 或 "Never" 之一。 @@ -1845,9 +1920,12 @@ images if not present on the host. --> **出现在:** +- [InitConfiguration](#kubeadm-k8s-io-v1beta3-InitConfiguration) - [JoinConfiguration](#kubeadm-k8s-io-v1beta3-JoinConfiguration) - +

Patches 包含要向 kubeadm 所部署的组件应用的补丁信息。

@@ -1858,7 +1936,8 @@ images if not present on the host.string
- +first alpha-numerically. + -->

directory 是指向某目录的路径,该目录中包含名为 "target[suffix][+patchtype].extension" 的文件。 例如,"kube-apiserver0+merge.yaml" 或者 "etcd.json"。