Skip to content

Commit 6ffab4e

Browse files
committed
[zh-cn]sync endpoints-v1 daemon-set-v1
Signed-off-by: xin.li <[email protected]>
1 parent 1ec7015 commit 6ffab4e

File tree

2 files changed

+57
-50
lines changed

2 files changed

+57
-50
lines changed

content/zh-cn/docs/reference/kubernetes-api/service-resources/endpoints-v1.md

Lines changed: 33 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ auto_generated: true
2929
<!--
3030
Endpoints is a collection of endpoints that implement the actual service. Example:
3131
-->
32-
Endpoints 是实现实际服务的端点的集合。举例:
32+
Endpoints 是实现实际 Service 的端点的集合。举例:
3333

3434
Name: "mysvc",
3535
Subsets: [
@@ -45,6 +45,16 @@ Endpoints 是实现实际服务的端点的集合。举例:
4545

4646
<hr>
4747

48+
<!--
49+
Endpoints is a legacy API and does not contain information about all Service features. Use discoveryv1.EndpointSlice for complete information about Service endpoints.
50+
51+
Deprecated: This API is deprecated in v1.33+. Use discoveryv1.EndpointSlice.
52+
-->
53+
Endpoints 是遗留 API,不包含所有 Service 特性的信息。使用 discoveryv1.EndpointSlice
54+
获取关于 Service 端点的完整信息。
55+
56+
已弃用:此 API 在 v1.33+ 中已被弃用。请使用 discoveryv1.EndpointSlice。
57+
4858
- **apiVersion**: v1
4959

5060
- **kind**: Endpoints
@@ -89,10 +99,14 @@ Endpoints 是实现实际服务的端点的集合。举例:
8999
-->
90100
则最终的端点集可以看作:
91101

92-
93102
a: [ 10.10.1.1:8675, 10.10.2.2:8675 ],
94-
b: [ 10.10.1.1:309, 10.10.2.2:309 ]*
103+
b: [ 10.10.1.1:309, 10.10.2.2:309 ]
95104

105+
<!--
106+
Deprecated: This API is deprecated in v1.33+.*
107+
-->
108+
109+
已弃用:此 API 在 v1.33+ 中已被弃用。
96110

97111
- **subsets.addresses** ([]EndpointAddress)
98112

@@ -109,19 +123,19 @@ Endpoints 是实现实际服务的端点的集合。举例:
109123

110124
<!--
111125
<a name="EndpointAddress"></a>
112-
*EndpointAddress is a tuple that describes single IP address.*
126+
*EndpointAddress is a tuple that describes single IP address. Deprecated: This API is deprecated in v1.33+.*
113127
-->
114128

115129
<a name="EndpointAddress"></a>
116-
**EndpointAddress 是描述单个 IP 地址的元组。**
130+
**EndpointAddress 是描述单个 IP 地址的元组。已弃用:此 API 在 v1.33+ 中已被弃用。**
117131

118132
<!--
119133
- **subsets.addresses.ip** (string), required
120134
121135
The IP of this endpoint. May not be loopback (127.0.0.0/8 or ::1), link-local (169.254.0.0/16 or fe80::/10), or link-local multicast ((224.0.0.0/24).
122136
-->
123137

124-
- **subsets.addresses.ip** (string), 必需
138+
- **subsets.addresses.ip** (string)必需
125139

126140
端点的 IP。不可以是本地回路(127.0.0.0/8 或 ::1)、
127141
链路本地(169.254.0.0/16 或 fe80::/10)或链路本地多播(224.0.0.0/24
@@ -159,21 +173,22 @@ Endpoints 是实现实际服务的端点的集合。举例:
159173
IP addresses which offer the related ports but are not currently marked as ready because they have not yet finished starting, have recently failed a readiness check, or have recently failed a liveness check.
160174
161175
<a name="EndpointAddress"></a>
162-
*EndpointAddress is a tuple that describes single IP address.*
176+
*EndpointAddress is a tuple that describes single IP address. Deprecated: This API is deprecated in v1.33+.*
163177
-->
178+
164179
**Atomic:将在合并期间被替换**
165180

166181
提供相关端口但由于尚未完成启动、最近未通过就绪态检查或最近未通过活跃性检查而被标记为当前未就绪的 IP 地址。
167182
<a name="EndpointAddress"></a>
168-
**EndpointAddress 是描述单个 IP 地址的元组。**
183+
**EndpointAddress 是描述单个 IP 地址的元组。已弃用:此 API 在 v1.33+ 中已被弃用。**
169184

170185
<!--
171186
- **subsets.notReadyAddresses.ip** (string), required
172187
173188
The IP of this endpoint. May not be loopback (127.0.0.0/8 or ::1), link-local (169.254.0.0/16 or fe80::/10), or link-local multicast (224.0.0.0/24 or ff02::/16).
174189
-->
175190

176-
- **subsets.notReadyAddresses.ip** (string), 必需
191+
- **subsets.notReadyAddresses.ip** (string)必需
177192

178193
端点的 IP。不可以是本地环路(127.0.0.0/8 或 ::1)、
179194
链路本地(169.254.0.0/16 或 fe80::/10)或链路本地多播(224.0.0.0/24
@@ -217,19 +232,19 @@ Endpoints 是实现实际服务的端点的集合。举例:
217232

218233
<!--
219234
<a name="EndpointPort"></a>
220-
*EndpointPort is a tuple that describes a single port.*
235+
*EndpointPort is a tuple that describes a single port. Deprecated: This API is deprecated in v1.33+.*
221236
-->
222237

223238
<a name="EndpointPort"></a>
224-
**EndpointPort 是描述单个端口的元组。**
239+
**EndpointPort 是描述单个端口的元组。已弃用:此 API 在 v1.33+ 中已被弃用。**
225240

226241
<!--
227242
- **subsets.ports.port** (int32), required
228243
229244
The port number of the endpoint.
230245
-->
231246

232-
- **subsets.ports.port** (int32), 必需
247+
- **subsets.ports.port** (int32)必需
233248

234249
端点的端口号。
235250

@@ -284,9 +299,9 @@ Endpoints 是实现实际服务的端点的集合。举例:
284299
## EndpointsList {#EndpointsList}
285300

286301
<!--
287-
EndpointsList is a list of endpoints.
302+
EndpointsList is a list of endpoints. Deprecated: This API is deprecated in v1.33+.
288303
-->
289-
EndpointsList 是端点列表。
304+
EndpointsList 是端点列表。已弃用:此 API 在 v1.33+ 中已被弃用。
290305

291306
<hr>
292307

@@ -299,6 +314,7 @@ EndpointsList 是端点列表。
299314
<!--
300315
Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
301316
-->
317+
302318
标准的列表元数据。更多信息:
303319
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
304320

@@ -309,7 +325,7 @@ EndpointsList 是端点列表。
309325
310326
## Operations {#Operations}
311327
-->
312-
- **items** ([]<a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>), 必需
328+
- **items** ([]<a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>)必需
313329

314330
端点列表。
315331

@@ -471,10 +487,6 @@ GET /api/v1/namespaces/{namespace}/endpoints
471487

472488
<!--
473489
#### Response
474-
475-
200 (<a href="{{< ref "../service-resources/endpoints-v1#EndpointsList" >}}">EndpointsList</a>): OK
476-
477-
401: Unauthorized
478490
-->
479491
#### 响应
480492

@@ -630,7 +642,7 @@ POST /api/v1/namespaces/{namespace}/endpoints
630642

631643
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
632644

633-
- **body**: <a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>, 必需
645+
- **body**: <a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>必需
634646

635647
<!--
636648
- **dryRun** (*in query*): string
@@ -750,12 +762,6 @@ PUT /api/v1/namespaces/{namespace}/endpoints/{name}
750762

751763
<!--
752764
#### Response
753-
754-
200 (<a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>): OK
755-
756-
201 (<a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>): Created
757-
758-
401: Unauthorized
759765
-->
760766
#### 响应
761767

@@ -802,7 +808,7 @@ PATCH /api/v1/namespaces/{namespace}/endpoints/{name}
802808

803809
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
804810

805-
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, 必需
811+
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>必需
806812

807813
<!--
808814
- **dryRun** (*in query*): string

content/zh-cn/docs/reference/kubernetes-api/workload-resources/daemon-set-v1.md

Lines changed: 24 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -86,18 +86,18 @@ DaemonSetSpec 是守护进程集的规约。
8686
8787
A label query over pods that are managed by the daemon set. Must match in order to be controlled. It must match the pod template's labels. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
8888
-->
89-
- **selector** (<a href="{{< ref "../common-definitions/label-selector#LabelSelector" >}}">LabelSelector</a>), 必需
89+
- **selector** (<a href="{{< ref "../common-definitions/label-selector#LabelSelector" >}}">LabelSelector</a>)必需
9090

9191
对由守护进程集管理的 Pod 的标签查询。Pod 必须匹配此查询才能被此 DaemonSet 控制。
92-
查询条件必须与 Pod 模板的标签匹配。
93-
更多信息: https://kubernetes.io/zh-cn/concepts/overview/working-with-objects/labels/#label-selectors
92+
查询条件必须与 Pod 模板的标签匹配。更多信息:
93+
https://kubernetes.io/zh-cn/concepts/overview/working-with-objects/labels/#label-selectors
9494

9595
<!--
9696
- **template** (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec</a>), required
9797
9898
An object that describes the pod that will be created. The DaemonSet will create exactly one copy of this pod on every node that matches the template's node selector (or on every node if no node selector is specified). The only allowed template.spec.restartPolicy value is "Always". More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template
9999
-->
100-
- **template** (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec</a>), 必需
100+
- **template** (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec</a>)必需
101101

102102
描述将要创建的 Pod 的对象。DaemonSet 将在与模板的节点选择器匹配的每个节点上
103103
(如果未指定节点选择器,则在每个节点上)准确创建此 Pod 的副本。`template.spec.restartPolicy`
@@ -420,9 +420,10 @@ DaemonSetList 是守护进程集的集合。
420420

421421
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
422422

423-
标准列表元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
423+
标准列表元数据。更多信息:
424+
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
424425

425-
- **items** ([]<a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>), 必需
426+
- **items** ([]<a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>)必需
426427

427428
DaemonSet 的列表。
428429

@@ -452,7 +453,7 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}
452453
453454
name of the DaemonSet
454455
-->
455-
- **name** (**路径参数**): string, 必需
456+
- **name** (**路径参数**): string必需
456457

457458
DaemonSet 的名称
458459

@@ -466,7 +467,7 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}
466467
<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
467468
-->
468469

469-
- **namespace** (**路径参数**): string, 必需
470+
- **namespace** (**路径参数**): string必需
470471

471472
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
472473

@@ -509,7 +510,7 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status
509510
510511
name of the DaemonSet
511512
-->
512-
- **name** (**路径参数**): string, 必需
513+
- **name** (**路径参数**): string必需
513514

514515
DaemonSet 的名称
515516

@@ -518,7 +519,7 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status
518519
519520
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
520521
-->
521-
- **namespace** (**路径参数**): string, 必需
522+
- **namespace** (**路径参数**): string必需
522523

523524
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
524525

@@ -571,7 +572,7 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets
571572
<a href="{{< ref "../common-parameters/common-parameters#allowWatchBookmarks" >}}">allowWatchBookmarks</a>
572573
-->
573574

574-
- **namespace** (**路径参数**): string, 必需
575+
- **namespace** (**路径参数**): string必需
575576

576577
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
577578

@@ -837,11 +838,11 @@ POST /apis/apps/v1/namespaces/{namespace}/daemonsets
837838
838839
- **body**: <a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>, required
839840
-->
840-
- **namespace** (**路径参数**): string, 必需
841+
- **namespace** (**路径参数**): string必需
841842

842843
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
843844

844-
- **body**: <a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>, 必需
845+
- **body**: <a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>必需
845846

846847
<!--
847848
- **dryRun** (*in query*): string
@@ -1019,15 +1020,15 @@ PUT /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status
10191020
10201021
- **body**: <a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>, required
10211022
-->
1022-
- **name** (**路径参数**): string, 必需
1023+
- **name** (**路径参数**): string必需
10231024

10241025
DaemonSet 的名称
10251026

1026-
- **namespace** (**路径参数**): string, 必需
1027+
- **namespace** (**路径参数**): string必需
10271028

10281029
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
10291030

1030-
- **body**: <a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>, 必需
1031+
- **body**: <a href="{{< ref "../workload-resources/daemon-set-v1#DaemonSet" >}}">DaemonSet</a>必需
10311032

10321033
<!--
10331034
- **dryRun** (*in query*): string
@@ -1111,15 +1112,15 @@ PATCH /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}
11111112
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, required
11121113
-->
11131114

1114-
- **name** (**路径参数**): string, 必需
1115+
- **name** (**路径参数**): string必需
11151116

11161117
DaemonSet 的名称
11171118

1118-
- **namespace** (**路径参数**): string, 必需
1119+
- **namespace** (**路径参数**): string必需
11191120

11201121
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
11211122

1122-
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, 必需
1123+
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>必需
11231124

11241125
<!--
11251126
- **dryRun** (*in query*): string
@@ -1212,15 +1213,15 @@ PATCH /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status
12121213
12131214
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, required
12141215
-->
1215-
- **name** (**路径参数**): string, 必需
1216+
- **name** (**路径参数**): string必需
12161217

12171218
DaemonSet 的名称
12181219

1219-
- **namespace** (**路径参数**): string, 必需
1220+
- **namespace** (**路径参数**): string必需
12201221

12211222
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
12221223

1223-
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, 必需
1224+
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>必需
12241225

12251226
<!--
12261227
- **dryRun** (*in query*): string
@@ -1406,7 +1407,7 @@ DELETE /apis/apps/v1/namespaces/{namespace}/daemonsets
14061407
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
14071408
-->
14081409

1409-
- **namespace** (**路径参数**): string, 必需
1410+
- **namespace** (**路径参数**): string必需
14101411

14111412
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
14121413

0 commit comments

Comments
 (0)