@@ -142,37 +142,41 @@ might have to add an equivalent field or represent it as an annotation.
142
142
添加一个新的等效字段或者将其表现为一个注解。
143
143
144
144
<!--
145
- **Rule #3: An API version in a given track may not be deprecated until a new
146
- API version at least as stable is released.**
145
+ **Rule #3: An API version in a given track may not be deprecated in favor of a less stable API version.**
147
146
148
- GA API versions can replace GA API versions as well as beta and alpha API
149
- versions. Beta API versions *may not* replace GA API versions.
147
+ * GA API versions can replace beta and alpha API versions.
148
+ * Beta API versions can replace earlier beta and alpha API versions, but *may not* replace GA API versions.
149
+ * Alpha API versions can replace earlier alpha API versions, but *may not* replace GA or beta API versions.
150
150
-->
151
- ** 规则 #3 :给定类别的 API 版本在新的、稳定性未降低的 API 版本发布之前不可被废弃 。**
151
+ ** 规则 #3 :给定类别的 API 版本不可被弃用以支持稳定性更差的 API 版本 。**
152
152
153
- 一个正式发布的(GA)API 版本可替换现有的正式 API 版本或 alpha、beta API 版本。
154
- Beta API 版本 * 不可以* 替代正式的 API 版本。
153
+ * 一个正式发布的(GA)API 版本可替换 beta 或 alpha API 版本。
154
+ * Beta API 版本可以替换早期的 beta 和 alpha API 版本,但 ** 不可以** 替换正式的 API 版本。
155
+ * Alpha API 版本可以替换早期的 alpha API 版本,但 ** 不可以** 替换正式的或 beta API 版本。
155
156
156
157
<!--
157
- **Rule #4a: Other than the most recent API versions in each track, older API
158
- versions must be supported after their announced deprecation for a duration of
159
- no less than:**
158
+ **Rule #4a: minimum API lifetime is determined by the API stability level**
160
159
161
- * **GA: 12 months or 3 releases (whichever is longer) **
162
- * **Beta: 9 months or 3 releases (whichever is longer)**
163
- * **Alpha: 0 releases **
160
+ * **GA API versions may be marked as deprecated, but must not be removed within a major version of Kubernetes **
161
+ * **Beta API versions must be supported for 9 months or 3 releases (whichever is longer) after deprecation **
162
+ * **Alpha API versions may be removed in any release without prior deprecation notice **
164
163
165
- This covers the [maximum supported version skew of 2 releases](/docs/setup/release /version-skew-policy/).
164
+ This ensures beta API support covers the [maximum supported version skew of 2 releases](/releases /version-skew-policy/).
166
165
-->
167
- ** 规则 #4a:除了每类 API 版本中的最新版本,旧的 API 版本在其被宣布被废弃之后
168
- 至少以下时长内仍需被支持:**
166
+ ** 规则 #4a:最短 API 生命周期由 API 稳定性级别决定**
169
167
170
- * ** GA:12 个月或者 3 个发布版本(取其较长者) **
171
- * ** Beta: 9 个月或者 3 个发布版本(取其较长者 )**
172
- * ** Alpha: 0 个发布版本 **
168
+ * ** GA API 版本可以被标记为已弃用,但不得在 Kubernetes 的主要版本中删除 **
169
+ * ** Beta API 版本必须支持 9 个月或弃用后的 3 个版本(以较长者为准 )**
170
+ * ** Alpha API 版本可能会在任何版本中被删除,不另行通知 **
173
171
174
- 这里也包含了关于[ 最大支持 2 个发布版本的版本偏差] ( /zh/docs/setup/release/version-skew-policy/ )
175
- 的约定。
172
+ 这确保了 beta API 支持涵盖了[ 最多 2 个版本的支持版本偏差] ( /zh/releases/version-skew-policy/ ) 。
173
+
174
+ {{< note >}}
175
+ <!--
176
+ There are no current plans for a major version revision of Kubernetes that removes GA APIs.
177
+ -->
178
+ 目前没有删除正式版本 API 的 Kubernetes 主要版本修订计划。
179
+ {{< /note >}}
176
180
177
181
<!--
178
182
Until [#52185](https://github.com/kubernetes/kubernetes/issues/52185) is
@@ -363,9 +367,9 @@ API versions are supported in a series of subsequent releases.
363
367
<td>
364
368
<ul>
365
369
<!-- li>v2beta2 is deprecated, "action required" relnote</li>
366
- <li>v1 is deprecated, "action required" relnote </li -->
370
+ <li>v1 is deprecated in favor of v2, but will not be removed </li -->
367
371
<li>v2beta2 已被弃用,发布说明中包含对应的 "action required(采取行动)" 说明</li>
368
- <li>v1 已被弃用,发布说明中包含对应的 "action required(采取行动)" 说明 </li>
372
+ <li>v1 已被弃用,取而代之的是 v2,但不会被删除 </li>
369
373
</ul>
370
374
</td>
371
375
</tr>
@@ -400,23 +404,6 @@ API versions are supported in a series of subsequent releases.
400
404
</ul>
401
405
</td>
402
406
</tr>
403
- <tr>
404
- <td>X+16</td>
405
- <!-- td>v2, v1 (deprecated)</td -->
406
- <td>v2、v1(已弃用)</td>
407
- <td>v2</td>
408
- <td></td>
409
- </tr>
410
- <tr>
411
- <td>X+17</td>
412
- <td>v2</td>
413
- <td>v2</td>
414
- <td>
415
- <ul>
416
- <li>v1 被删除,发布说明中包含对应的 "action required(采取行动)" 说明</li>
417
- </ul>
418
- </td>
419
- </tr>
420
407
</tbody >
421
408
</table >
422
409
0 commit comments