Skip to content

Commit f52c7ca

Browse files
authored
Merge pull request #33988 from Sea-n/fix-zh-link-ref
[zh] Fix link for references
2 parents 2f45690 + 360b475 commit f52c7ca

File tree

9 files changed

+96
-87
lines changed

9 files changed

+96
-87
lines changed

content/zh/docs/reference/command-line-tools-reference/kube-apiserver.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ the host's default interface will be used.
8484
The map from metric-label to value allow-list of this label. The key's format is <MetricName>,<LabelName>. The value's format is <allowed_value>,<allowed_value>...e.g. metric1,label1='v1,v2,v3', metric1,label2='v1,v2,v3' metric2,label1='v1,v2,v3'.
8585
-->
8686
允许使用的指标标签到指标值的映射列表。键的格式为 <MetricName>,<LabelName>.
87-
值的格式为 <allowed_value>,<allowed_value>...。
87+
值的格式为 <allowed_value>,<allowed_value>...。
8888
例如:<code>metric1,label1='v1,v2,v3', metric1,label2='v1,v2,v3' metric2,label1='v1,v2,v3'</code>。
8989
</p></td>
9090
</tr>
@@ -97,7 +97,7 @@ The map from metric-label to value allow-list of this label. The key's format is
9797
<!--
9898
If true, allow privileged containers. [default=false]
9999
-->
100-
如果为 true, 将允许特权容器。[默认值=false]
100+
如果为 true将允许特权容器。[默认值=false]
101101
</td>
102102
</tr>
103103

@@ -131,8 +131,8 @@ of these audiences. If the --service-account-issuer flag is configured
131131
and this flag is not, this field defaults to a single element list
132132
containing the issuer URL.
133133
-->
134-
API 的标识符。
135-
服务帐户令牌验证者将验证针对 API 使用的令牌是否已绑定到这些受众中的至少一个。
134+
API 的标识符。
135+
服务帐户令牌验证者将验证针对 API 使用的令牌是否已绑定到这些受众中的至少一个。
136136
如果配置了 <code>--service-account-issuer</code> 标志,但未配置此标志,
137137
则此字段默认为包含发布者 URL 的单个元素列表。
138138
</td>
@@ -799,7 +799,7 @@ CORS 允许的来源清单,以逗号分隔。
799799
<!--
800800
Indicates the tolerationSeconds of the toleration for notReady:NoExecute that is added by default to every pod that does not already have such a toleration.
801801
-->
802-
对污点 NotReady:NoExecute 的容忍时长(以秒计)。
802+
对污点 NotReady:NoExecute 的容忍时长(以秒计)。
803803
默认情况下这一容忍度会被添加到尚未具有此容忍度的每个 pod 中。
804804
</td>
805805
</tr>
@@ -833,7 +833,7 @@ that do not have a default watch size set.
833833
</tr>
834834

835835
<tr>
836-
<td colspan="2">--delete-collection-workers int&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<!--Default:-->默认值: 1</td>
836+
<td colspan="2">--delete-collection-workers int&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<!--Default:-->默认值:1</td>
837837
</tr>
838838
<tr>
839839
<td></td><td style="line-height: 130%; word-wrap: break-word;">
@@ -1363,10 +1363,10 @@ Max is .02 (1/50 requests); .001 (1/1000) is a recommended starting point.
13631363
-->
13641364
为防止 HTTP/2 客户端卡在单个 API 服务器上,可启用随机关闭连接(GOAWAY)。
13651365
客户端的其他运行中请求将不会受到影响,并且客户端将重新连接,
1366-
可能会在再次通过负载平衡器后登陆到其他 API 服务器上。
1367-
此参数设置将发送 GOAWAY 的请求的比例。
1368-
具有单个 API 服务器或不使用负载平衡器的群集不应启用此功能。
1369-
最小值为0(关闭),最大值为 .02(1/50 请求); 建议使用 .001(1/1000)。
1366+
可能会在再次通过负载平衡器后登陆到其他 API 服务器上。
1367+
此参数设置将发送 GOAWAY 的请求的比例。
1368+
具有单个 API 服务器或不使用负载平衡器的集群不应启用此功能。
1369+
最小值为0(关闭),最大值为 .02(1/50 请求);建议使用 .001(1/1000)。
13701370
</td>
13711371
</tr>
13721372

