Skip to content

Commit 2523986

Browse files
committed
[zh-cn] sync client-authentication.v1beta1 ports-and-protocols
Signed-off-by: xin.li <xin.li@daocloud.io>
1 parent 8901aa5 commit 2523986

File tree

2 files changed

+53
-70
lines changed

2 files changed

+53
-70
lines changed

content/zh-cn/docs/reference/config-api/client-authentication.v1beta1.md

Lines changed: 46 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -32,18 +32,18 @@ ExecCredential 由基于 exec 的插件使用,与 HTTP 传输组件沟通凭
3232
<tr><td><code>apiVersion</code><br/>string</td><td><code>client.authentication.k8s.io/v1beta1</code></td></tr>
3333
<tr><td><code>kind</code><br/>string</td><td><code>ExecCredential</code></td></tr>
3434

35-
36-
<tr><td><code>spec</code> <B><!--[Required]-->[必需]</B><br/>
35+
<tr>
36+
<td><code>spec</code> <B><!--[Required]-->[必需]</B><br/>
3737
<a href="#client-authentication-k8s-io-v1beta1-ExecCredentialSpec"><code>ExecCredentialSpec</code></a>
3838
</td>
3939
<td>
4040
<!--Spec holds information passed to the plugin by the transport.-->
4141
字段 spec 包含由 HTTP 传输组件传递给插件的信息。
4242
</td>
4343
</tr>
44-
4544

46-
<tr><td><code>status</code><br/>
45+
<tr>
46+
<td><code>status</code><br/>
4747
<a href="#client-authentication-k8s-io-v1beta1-ExecCredentialStatus"><code>ExecCredentialStatus</code></a>
4848
</td>
4949
<td>
@@ -52,24 +52,17 @@ ExecCredential 由基于 exec 的插件使用,与 HTTP 传输组件沟通凭
5252
字段 status 由插件填充,包含传输组件与 API 服务器连接时需要提供的凭据。
5353
</td>
5454
</tr>
55-
56-
55+
5756
</tbody>
5857
</table>
59-
60-
6158

6259
## `Cluster` {#client-authentication-k8s-io-v1beta1-Cluster}
63-
64-
65-
6660

6761
<!--**Appears in:**-->
6862
**出现在:**
6963

