diff --git a/content/en/docs/reference/config-api/kubeadm-config.v1beta2.md b/content/en/docs/reference/config-api/kubeadm-config.v1beta2.md index 8874cf6a36..5d75df5b53 100644 --- a/content/en/docs/reference/config-api/kubeadm-config.v1beta2.md +++ b/content/en/docs/reference/config-api/kubeadm-config.v1beta2.md @@ -348,7 +348,7 @@ could be used for assigning a stable DNS to the control plane. string -

mageRepository sets the container registry to pull images from. +

imageRepository sets the container registry to pull images from. If empty, k8s.gcr.io will be used by default; in case of kubernetes version is a CI build (kubernetes version starts with ci/) gcr.io/k8s-staging-ci-images is used as a default for control plane components and for kube-proxy, while @@ -876,7 +876,7 @@ cluster information.

tlsBootstrapToken is a token used for TLS bootstrapping. -If bootstrapToken is set, this field is defaulted to .bootstrapToken.token, but can be overridden. If file` is set, this field must be set in case the KubeConfigFile does not +If bootstrapToken is set, this field is defaulted to .bootstrapToken.token, but can be overridden. If file is set, this field must be set in case the KubeConfigFile does not contain any other authentication information.

@@ -1080,7 +1080,7 @@ originated from the Kubernetes/Kubernetes release process

string -

mageRepository sets the container registry to pull images from. +

imageRepository sets the container registry to pull images from. If not set, the imageRepository defined in ClusterConfiguration will be used.

@@ -1267,7 +1267,7 @@ Defaults to the hostname of the node if not provided.

string -

`criSocket is used to retrieve container runtime information. This information will +

criSocket is used to retrieve container runtime information. This information will be annotated to the Node API object, for later re-use.

diff --git a/content/zh/docs/reference/config-api/kubeadm-config.v1beta2.md b/content/zh/docs/reference/config-api/kubeadm-config.v1beta2.md index a1a8bee01c..f34da9f473 100644 --- a/content/zh/docs/reference/config-api/kubeadm-config.v1beta2.md +++ b/content/zh/docs/reference/config-api/kubeadm-config.v1beta2.md @@ -445,7 +445,7 @@ node only (e.g. the node IP).

etcd 中包含 etcd 服务的配置。

@@ -633,7 +633,7 @@ ConfigMap 中,之后在新的控制面实例添加到集群或者现有控制 kind
stringClusterStatus apiEndpoints [必需]
-map[string]APIEndpoint +map[string]github.com/tengqm/kubeconfig/config/kubeadm/v1beta2.APIEndpoint - bindPort 设置 API 服务器要绑定到的安全端口。默认值为 6443。 +

bindPort 设置 API 服务器要绑定到的安全端口。默认值为 6443。

@@ -848,7 +848,7 @@ Defaults to 6443.

APIServer 包含集群中 API 服务器部署所必需的设置。

@@ -860,8 +860,17 @@ APIServer 包含集群中 API 服务器部署所必需的设置。 ControlPlaneComponent [必需]
ControlPlaneComponent -(ControlPlaneComponent 结构的字段被嵌入到此类型中) - 无描述 + + +(ControlPlaneComponent 结构的字段被嵌入到此类型中) + + + 无描述 + certSANs [必需]
[]string @@ -875,7 +884,7 @@ signing certificate.

timeoutForControlPlane [必需]
-meta/v1.Duration +meta/v1.Duration ttl [必需]
-meta/v1.Duration +meta/v1.Duration - -

ttl 定义此令牌的声明周期。默认为 24h。 +

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

@@ -1006,10 +1015,10 @@ BootstrapTokenDiscovery 用来设置基于引导令牌的服务发现选项。

- apiServerEndpoint

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

@@ -1022,14 +1031,13 @@ information will be fetched. caCertHashes specifies a set of public key pins to verify when token-based discovery is used. The root CA found during discovery must match one of these values. Specifying an empty set disables root CA pinning, which can be unsafe. -Each hash is specified as "<type>:<value>", where the only currently supported type is -"sha256". This is a hex-encoded SHA-256 hash of the Subject Public Key Info (SPKI) +Each hash is specified as "<\!-- raw HTML omitted -->: caCertHashes 设置一组在基于令牌来发现服务时要验证的公钥指纹。 发现过程中获得的根 CA 必须与这里的数值之一匹配。 设置为空集合意味着禁用根 CA 指纹,因而可能是不安全的。 -每个哈希值的形式为 "<type>:<value>",当前唯一支持的 type 为 +每个哈希值的形式为 ":",当前唯一支持的 type 为 "sha256"。 哈希值为主体公钥信息(Subject Public Key Info,SPKI)对象的 SHA-256 哈希值(十六进制编码),形式为 DER 编码的 ASN.1。 @@ -1046,9 +1054,9 @@ object in DER-encoded ASN.1. These hashes can be calculated using, for example, caCertHashes. This can weaken the security of kubeadm since other nodes can impersonate the control-plane.