@@ -1847,7 +1847,7 @@ open before timing it out. This is the default request timeout for
18471847
requests but may be overridden by flags such as --min-request-timeout
18481848
for specific types of requests.
18491849
-->
1850-
可选字段,指示处理程序在超时之前必须保持打开请求的持续时间。
1850+
可选字段,指示处理程序在超时之前必须保持打开请求的持续时间。
18511851
这是请求的默认请求超时,但对于特定类型的请求,可能会被
18521852
<code>--min-request-timeout</code>等标志覆盖。
18531853
</td>
@@ -2004,9 +2004,9 @@ and all are used to determine which issuers are accepted.
20042004
颁发者将在已办法令牌的 "iss" 声明中检查此标识符。
20052005
此值为字符串或 URI。
20062006
如果根据 OpenID Discovery 1.0 规范检查此选项不是有效的 URI,则即使特性门控设置为 true,
2007-
ServiceAccountIssuerDiscovery 功能也将保持禁用状态。
2008-
强烈建议该值符合 OpenID 规范:https://openid.net/specs/openid-connect-discovery-1_0.html
2009-
实践中,这意味着 service-account-issuer 取值必须是 HTTPS URL。
2007+
ServiceAccountIssuerDiscovery 功能也将保持禁用状态。
2008+
强烈建议该值符合 OpenID 规范: https://openid.net/specs/openid-connect-discovery-1_0.html
2009+
实践中,这意味着 service-account-issuer 取值必须是 HTTPS URL。
20102010
还强烈建议此 URL 能够在 {service-account-issuer}/.well-known/openid-configuration
20112011
处提供 OpenID 发现文档。
20122012
当此值被多次指定时,第一次的值用于生成令牌,所有的值用于确定接受哪些发行人。
@@ -2209,7 +2209,7 @@ List of directives for HSTS, comma separated. If this list is empty, then HSTS d
22092209
-->
22102210
为 HSTS 所设置的指令列表,用逗号分隔。
22112211
如果此列表为空,则不会添加 HSTS 指令。
2212-
例如: 'max-age=31536000,includeSubDomains,preload'
2212+
例如:'max-age=31536000,includeSubDomains,preload'
22132213
</p></td>
22142214
</tr>
22152215

@@ -2280,7 +2280,7 @@ File containing the default x509 private key matching --tls-cert-file.
22802280
</tr>
22812281

22822282
<tr>
2283-
<td colspan="2">--tls-sni-cert-key string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<!--Default:-->默认值: []</td>
2283+
<td colspan="2">--tls-sni-cert-key string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<!--Default:-->默认值:[]</td>
22842284
</tr>
22852285
<tr>
22862286
<td></td><td style="line-height: 130%; word-wrap: break-word;">

content/zh/docs/reference/kubernetes-api/authentication-resources/service-account-v1.md