7064
- [ExecCredentialSpec](#client-authentication-k8s-io-v1beta1-ExecCredentialSpec)
7165

72-
7366
<!--
7467
Cluster contains information to allow an exec plugin to communicate
7568
with the kubernetes cluster being authenticated to.
@@ -89,20 +82,19 @@ Cluster 中包含允许 exec 插件与 Kubernetes 集群进行通信身份认证
8982
<table class="table">
9083
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
9184
<tbody>
92-
9385

94-
95-
<tr><td><code>server</code> <B><!--[Required]-->[必需]</B><br/>
86+
<tr>
87+
<td><code>server</code> <B><!--[Required]-->[必需]</B><br/>
9688
<code>string</code>
9789
</td>
9890
<td>
9991
<!--Server is the address of the kubernetes cluster (http://hostname:port).-->
10092
字段 server 是 Kubernetes 集群的地址(http://hostname:port)。
10193
</td>
10294
</tr>
103-
104-
105-
<tr><td><code>tls-server-name</code><br/>
95+
96+
<tr>
97+
<td><code>tls-server-name</code><br/>
10698
<code>string</code>
10799
</td>
108100
<td>
@@ -115,9 +107,9 @@ used to contact the server is used.
115107
如此字段为空,则使用链接服务器时使用的主机名。
116108
</td>
117109
</tr>
118-
119-
120-
<tr><td><code>insecure-skip-tls-verify</code><br/>
110+
111+
<tr>
112+
<td><code>insecure-skip-tls-verify</code><br/>
121113
<code>bool</code>
122114
</td>
123115
<td>
@@ -129,9 +121,9 @@ This will make your HTTPS connections insecure.
129121
这会使得你的 HTTPS 链接不再安全。
130122
</td>
131123
</tr>
132-
133-
134-
<tr><td><code>certificate-authority-data</code><br/>
124+
125+
<tr>
126+
<td><code>certificate-authority-data</code><br/>
135127
<code>[]byte</code>
136128
</td>
137129
<td>
@@ -143,9 +135,9 @@ If empty, system roots should be used.
143135
如果为空,则使用系统的根证书。
144136
</td>
145137
</tr>
146-
147-
148-
<tr><td><code>proxy-url</code><br/>
138+
139+
<tr>
140+
<td><code>proxy-url</code><br/>
149141
<code>string</code>
150142
</td>
151143
<td>
@@ -154,7 +146,8 @@ If empty, system roots should be used.
154146
</td>
155147
</tr>
156148

157-
<tr><td><code>disable-compression</code><br/>
149+
<tr>
150+
<td><code>disable-compression</code><br/>
158151
<code>bool</code>
159152
</td>
160153
<td>
@@ -169,7 +162,8 @@ If empty, system roots should be used.
169162
</td>
170163
</tr>
171164

172-
<tr><td><code>config</code><br/>
165+
<tr>
166+
<td><code>config</code><br/>
173167
<a href="http://godoc.org/k8s.io/apimachinery/pkg/runtime/#RawExtension"><code>k8s.io/apimachinery/pkg/runtime.RawExtension</code></a>
174168
</td>
175169
<td>
@@ -208,24 +202,17 @@ to be stored directly in the kubeconfig.
208202
kubeconfig 中保存 Secret 数据。</p>
209203
</td>
210204
</tr>
211-
212205

213206
</tbody>
214207
</table>
215-
216-
217208

218209
## `ExecCredentialSpec` {#client-authentication-k8s-io-v1beta1-ExecCredentialSpec}
219-
220-
221-
222210

223211
<!-- **Appears in:** -->
224212
**出现在:**
225213

226214
- [ExecCredential](#client-authentication-k8s-io-v1beta1-ExecCredential)
227215

228-
229216
<!--
230217
ExecCredentialSpec holds request and runtime specific information provided by
231218
the transport.
@@ -235,9 +222,7 @@ ExecCredentialSpec 保存传输组件所提供的特定于请求和运行时的
235222
<table class="table">
236223
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
237224
<tbody>
238-
239225

240-
241226
<tr><td><code>cluster</code><br/>
242227
<a href="#client-authentication-k8s-io-v1beta1-Cluster"><code>Cluster</code></a>
243228
</td>
@@ -253,81 +238,77 @@ ExecConfig.ProvideClusterInfo).
253238
(即:ExecConfig.ProvideClusterInfo)被设置为 true 时才不能为空。
254239
</td>
255240
</tr>
256-
257-
241+
258242
</tbody>
259243
</table>
260-
261-
262244

263245
## `ExecCredentialStatus` {#client-authentication-k8s-io-v1beta1-ExecCredentialStatus}
264-
265-
266-
267246

268247
<!-- **Appears in:** -->
269248
**出现在:**
270249

271250
- [ExecCredential](#client-authentication-k8s-io-v1beta1-ExecCredential)
272251

273-
274-
<!--
252+
<p>
253+
<!--
275254
ExecCredentialStatus holds credentials for the transport to use.
255+
-->
256+
ExecCredentialStatus 中包含传输组件要使用的凭据。
257+
</p>
276258

259+
<p>
260+
<!--
277261
Token and ClientKeyData are sensitive fields. This data should only be
278262
transmitted in-memory between client and exec plugin process. Exec plugin
279263
itself should at least be protected via file permissions.
280264
-->
281-
<p>ExecCredentialStatus 中包含传输组件要使用的凭据。</p>
282-
283-
<p>字段 token 和 clientKeyData 都是敏感字段。
265+
字段 token 和 clientKeyData 都是敏感字段。
284266
此数据只能在客户端与 exec 插件进程之间使用内存来传递。
285-
exec 插件本身至少应通过文件访问许可来实施保护。</p>
267+
exec 插件本身至少应通过文件访问许可来实施保护。
268+
</p>
286269

287270
<table class="table">
288271
<thead><tr><th width="30%"><!--Field-->字段</th><th><!--Description-->描述</th></tr></thead>
289-
290272

291-
292-
<tr><td><code>expirationTimestamp</code><br/>
293-
<a href="http://kubernetes.io/docs/reference/generated/kubernetes-api/v1.29/#time-v1-meta"><code>meta/v1.Time</code></a>
273+
<tr>
274+
<td><code>expirationTimestamp</code><br/>
275+
<a href="http://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#time-v1-meta"><code>meta/v1.Time</code></a>
294276
</td>
295277
<td>
296278
<!-- ExpirationTimestamp indicates a time when the provided credentials expire. -->
297279
给出所提供的凭据到期的时间。
298280
</td>
299281
</tr>
300282

301-
302-
<tr><td><code>token</code> <B><!--[Required]-->[必需]</B><br/>
283+
<tr>
284+
<td><code>token</code> <B><!--[Required]-->[必需]</B><br/>
303285
<code>string</code>
304286
</td>
305287
<td>
306288
<!-- Token is a bearer token used by the client for request authentication. -->
307289
客户端用做请求身份认证的持有者令牌。
308290
</td>
309291
</tr>
310-
311-
312-
<tr><td><code>clientCertificateData</code> <B><!--[Required]-->[必需]</B><br/>
292+
293+
<tr>
294+
<td><code>clientCertificateData</code> <B><!--[Required]-->[必需]</B><br/>
313295
<code>string</code>
314296
</td>
315297
<td>
316298
<!-- PEM-encoded client TLS certificates (including intermediates, if any). -->
317299
PEM 编码的客户端 TLS 证书(如果有临时证书,也会包含)。
318300
</td>
319301
</tr>
320-
321-
322-
<tr><td><code>clientKeyData</code> <B><!--[Required]-->[必需]</B><br/>
302+
303+
<tr>
304+
<td><code>clientKeyData</code> <B><!--[Required]-->[必需]</B><br/>
323305
<code>string</code>
324306
</td>
325307
<td>
326308
<!-- PEM-encoded private key for the above certificate. -->
327309
与上述证书对应的、PEM 编码的私钥。
328310
</td>
329311
</tr>
330-
331-
312+
332313
</tbody>
333314
</table>

content/zh-cn/docs/reference/networking/ports-and-protocols.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ etcd cluster externally or on custom ports.
3737

3838
| 协议 | 方向 | 端口范围 | 目的 | 使用者 |
3939
|----------|-----------|------------|-------------------------|---------------------------|
40-
| TCP | 入站 | 6443 | Kubernetes API server | 所有 |
41-
| TCP | 入站 | 2379-2380 | etcd server client API | kube-apiserver, etcd |
42-
| TCP | 入站 | 10250 | Kubelet API | 自身, 控制面 |
40+
| TCP | 入站 | 6443 | Kubernetes API 服务器 | 所有 |
41+
| TCP | 入站 | 2379-2380 | etcd 服务器客户端 API | kube-apiserveretcd |
42+
| TCP | 入站 | 10250 | kubelet API | 自身控制面 |
4343
| TCP | 入站 | 10259 | kube-scheduler | 自身 |
4444
| TCP | 入站 | 10257 | kube-controller-manager | 自身 |
4545

@@ -51,6 +51,7 @@ etcd cluster externally or on custom ports.
5151
| Protocol | Direction | Port Range | Purpose | Used By |
5252
|----------|-----------|-------------|-----------------------|-------------------------|
5353
| TCP | Inbound | 10250 | Kubelet API | Self, Control plane |
54+
| TCP | Inbound | 10256 | kube-proxy | Self, Load balancers |
5455
| TCP | Inbound | 30000-32767 | NodePort Services† | All |
5556
5657
† Default port range for [NodePort Services](/docs/concepts/services-networking/service/).
@@ -67,10 +68,11 @@ on the default port.
6768

6869
| 协议 | 方向 | 端口范围 | 目的 | 使用者 |
6970
|----------|-----------|-------------|-----------------------|-------------------------|
70-
| TCP | 入站 | 10250 | Kubelet API | 自身, 控制面 |
71+
| TCP | 入站 | 10250 | kubelet API | 自身、控制面 |
72+
| TCP | 入站 | 10256 | kube-proxy | 自身、负载均衡器 |
7173
| TCP | 入站 | 30000-32767 | NodePort Services† | 所有 |
7274

73-
[NodePort Services](/zh-cn/docs/concepts/services-networking/service/)的默认端口范围。
75+
[NodePort Service](/zh-cn/docs/concepts/services-networking/service/) 的默认端口范围。
7476

7577
所有默认端口都可以重新配置。当使用自定义的端口时,你需要打开这些端口来代替这里提到的默认端口。
7678

0 commit comments

Comments
 (0)