Skip to content

Commit de7d373

Browse files
committed
[zh-cn]sync kubeadm-upgrade-phase topology-manager service-accounts
Signed-off-by: xin.li <xin.li@daocloud.io>
1 parent c9a480c commit de7d373

File tree

3 files changed

+70
-32
lines changed

3 files changed

+70
-32
lines changed

‎content/zh-cn/docs/concepts/security/service-accounts.md

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -381,9 +381,19 @@ You can also use TokenRequest to obtain short-lived tokens for your external app
381381
{{< /note >}}
382382

383383
<!--
384-
### Restricting access to Secrets {#enforce-mountable-secrets}
384+
### Restricting access to Secrets (deprecated) {#enforce-mountable-secrets}
385385
-->
386-
### 限制对 Secret 的访问 {#enforce-mountable-secrets}
386+
### 限制对 Secret 的访问(已弃用) {#enforce-mountable-secrets}
387+
388+
{{< feature-state for_k8s_version="v1.32" state="deprecated" >}}
389+
390+
{{< note >}}
391+
<!--
392+
`kubernetes.io/enforce-mountable-secrets` is deprecated since Kubernetes v1.32. Use separate namespaces to isolate access to mounted secrets.
393+
-->
394+
`kubernetes.io/enforce-mountable-secrets` 自 Kubernetes v1.32 起已弃用。
395+
你可以使用单独的命名空间来隔离对挂载 Secret 的访问。
396+
{{< /note >}}
387397

388398
<!--
389399
Kubernetes provides an annotation called `kubernetes.io/enforce-mountable-secrets`
@@ -425,7 +435,8 @@ the Secrets from this ServiceAccount are subject to certain mounting restriction
425435
1. The name of each Secret referenced using `envFrom` in a Pod must also appear in the `secrets`
426436
field of the Pod's ServiceAccount.
427437
-->
428-
2. 在 Pod 中使用 `envFrom` 引用的每个 Secret 的名称也必须列在该 Pod 中 ServiceAccount 的 `secrets` 字段中。
438+
2. 在 Pod 中使用 `envFrom` 引用的每个 Secret 的名称也必须列在该 Pod 中
439+
ServiceAccount 的 `secrets` 字段中。
429440

