[zh] Resync using-api section
This commit is contained in:
@@ -171,7 +171,8 @@ This covers the [maximum supported version skew of 2 releases](/docs/setup/relea
|
||||
* **Beta: 9 个月或者 3 个发布版本(取其较长者)**
|
||||
* **Alpha: 0 个发布版本**
|
||||
|
||||
这里也包含了关于[最大支持 2 个发布版本的版本偏差](/zh/docs/setup/release/version-skew-policy/)的约定。
|
||||
这里也包含了关于[最大支持 2 个发布版本的版本偏差](/zh/docs/setup/release/version-skew-policy/)
|
||||
的约定。
|
||||
|
||||
<!--
|
||||
Until [#52185](https://github.com/kubernetes/kubernetes/issues/52185) is
|
||||
@@ -181,7 +182,7 @@ deprecation timelines in this document), but the API server must remain capable
|
||||
of decoding/converting previously persisted data from storage.
|
||||
-->
|
||||
{{< note >}}
|
||||
在[#52185](https://github.com/kubernetes/kubernetes/issues/52185)被解决之前,
|
||||
在 [#52185](https://github.com/kubernetes/kubernetes/issues/52185) 被解决之前,
|
||||
已经被保存到持久性存储中的 API 版本都不可以被去除。
|
||||
你可以禁止这些版本所对应的 REST 末端(在符合本文中弃用时间线的前提下),
|
||||
但是 API 服务器必须仍能解析和转换存储中以前写入的数据。
|
||||
@@ -699,6 +700,14 @@ therefore the rules for deprecation are as follows:
|
||||
|
||||
特性门控的版本管理与之前讨论的组件版本管理不同,因此其对应的弃用策略如下:
|
||||
|
||||
<!--
|
||||
**Rule #8: Feature gates must be deprecated when the corresponding feature they control
|
||||
transitions a lifecycle stage as follows. Feature gates must function for no less than:**
|
||||
|
||||
* **Beta feature to GA: 6 months or 2 releases (whichever is longer)**
|
||||
* **Beta feature to EOL: 3 months or 1 release (whichever is longer)**
|
||||
* **Alpha feature to EOL: 0 releases**
|
||||
-->
|
||||
**规则 #8:特性门控所对应的功能特性经历下面所列的成熟性阶段转换时,特性门控
|
||||
必须被弃用。特性门控弃用时必须在以下时长内保持其功能可用:**
|
||||
|
||||
@@ -730,8 +739,7 @@ this impacts removal of a metric during a Kubernetes release. These classes
|
||||
are determined by the perceived importance of the metric. The rules for
|
||||
deprecating and removing a metric are as follows:
|
||||
-->
|
||||
|
||||
### 弃用度量值 {#Deprecating a metric}
|
||||
### 弃用度量值 {#deprecating-a-metric}
|
||||
|
||||
Kubernetes 控制平面的每个组件都公开度量值(通常是 `/metrics` 端点),它们通常由集群管理员使用。
|
||||
并不是所有的度量值都是同样重要的:一些度量值通常用作 SLIs 或被使用来确定 SLOs,这些往往比较重要。
|
||||
@@ -755,20 +763,25 @@ Kubernetes 控制平面的每个组件都公开度量值(通常是 `/metrics`
|
||||
-->
|
||||
**规则 #9a: 对于相应的稳定性类别,度量值起作用的周期必须不小于:**
|
||||
|
||||
* **STABLE: 4 个发布版本或者 12 个月 (取其较长者)**
|
||||
* **ALPHA: 0 个发布版本**
|
||||
* **STABLE: 4 个发布版本或者 12 个月 (取其较长者)**
|
||||
* **ALPHA: 0 个发布版本**
|
||||
|
||||
**规则 #9b: 在度量值被宣布启用之后,它起作用的周期必须不小于:**
|
||||
|
||||
* **STABLE: 3 个发布版本或者 9 个月 (取其较长者)**
|
||||
* **ALPHA: 0 个发布版本**
|
||||
* **STABLE: 3 个发布版本或者 9 个月 (取其较长者)**
|
||||
* **ALPHA: 0 个发布版本**
|
||||
|
||||
<!--
|
||||
Deprecated metrics will have their description text prefixed with a deprecation notice
|
||||
string '(Deprecated from x.y)' and a warning log will be emitted during metric
|
||||
registration. Like their stable undeprecated counterparts, deprecated metrics will
|
||||
be automatically registered to the metrics endpoint and therefore visible.
|
||||
-->
|
||||
已弃用的度量值将在其描述文本前加上一个已弃用通知字符串 '(Deprecated from x.y)',
|
||||
并将在度量值被记录期间发出警告日志。就像稳定的、未被弃用的度量指标一样,
|
||||
被弃用的度量值将自动注册到 metrics 端点,因此被弃用的度量值也是可见的。
|
||||
|
||||
<!--
|
||||
On a subsequent release (when the metric's `deprecatedVersion` is equal to
|
||||
_current_kubernetes_version - 3_)), a deprecated metric will become a _hidden_ metric.
|
||||
**_Unlike_** their deprecated counterparts, hidden metrics will _no longer_ be
|
||||
@@ -779,15 +792,11 @@ escape hatch to properly migrate off of a deprecated metric, if they were not
|
||||
able to react to the earlier deprecation warnings. Hidden metrics should be
|
||||
deleted after one release.
|
||||
-->
|
||||
已弃用的度量值将在其描述文本前加上一个已弃用通知字符串 '(Deprecated from x.y)',
|
||||
并将在度量值被记录期间发出警告日志。就像稳定的、未被弃用的度量指标一样,
|
||||
被弃用的度量值将自动注册到 metrics 端点,因此被弃用的度量值也是可见的。
|
||||
|
||||
在随后的版本中(当度量值 `deprecatedVersion` 等于_当前 Kubernetes 版本 - 3_),
|
||||
被弃用的度量值将变成 _隐藏(Hidden)_ metric 度量值。
|
||||
与被弃用的度量值不同,隐藏的度量值将不再被自动注册到 metrics 端点(因此被隐藏)。
|
||||
但是,它们可以通过可执行文件的命令行标志显式启用(`--show-hidden-metrics-for-version=`)。
|
||||
|
||||
但是,它们可以通过可执行文件的命令行标志显式启用
|
||||
(`--show-hidden-metrics-for-version=`)。
|
||||
如果集群管理员不能对早期的弃用警告作出反应,这一设计就为他们提供了抓紧迁移弃用度量值的途径。
|
||||
隐藏的度量值应该在再过一个发行版本后被删除。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user