Skip to content

Commit 38955ae

Browse files
gaogao101gaogao101
committed
[zh-cn] sync deprecation-guide.md
Signed-off-by: Gao Qian <[email protected]>
1 parent bc61b5d commit 38955ae

File tree

1 file changed

+58
-26
lines changed

1 file changed

+58
-26
lines changed

‎content/zh-cn/docs/reference/using-api/deprecation-guide.md

Lines changed: 58 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,36 @@ deprecated API versions to newer and more stable API versions.
3434
-->
3535
## 各发行版本中移除的 API {#removed-apis-by-release}
3636

37+
### v1.29
38+
39+
<!--
40+
The **v1.29** release will stop serving the following deprecated API versions:
41+
-->
42+
**v1.29** 发行版本将停止提供以下已弃用的 API 版本：
43+
44+
<!--
45+
#### Flow control resources {#flowcontrol-resources-v129}
46+
-->
47+
#### 流控制资源 {#flowcontrol-resources-v129}
48+
49+
<!--
50+
The **flowcontrol.apiserver.k8s.io/v1beta2** API version of FlowSchema and PriorityLevelConfiguration will no longer be served in v1.29.
51+
52+
* Migrate manifests and API clients to use the **flowcontrol.apiserver.k8s.io/v1beta3** API version, available since v1.26.
53+
* All existing persisted objects are accessible via the new API
54+
* Notable changes in **flowcontrol.apiserver.k8s.io/v1beta3**:
55+
* The PriorityLevelConfiguration `spec.limited.assuredConcurrencyShares` field is renamed to `spec.limited.nominalConcurrencyShares`
56+
-->
57+
**flowcontrol.apiserver.k8s.io/v1beta2** API 版本的 FlowSchema
58+
和 PriorityLevelConfiguration 将不会在 v1.29 中提供。
59+
60+
* 迁移清单和 API 客户端使用 **flowcontrol.apiserver.k8s.io/v1beta3** API 版本，
61+
此 API 从 v1.26 版本开始可用；
62+
* 所有的已保存的对象都可以通过新的 API 来访问；
63+
* **flowcontrol.apiserver.k8s.io/v1beta3** 中需要额外注意的变更：
64+
* PriorityLevelConfiguration 的 `spec.limited.assuredConcurrencyShares`
65+
字段已被更名为 `spec.limited.nominalConcurrencyShares`
66+
3767
### v1.27
3868

3969
<!--
@@ -50,7 +80,7 @@ The **storage.k8s.io/v1beta1** API version of CSIStorageCapacity will no longer
5080
* All existing persisted objects are accessible via the new API
5181
* No notable changes
5282
-->
53-
**storage.k8s.io/v1beta1** API版本的 CSIStorageCapacity 将不再在 v1.27 提供。
83+
**storage.k8s.io/v1beta1** API 版本的 CSIStorageCapacity 将不会在 v1.27 提供。
5484

5585
* 自 v1.24 版本起，迁移清单和 API 客户端使用 **storage.k8s.io/v1** API 版本
5686
* 所有现有的持久化对象都可以通过新的 API 访问
@@ -59,7 +89,7 @@ The **storage.k8s.io/v1beta1** API version of CSIStorageCapacity will no longer
5989
### v1.26
6090

6191
<!--
62-
The **v1.26** release will stop serving the following deprecated API versions:
92+
The **v1.26** release stopped serving the following deprecated API versions:
6393
-->
6494
**v1.26** 发行版本中将去除以下已弃用的 API 版本：
6595

@@ -69,30 +99,30 @@ The **v1.26** release will stop serving the following deprecated API versions:
6999
#### 流控制资源 {#flowcontrol-resources-v126}
70100

71101
<!--
72-
The **flowcontrol.apiserver.k8s.io/v1beta1** API version of FlowSchema and PriorityLevelConfiguration will no longer be served in v1.26.
102+
The **flowcontrol.apiserver.k8s.io/v1beta1** API version of FlowSchema and PriorityLevelConfiguration is no longer served as of v1.26.
73103
74-
* Migrate manifests and API clients to use the **flowcontrol.apiserver.k8s.io/v1beta2** API version, available since v1.23.
104+
* Migrate manifests and API clients to use the **flowcontrol.apiserver.k8s.io/v1beta3** API version, available since v1.26.
75105
* All existing persisted objects are accessible via the new API
76106
* No notable changes
77107
-->
78-
**flowcontrol.apiserver.k8s.io/v1beta1** API 版本的 FlowSchema
79-
和 PriorityLevelConfiguration 将不会在 v1.26 中提供。
108+
从 v1.26 版本开始不再提供 **flowcontrol.apiserver.k8s.io/v1beta1** API 版本的
109+
FlowSchema 和 PriorityLevelConfiguration。
80110