430441
<!--
431442
1. The name of each Secret referenced using `imagePullSecrets` in a Pod must also appear in the `secrets`
@@ -456,7 +467,7 @@ acting as a ServiceAccount tries to communicate with the Kubernetes API server,
456467
the client includes an `Authorization: Bearer <token>` header with the HTTP
457468
request. The API server checks the validity of that bearer token as follows:
458469
-->
459-
ServiceAccount 使用签名的 JSON Web Token (JWT) 来向 Kubernetes API
470+
ServiceAccount 使用签名的 JSON Web TokenJWT来向 Kubernetes API
460471
服务器以及任何其他存在信任关系的系统进行身份认证。根据令牌的签发方式
461472
(使用 `TokenRequest` 限制时间或使用传统的 Secret 机制),ServiceAccount
462473
令牌也可能有到期时间、受众和令牌**开始**生效的时间点。
@@ -577,8 +588,8 @@ used in your application and nowhere else.
577588
* [Use the CertificateSigningRequest API with client certificates](/docs/tasks/tls/managing-tls-in-a-cluster/).
578589
-->
579590
* 从集群外部向 API 服务器进行身份认证,而不使用服务账号令牌:
580-
* [配置 API 服务器接受来自你自己的身份驱动的 OpenID Connect (OIDC) 令牌](/zh-cn/docs/reference/access-authn-authz/authentication/#openid-connect-tokens)。
581-
* 使用来自云提供商等外部身份和访问管理 (IAM) 服务创建的服务账号或用户账号向集群进行身份认证。
591+
* [配置 API 服务器接受来自你自己的身份驱动的 OpenID ConnectOIDC令牌](/zh-cn/docs/reference/access-authn-authz/authentication/#openid-connect-tokens)。
592+
* 使用来自云提供商等外部身份和访问管理IAM服务创建的服务账号或用户账号向集群进行身份认证。
582593
* [使用 CertificateSigningRequest API 和客户端证书](/zh-cn/docs/tasks/tls/managing-tls-in-a-cluster/)。
583594

584595
<!--
@@ -587,7 +598,7 @@ used in your application and nowhere else.
587598
then allows authentication using a private key.
588599
-->
589600
* [配置 kubelet 从镜像仓库中获取凭据](/zh-cn/docs/tasks/administer-cluster/kubelet-credential-provider/)。
590-
* 使用设备插件访问虚拟的可信平台模块 (TPM),进而可以使用私钥进行身份认证。
601+
* 使用设备插件访问虚拟的可信平台模块TPM,进而可以使用私钥进行身份认证。
591602

592603
## {{% heading "whatsnext" %}}
593604

‎content/zh-cn/docs/reference/setup-tools/kubeadm/kubeadm-upgrade-phase.md

Lines changed: 26 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,49 @@
11
---
2-
title: kubeadm upgrade phase
3-
weight: 90
2+
title: kubeadm upgrade phases
3+
weight: 40
44
content_type: concept
55
---
66

77
<!--
8-
In v1.15.0, kubeadm introduced preliminary support for `kubeadm upgrade node` phases.
9-
Phases for other `kubeadm upgrade` sub-commands such as `apply`, could be added in the
10-
following releases.
8+
## kubeadm upgrade apply phase {#cmd-apply-phase}
9+
10+
Using the phases of `kubeadm upgrade apply`, you can choose to execute the separate steps of the initial upgrade
11+
of a control plane node.
1112
-->
12-
在 Kubernetes v1.15.0 版本中,kubeadm 引入了对 `kubeadm upgrade node` 阶段的初步支持。
13-
其他 `kubeadm upgrade` 子命令如 `apply` 等阶段将在未来发行版中添加。
13+
## kubeadm upgrade apply 阶段 {#cmd-apply-phase}
14+
15+
使用 `kubeadm upgrade apply` 的各个阶段,
16+
你可以选择执行控制平面节点初始升级的单独步骤。
17+
18+
{{< tabs name="tab-phase" >}}
19+
{{< tab name="phase" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase.md" />}}
20+
{{< tab name="preflight" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_preflight.md" />}}
21+
{{< tab name="control-plane" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_control-plane.md" />}}
22+
{{< tab name="upload-config" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_upload-config.md" />}}
23+
{{< tab name="kubelet-config" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_kubelet-config.md" />}}
24+
{{< tab name="bootstrap-token" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_bootstrap-token.md" />}}
25+
{{< tab name="addon" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_addon.md" />}}
26+
{{< tab name="post-upgrade" include="generated/kubeadm_upgrade/kubeadm_upgrade_apply_phase_post-upgrade.md" />}}
27+
{{< /tabs >}}
1428

1529
<!--
1630
## kubeadm upgrade node phase {#cmd-node-phase}
1731
-->
1832
## kubeadm upgrade node 阶段 {#cmd-node-phase}
1933

2034
<!--
21-
Using this phase you can choose to execute the separate steps of the upgrade of
22-
secondary control-plane or worker nodes. Please note that `kubeadm upgrade apply` still has to
23-
be called on a primary control-plane node.
35+
Using the phases of `kubeadm upgrade node` you can choose to execute the separate steps of the upgrade of
36+
secondary control-plane or worker nodes.
2437
-->
25-
使用此阶段,你可以选择执行辅助控制平面或工作节点升级的单独步骤。
26-
请注意,`kubeadm upgrade apply` 命令仍然必须在主控制平面节点上调用。
38+
使用 `kubeadm upgrade node` 的各个阶段,你可以选择执行次要控制平面节点或工作节点升级的单独步骤。
2739

2840
{{< tabs name="tab-phase" >}}
2941
{{< tab name="phase" include="generated/kubeadm_upgrade/kubeadm_upgrade_node_phase.md" />}}
3042
{{< tab name="preflight" include="generated/kubeadm_upgrade/kubeadm_upgrade_node_phase_preflight.md" />}}
3143
{{< tab name="control-plane" include="generated/kubeadm_upgrade/kubeadm_upgrade_node_phase_control-plane.md" />}}
3244
{{< tab name="kubelet-config" include="generated/kubeadm_upgrade/kubeadm_upgrade_node_phase_kubelet-config.md" />}}
45+
{{< tab name="addon" include="generated/kubeadm_upgrade/kubeadm_upgrade_node_phase_addon.md" />}}
46+
{{< tab name="post-upgrade" include="generated/kubeadm_upgrade/kubeadm_upgrade_node_phase_post-upgrade.md" />}}
3347
{{< /tabs >}}
3448

3549
## {{% heading "whatsnext" %}}

‎content/zh-cn/docs/tasks/administer-cluster/topology-manager.md

Lines changed: 26 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -92,13 +92,27 @@ the pod can be accepted or rejected from the node based on the selected hint.
9292
The hint is then stored in the Topology Manager for use by the *Hint Providers* when making the
9393
resource allocation decisions.
9494
-->
95-
拓扑管理器从 **建议提供者** 接收拓扑信息,作为表示可用的 NUMA 节点和首选分配指示的位掩码。
95+
拓扑管理器从**建议提供者**接收拓扑信息,作为表示可用的 NUMA 节点和首选分配指示的位掩码。
9696
拓扑管理器策略对所提供的建议执行一组操作,并根据策略对提示进行约减以得到最优解。
9797
如果存储了与预期不符的建议,则该建议的优选字段将被设置为 false。
9898
在当前策略中,首选是最窄的优选掩码。
9999
所选建议将被存储为拓扑管理器的一部分。
100100
取决于所配置的策略,所选建议可用来决定节点接受或拒绝 Pod。
101-
之后,建议���被存储在拓扑管理器中,供 **建议提供者** 在作资源分配决策时使用。
101+
之后,建议会被存储在拓扑管理器中,供**建议提供者**在作资源分配决策时使用。
102+
103+
<!--
104+
## Windows Support
105+
-->
106+
## Windows 支持
107+
108+
{{< feature-state feature_gate_name="WindowsCPUAndMemoryAffinity" >}}
109+
110+
<!--
111+
The Topology Manager support can be enabled on Windows by using the `WindowsCPUAndMemoryAffinity` feature gate and
112+
it requires support in the container runtime.
113+
-->
114+
拓扑管理器支持可以通过使用 `WindowsCPUAndMemoryAffinity` 特性门控在 Windows 上启用,
115+
并且需要容器运行时的支持。
102116

103117
<!--
104118
## Topology manager scopes and policies
@@ -321,7 +335,7 @@ will result with **the same** topology alignment decision.
321335
-->
322336
如果拓扑管理器配置使用 **pod** 作用域,
323337
那么在策略评估一个容器时,该容器反映的是整个 Pod 的要求,
324-
所以该 Pod 里的每个容器都会应用 **相同的** 拓扑对齐决策。
338+
所以该 Pod 里的每个容器都会应用**相同的**拓扑对齐决策。
325339
{{< /note >}}
326340

327341
<!--
@@ -403,7 +417,7 @@ admission failure.
403417
对于 Pod 中的每个容器,配置了 `single-numa-node` 拓扑管理策略的
404418
kubelet 调用每个建议提供者以确定其资源可用性。
405419
使用此信息,拓扑管理器确定是否支持单 NUMA 节点亲和性。
406-
如果支持,则拓扑管理器将存储此信息,然后 **建议提供者** 可以在做出资源分配决定时使用此信息。
420+
如果支持,则拓扑管理器将存储此信息,然后**建议提供者**可以在做出资源分配决定时使用此信息。
407421
如果不支持,则拓扑管理器将拒绝 Pod 运行于该节点。
408422
这将导致 Pod 处于 `Terminated` 状态,且 Pod 无法被节点接受。
409423

@@ -446,19 +460,18 @@ You will still have to enable each option using the `TopologyManagerPolicyOption
446460
你仍然需要使用 `TopologyManagerPolicyOptions` kubelet 选项来启用每个选项。
447461

448462
<!--
449-
### `prefer-closest-numa-nodes` (beta) {#policy-option-prefer-closest-numa-nodes}
463+
### `prefer-closest-numa-nodes` {#policy-option-prefer-closest-numa-nodes}
450464
451-
The `prefer-closest-numa-nodes` option is beta since Kubernetes 1.28. In Kubernetes {{< skew currentVersion >}}
452-
this policy option is visible by default provided that the `TopologyManagerPolicyOptions` and
453-
`TopologyManagerPolicyBetaOptions` [feature gates](/docs/reference/command-line-tools-reference/feature-gates/)
454-
are enabled.
465+
The `prefer-closest-numa-nodes` option is GA since Kubernetes 1.32. In Kubernetes {{< skew currentVersion >}}
466+
this policy option is visible by default provided that the `TopologyManagerPolicyOptions`
467+
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) is enabled.
455468
-->
456-
### `prefer-closest-numa-nodes`(Beta) {#policy-option-prefer-closest-numa-nodes}
469+
### `prefer-closest-numa-nodes` {#policy-option-prefer-closest-numa-nodes}
457470

458-
自 Kubernetes 1.28 起,`prefer-closest-numa-nodes` 选项进入 Beta 阶段。
471+
自 Kubernetes 1.32 起,`prefer-closest-numa-nodes` 选项进入 GA 阶段。
459472
在 Kubernetes {{< skew currentVersion >}} 中,只要启用了
460-
`TopologyManagerPolicyOptions` `TopologyManagerPolicyBetaOptions`
461-
[特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)此策略选项默认可见。
473+
`TopologyManagerPolicyOptions` [特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)
474+
此策略选项默认可见。
462475

463476
<!--
464477
The Topology Manager is not aware by default of NUMA distances, and does not take them into account when making

0 commit comments

Comments
 (0)