Lines changed: 23 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ api_metadata:
44
import: "k8s.io/api/core/v1"
55
kind: "ServiceAccount"
66
content_type: "api_reference"
7-
description: "ServiceAccount 将以下内容绑定在一起:1. 用户可以理解的名称,也可能是外围系统理解的身份标识 2. 可以验证和授权的主体 3. 一组 secret "
7+
description: "ServiceAccount 将以下内容绑定在一起:1. 用户可以理解的名称,也可能是外围系统理解的身份标识 2. 可以验证和授权的主体 3. 一组 secret。"
88
title: "ServiceAccount"
99
weight: 1
1010
auto_generated: true
@@ -27,7 +27,7 @@ The file is auto-generated from the Go source code of the component using a gene
2727
[generator](https://github.com/kubernetes-sigs/reference-docs/). To learn how
2828
to generate the reference documentation, please read
2929
[Contributing to the reference documentation](/docs/contribute/generate-ref-docs/).
30-
To update the reference content, please follow the
30+
To update the reference content, please follow the
3131
[Contributing upstream](/docs/contribute/generate-ref-docs/contribute-upstream/)
3232
guide. You can file document formatting bugs against the
3333
[reference-docs](https://github.com/kubernetes-sigs/reference-docs/) project.
@@ -76,20 +76,29 @@ ServiceAccount 将以下内容绑定在一起:
7676
<!--
7777
ImagePullSecrets is a list of references to secrets in the same namespace to use for pulling any images in pods that reference this ServiceAccount. ImagePullSecrets are distinct from Secrets because Secrets can be mounted in the pod, but ImagePullSecrets are only accessed by the kubelet. More info: https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
7878
-->
79-
imagePullSecrets 是对同一命名空间中 Secret 的引用列表,用于拉取引用此 ServiceAccount 的 Pod 中的任何镜像。
80-
imagePullSecrets 与 Secrets 不同,因为 Secrets 可以挂载在 Pod 中,但 imagePullSecrets 只能由 kubelet 访问。
81-
更多信息:https://kubernetes.io/zh/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
79+
imagePullSecrets 是对同一命名空间中 Secret 的引用列表,用于拉取引用此 ServiceAccount 的 Pod 中的任何镜像。
80+
imagePullSecrets 与 Secrets 不同,因为 Secrets 可以挂载在 Pod 中,但 imagePullSecrets 只能由 kubelet 访问。
81+
更多信息: https://kubernetes.io/zh/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
8282

8383
- **secrets** ([]<a href="{{< ref "../common-definitions/object-reference#ObjectReference" >}}">ObjectReference</a>)
84-
84+
8585
<!--
8686
*Patch strategy: merge on key `name`*
87-
88-
Secrets is the list of secrets allowed to be used by pods running using this ServiceAccount. More info: https://kubernetes.io/docs/concepts/configuration/secret
87+
88+
Secrets is a list of the secrets in the same namespace that pods running using this ServiceAccount are allowed to use. Pods are only limited to this list if this service account has a "kubernetes.io/enforce-mountable-secrets" annotation set to "true". This field should not be used to find auto-generated service account token secrets for use outside of pods. Instead, tokens can be requested directly using the TokenRequest API, or service account token secrets can be manually created. More info: https://kubernetes.io/docs/concepts/configuration/secret
89+
Secrets is a list of the secrets in the same namespace that pods running using this ServiceAccount are allowed to use
90+
Pods are only limited to this list if this service account has a "kubernetes.io/enforce-mountabl
91+
-secrets" annotation set to "true". This field should not be used to find auto-generated service accoun
92+
token secrets for use outside of pods. Instead, tokens can be requested directly using the TokenRequest API, or servic
93+
account token secrets can be manually created. More info: https://kubernetes.io/docs/concepts/configuration/secret
8994
-->
9095
**补丁策略:基于键 `name` 合并**
91-
Secrets 是允许使用此 ServiceAccount 运行的 Pod 使用的 Secret 列表。
92-
更多信息:https://kubernetes.io/zh/docs/concepts/configuration/secret
96+
97+
Secrets 是允许使用此 ServiceAccount 运行的 pod 使用的同一命名空间中的秘密列表。
98+
仅当此服务帐户的 “kubernetes.io/enforce-mountable-secrets” 注释设置为 “true” 时,Pod 才限于此列表。
99+
此字段不应用于查找自动生成的服务帐户令牌机密以在 pod 之外使用。
100+
相反,可以使用 TokenRequest API 直接请求令牌,或者可以手动创建服务帐户令牌 secret。
101+
更多信息: https://kubernetes.io/docs/concepts/configuration/secret
93102

94103
## ServiceAccountList {#ServiceAccountList}
95104

@@ -107,21 +116,21 @@ ServiceAccountList 是 ServiceAccount 对象的列表
107116

108117

109118
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
110-
119+
111120
<!--
112121
Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
113122
-->
114-
标准列表元数据, 更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
123+
标准列表元数据, 更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
115124

116-
<!--
125+
<!--
117126
- **items** ([]<a href="{{< ref "../authentication-resources/service-account-v1#ServiceAccount" >}}">ServiceAccount</a>), required
118127
-->
119128
- **items** ([]<a href="{{< ref "../authentication-resources/service-account-v1#ServiceAccount" >}}">ServiceAccount</a>), 必需
120129

121130
<!--
122131
List of ServiceAccounts. More info: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
123132
-->
124-
ServiceAccount 列表,更多信息:https://kubernetes.io/zh/docs/tasks/configure-pod-container/configure-service-account/
133+
ServiceAccount 列表,更多信息: https://kubernetes.io/zh/docs/tasks/configure-pod-container/configure-service-account/
125134

126135
<!--
127136
## Operations {#Operations}

content/zh/docs/reference/kubernetes-api/authentication-resources/token-review-v1.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ TokenReview attempts to authenticate a token to a known user. Note: TokenReview
3232
-->
3333
## TokenReview {#TokenReview}
3434

35-
TokenReview 尝试通过验证令牌来确认已知用户。
35+
TokenReview 尝试通过验证令牌来确认已知用户。
3636
注意:TokenReview 请求可能会被 kube-apiserver 中的 webhook 令牌验证器插件缓存。
3737

3838
<hr>
@@ -48,7 +48,7 @@ TokenReview 尝试通过验证令牌来确认已知用户。
4848
<!--
4949
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
5050
-->
51-
标准对象的元数据,更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
51+
标准对象的元数据,更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
5252

5353
- **spec** (<a href="{{< ref "../authentication-resources/token-review-v1#TokenReviewSpec" >}}">TokenReviewSpec</a>), required
5454

@@ -104,10 +104,10 @@ TokenReviewStatus 是令牌认证请求的结果。
104104
<!--
105105
Audiences are audience identifiers chosen by the authenticator that are compatible with both the TokenReview and token. An identifier is any identifier in the intersection of the TokenReviewSpec audiences and the token's audiences. A client of the TokenReview API that sets the spec.audiences field should validate that a compatible audience identifier is returned in the status.audiences field to ensure that the TokenReview server is audience aware. If a TokenReview returns an empty status.audience field where status.authenticated is "true", the token is valid against the audience of the Kubernetes API server.
106106
-->
107-
audiences 是身份验证者选择的与 TokenReview 和令牌兼容的受众标识符。 标识符是
108-
TokenReviewSpec 受众和令牌受众的交集中的任何标识符。 设置 spec.audiences
107+
audiences 是身份验证者选择的与 TokenReview 和令牌兼容的受众标识符。标识符是
108+
TokenReviewSpec 受众和令牌受众的交集中的任何标识符。设置 spec.audiences
109109
字段的 TokenReview API 的客户端应验证在 status.audiences 字段中返回了兼容的受众标识符,
110-
以确保 TokenReview 服务器能够识别受众。 如果 TokenReview
110+
以确保 TokenReview 服务器能够识别受众。如果 TokenReview
111111
返回一个空的 status.audience 字段,其中 status.authenticated 为 “true”,
112112
则该令牌对 Kubernetes API 服务器的受众有效。
113113

@@ -148,7 +148,7 @@ TokenReviewStatus 是令牌认证请求的结果。
148148

149149
<!--
150150
The names of groups this user is a part of.
151-
-->
151+
-->
152152
此用户所属的组的名称。
153153

154154
- **user.uid** (string)
@@ -168,7 +168,7 @@ TokenReviewStatus 是令牌认证请求的结果。
168168
<!--
169169
## Operations {#Operations}
170170
-->
171-
## 操作 {#Operations}
171+
## 操作 {#Operations}
172172

173173
<hr>
174174

content/zh/docs/reference/kubernetes-api/common-definitions/delete-options.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ auto_generated: true
3939

4040
`APIVersion` 定义对象表示的版本化模式。
4141
服务器应将已识别的模式转换为最新的内部值,并可能拒绝无法识别的值。
42-
更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
42+
更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
4343

4444
<!--
4545
- **dryRun** ([]string)
@@ -51,7 +51,7 @@ auto_generated: true
5151

5252
该值如果存在,则表示不应保留修改。
5353
无效或无法识别的 `dryRun` 指令将导致错误响应并且不会进一步处理请求。有效值为:
54-
54+
5555
- `All`:处理所有试运行阶段(Dry Run Stages)
5656

5757
<!--
@@ -75,7 +75,7 @@ auto_generated: true
7575

7676
`kind` 是一个字符串值,表示此对象代表的 REST 资源。
7777
服务器可以从客户端提交请求的端点推断出此值。此值无法更新,是驼峰的格式。
78-
更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
78+
更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
7979

8080
<!--
8181
- **orphanDependents** (boolean)
@@ -105,11 +105,11 @@ auto_generated: true
105105
106106
Specifies the target UID.
107107
-->
108-
108+
109109
- **preconditions** (Preconditions)
110110

111111
先决条件必须在执行删除之前完成。如果无法满足这些条件,将返回 409(冲突)状态。
112-
112+
113113
<a name="Preconditions"></a>
114114
*执行操作(更新、删除等)之前必须满足先决条件。*
115115

@@ -131,7 +131,7 @@ auto_generated: true
131131

132132
表示是否以及如何执行垃圾收集。可以设置此字段或 `orphanDependents` 字段,但不能同时设置二者。
133133
默认策略由 `metadata.finalizers` 中现有终结器(Finalizer)集合和特定资源的默认策略决定。
134-
可接受的值为: `Orphan` - 令依赖对象成为孤儿对象;`Background` - 允许垃圾收集器在后台删除依赖项;`Foreground` - 一个级联策略,前台删除所有依赖项。
134+
可接受的值为:`Orphan` - 令依赖对象成为孤儿对象;`Background` - 允许垃圾收集器在后台删除依赖项;`Foreground` - 一个级联策略,前台删除所有依赖项。
135135

136136

137137

content/zh/docs/reference/kubernetes-api/common-definitions/list-meta.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ ListMeta describes metadata that synthetic resources must have, including lists
7171

7272
标识该对象的服务器内部版本的字符串,客户端可以用该字段来确定对象何时被更改。
7373
该值对客户端是不透明的,并且应该原样传回给服务器。该值由系统填充,只读。
74-
更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency。
74+
更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
7575

7676
<!--
7777
Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.

0 commit comments

Comments
 (0)