81-
* 迁移清单和 API 客户端使用 **flowcontrol.apiserver.k8s.io/v1beta2** API 版本，
82-
此 API 从 v1.23 版本开始可用；
111+
* 迁移清单和 API 客户端使用 **flowcontrol.apiserver.k8s.io/v1beta3** API 版本，
112+
此 API 从 v1.26 版本开始可用；
83113
* 所有的已保存的对象都可以通过新的 API 来访问；
84114
* 没有需要额外注意的变更
85115

86116
#### HorizontalPodAutoscaler {#horizontalpodautoscaler-v126}
87117

88118
<!--
89-
The **autoscaling/v2beta2** API version of HorizontalPodAutoscaler will no longer be served in v1.26.
119+
The **autoscaling/v2beta2** API version of HorizontalPodAutoscaler is no longer served as of v1.26.
90120
91121
* Migrate manifests and API clients to use the **autoscaling/v2** API version, available since v1.23.
92122
* All existing persisted objects are accessible via the new API
93123
-->
94-
**autoscaling/v2beta2** API 版本的 HorizontalPodAutoscaler 将不会在
95-
v1.26 版本中提供。
124+
从 v1.26 版本开始不再提供 **autoscaling/v2beta2** API 版本的
125+
HorizontalPodAutoscaler。
96126

97127
* 迁移清单和 API 客户端使用 **autoscaling/v2** API 版本，
98128
此 API 从 v1.23 版本开始可用；
@@ -101,20 +131,20 @@ v1.26 版本中提供。
101131
### v1.25
102132

103133
<!--
104-
The **v1.25** release will stop serving the following deprecated API versions:
134+
The **v1.25** release stopped serving the following deprecated API versions:
105135
-->
106136
**v1.25** 发行版本将停止提供以下已废弃 API 版本：
107137

108138
#### CronJob {#cronjob-v125}
109139

110140
<!--
111-
The **batch/v1beta1** API version of CronJob will no longer be served in v1.25.
141+
The **batch/v1beta1** API version of CronJob is no longer served as of v1.25.
112142
113143
* Migrate manifests and API clients to use the **batch/v1** API version, available since v1.21.
114144
* All existing persisted objects are accessible via the new API
115145
* No notable changes
116146
-->
117-
**batch/v1beta1** API 版本的 CronJob 将不会在 v1.25 版本中继续提供。
147+
从 v1.25 版本开始不再提供 **batch/v1beta1** API 版本的 CronJob。
118148

119149
* 迁移清单和 API 客户端使用 **batch/v1** API 版本，此 API 从 v1.21 版本开始可用；
120150
* 所有的已保存的对象都可以通过新的 API 来访问；
@@ -123,7 +153,7 @@ The **batch/v1beta1** API version of CronJob will no longer be served in v1.25.
123153
#### EndpointSlice {#endpointslice-v125}
124154

125155
<!--
126-
The **discovery.k8s.io/v1beta1** API version of EndpointSlice will no longer be served in v1.25.
156+
The **discovery.k8s.io/v1beta1** API version of EndpointSlice is no longer served as of v1.25.
127157
128158
* Migrate manifests and API clients to use the **discovery.k8s.io/v1** API version, available since v1.21.
129159
* All existing persisted objects are accessible via the new API
@@ -132,7 +162,7 @@ The **discovery.k8s.io/v1beta1** API version of EndpointSlice will no longer be
132162
* use per Endpoint `zone` field instead of deprecated `topology["topology.kubernetes.io/zone"]` field
133163
* `topology` is replaced with the `deprecatedTopology` field which is not writable in v1
134164
-->
135-
**discovery.k8s.io/v1beta1** API 版本的 EndpointSlice 将不会在 v1.25 版本中继续提供。
165+
从 v1.25 版本开始不再提供 **discovery.k8s.io/v1beta1** API 版本的 EndpointSlice。
136166

137167
* 迁移清单和 API 客户端使用 **discovery.k8s.io/v1** API 版本，此 API 从 v1.21 版本开始可用；
138168
* 所有的已保存的对象都可以通过新的 API 来访问；
@@ -146,12 +176,12 @@ The **discovery.k8s.io/v1beta1** API version of EndpointSlice will no longer be
146176
#### Event {#event-v125}
147177

148178
<!--
149-
The **events.k8s.io/v1beta1** API version of Event will no longer be served in v1.25.
179+
The **events.k8s.io/v1beta1** API version of Event is no longer served as of v1.25.
150180
151181
* Migrate manifests and API clients to use the **events.k8s.io/v1** API version, available since v1.19.
152182
* All existing persisted objects are accessible via the new API
153183
-->
154-
**events.k8s.io/v1beta1** API 版本的 Event 将不会在 v1.25 版本中继续提供。
184+
从 v1.25 版本开始不再提供 **events.k8s.io/v1beta1** API 版本的 Event。
155185

156186
* 迁移清单和 API 客户端使用 **events.k8s.io/v1** API 版本，此 API 从 v1.19 版本开始可用；
157187
* 所有的已保存的对象都可以通过新的 API 来访问；
@@ -186,27 +216,29 @@ The **events.k8s.io/v1beta1** API version of Event will no longer be served in v
186216
#### HorizontalPodAutoscaler {#horizontalpodautoscaler-v125}
187217