--> - unsafeSkipCAVerification 允许在使用基于令牌的服务发现时不使用 +

unsafeSkipCAVerification 允许在使用基于令牌的服务发现时不使用 caCertHashes 来执行 CA 验证。这会弱化 kubeadm 的安全性, -因为其他节点可以伪装成控制面。 +因为其他节点可以伪装成控制面。

@@ -1063,11 +1071,11 @@ impersonate the control-plane.

- [BootstrapToken](#kubeadm-k8s-io-v1beta2-BootstrapToken) - -

BootstrapTokenString 形式为 abcdef.abcdef0123456789 的一个令牌, +

BootstrapTokenString 形式为 'abcdef.abcdef0123456789' 的一个令牌, 用来从加入集群的节点角度验证 API 服务器的身份,或者 "kubeadm join" 在节点启动引导是作为一种身份认证方法。 此令牌的生命期是短暂的,并且应该如此。

@@ -1120,7 +1128,7 @@ ControlPlaneComponent 中包含对集群中所有控制面组件都适用的设

@@ -1135,9 +1143,10 @@ without leading dash(es).

- extraVolumes 是一组额外的主机卷,需要挂载到控制面组件中。 + extraVolumes 是一组额外被挂载到控制面组件中的主机卷。

@@ -1178,7 +1187,9 @@ DNS 结构定义要在集群中使用的 DNS 插件。 ImageMeta [必需]
ImageMeta -(ImageMeta 的成员被内嵌到此类型中)。 + + +(ImageMeta 的成员被内嵌到此类型中)。

[必需]
-meta/v1.Duration +meta/v1.Duration

@@ -1368,7 +1379,7 @@ kubeadm 不清楚证书文件的存放位置,因此必须单独提供证书信

endpoints 包含一组 etcd 成员的列表。

@@ -1469,8 +1480,8 @@ file from which to load cluster information.

string - -

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

+ +

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

hostPath [必需]
@@ -1485,8 +1496,8 @@ file from which to load cluster information.

string - -

mountPathhostPath 在 Pod 内挂载的路径。

+ +

mountPath 是 hostPath 在 Pod 内挂载的路径。

readOnly [必需]
@@ -1501,8 +1512,8 @@ file from which to load cluster information.

core/v1.HostPathType - -

pathTypehostPath 的类型。

+ +

pathType 是 hostPath 的类型。

@@ -1533,7 +1544,7 @@ originated from the Kubernetes/Kubernetes release process +If not set, the imageRepository defined in ClusterConfiguration will be used.

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

@@ -1542,9 +1553,9 @@ If not set, the imageRepository defined in ClusterConfiguration wil string - +

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

@@ -1617,7 +1628,11 @@ Secret 中的证书的秘钥。对应的加密秘钥在 InitConfiguration 结构 ImageMeta [必需]
ImageMeta -(ImageMeta 结构的字段被嵌入到此类型中。) + + +(ImageMeta 结构的字段被嵌入到此类型中。) @@ -1642,11 +1657,11 @@ Defaults to "/var/lib/etcd".

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

+pod 中运行 etcd。映射中的每一个键对应命令行上的一个标志参数,只是去掉了前置的连字符。

serverCertSANs [必需]
@@ -1654,7 +1669,7 @@ Pod 中运行 etcd。映射中的每一个键对应命令行上的一个标志

serverCertSANs 为 etcd 服务器的签名证书设置额外的主体替代名 @@ -1699,9 +1714,9 @@ signing certificate.

-

serviceSubnet 是 Kubernetes 服务所使用的的子网。 +

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

@@ -1717,8 +1732,8 @@ signing certificate.

string - -

dnsDomain 是 Kubernetes 服务所使用的的 DNS 域名。 + +

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

@@ -1751,13 +1766,13 @@ node to the cluster, either via "kubeadm init" or "kubeadm join&q -

name 是 Node API 对象的 .metadata.name 字段值; +

name 是 Node API 对象的 .Metadata.Name 字段值; 该 API 对象会在此 kubeadm initkubeadm join 操作期间创建。 在提交给 API 服务器的 kubelet 客户端证书中,此字段也用作其 CommonName。 如果未指定则默认为节点的主机名。

@@ -1768,7 +1783,7 @@ Defaults to the hostname of the node if not provided.

criSocket 用来读取容器运行时的信息。 @@ -1780,15 +1795,15 @@ This information will be annotated to the Node API object, for later re-use

tains 设定 Node API 对象被注册时要附带的污点。 若未设置此字段(即字段值为 null), 在 kubeadm init 期间,节点与控制面之间的通信。 -默认值为污点默认设置为 taints: ["node-role.kubernetes.io/master:""]。 +默认值为污点默认设置为 taints: ['node-role.kubernetes.io/master:""']。 如果你不希望为控制面节点设置污点,可以在 YAML 中将此字段设置为空的列表,即 taints: []。 此字段仅用在 Node 注册期间。