188218
<!--
189-
The **autoscaling/v2beta1** API version of HorizontalPodAutoscaler will no longer be served in v1.25.
219+
The **autoscaling/v2beta1** API version of HorizontalPodAutoscaler is no longer served as of v1.25.
220+
190221
191222
* Migrate manifests and API clients to use the **autoscaling/v2** API version, available since v1.23.
192223
* All existing persisted objects are accessible via the new API
193224
-->
194-
**autoscaling/v2beta1** API 版本的 HorizontalPodAutoscaler 将不会在 v1.25 版本中继续提供。
225+
从 v1.25 版本开始不再提供 **autoscaling/v2beta1** API 版本的
226+
HorizontalPodAutoscaler。
195227

196228
* 迁移清单和 API 客户端使用 **autoscaling/v2** API 版本，此 API 从 v1.23 版本开始可用；
197229
* 所有的已保存的对象都可以通过新的 API 来访问；
198230

199231
#### PodDisruptionBudget {#poddisruptionbudget-v125}
200232

201233
<!--
202-
The **policy/v1beta1** API version of PodDisruptionBudget will no longer be served in v1.25.
234+
The **policy/v1beta1** API version of PodDisruptionBudget is no longer served as of v1.25.
203235
204236
* Migrate manifests and API clients to use the **policy/v1** API version, available since v1.21.
205237
* All existing persisted objects are accessible via the new API
206238
* Notable changes in **policy/v1**:
207239
* an empty `spec.selector` (`{}`) written to a `policy/v1` PodDisruptionBudget selects all pods in the namespace (in `policy/v1beta1` an empty `spec.selector` selected no pods). An unset `spec.selector` selects no pods in either API version.
208240
-->
209-
**policy/v1beta1** API 版本的 PodDisruptionBudget 将不会在 v1.25 版本中继续提供。
241+
从 v1.25 版本开始不再提供 **policy/v1beta1** API 版本的 PodDisruptionBudget。
210242

211243
* 迁移清单和 API 客户端使用 **policy/v1** API 版本，此 API 从 v1.21 版本开始可用；
212244
* 所有的已保存的对象都可以通过新的 API 来访问；
@@ -219,14 +251,14 @@ The **policy/v1beta1** API version of PodDisruptionBudget will no longer be serv
219251
#### PodSecurityPolicy {#psp-v125}
220252

221253
<!--
222-
PodSecurityPolicy in the **policy/v1beta1** API version will no longer be served in v1.25, and the PodSecurityPolicy admission controller will be removed.
254+
PodSecurityPolicy in the **policy/v1beta1** API version is no longer served as of v1.25, and the PodSecurityPolicy admission controller will be removed.
223255
224256
Migrate to [Pod Security Admission](/docs/concepts/security/pod-security-admission/)
225257
or a [3rd party admission webhook](/docs/reference/access-authn-authz/extensible-admission-controllers/).
226258
For a migration guide, see [Migrate from PodSecurityPolicy to the Built-In PodSecurity Admission Controller](/docs/tasks/configure-pod-container/migrate-from-psp/).
227259
For more information on the deprecation, see [PodSecurityPolicy Deprecation: Past, Present, and Future](/blog/2021/04/06/podsecuritypolicy-deprecation-past-present-and-future/).
228260
-->
229-
**policy/v1beta1** API 版本中的 PodSecurityPolicy 将不会在 v1.25 中提供，
261+
从 v1.25 版本开始不再提供 **policy/v1beta1** API 版本中的 PodSecurityPolicy，
230262
并且 PodSecurityPolicy 准入控制器也会被删除。
231263

232264
迁移到 [Pod 安全准入](/zh-cn/docs/concepts/security/pod-security-admission/)或[第三方准入 webhook](/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers/)。
@@ -236,13 +268,13 @@ For more information on the deprecation, see [PodSecurityPolicy Deprecation: Pas
236268
#### RuntimeClass {#runtimeclass-v125}
237269

238270
<!--
239-
RuntimeClass in the **node.k8s.io/v1beta1** API version will no longer be served in v1.25.
271+
RuntimeClass in the **node.k8s.io/v1beta1** API version is no longer served as of v1.25.
240272
241273
* Migrate manifests and API clients to use the **node.k8s.io/v1** API version, available since v1.20.
242274
* All existing persisted objects are accessible via the new API
243275
* No notable changes
244276
-->
245-
**node.k8s.io/v1beta1** API 版本中的 RuntimeClass 将不会在 v1.25 中提供。
277+
从 v1.25 版本开始不再提供 **node.k8s.io/v1beta1** API 版本中的 RuntimeClass。
246278

247279
* 迁移清单和 API 客户端使用 **node.k8s.io/v1** API 版本，此 API 从 v1.20 版本开始可用；
248280
* 所有的已保存的对象都可以通过新的 API 来访问；

0 commit comments

Comments
 (0)