Skip to content

Commit cee12bf

Browse files
committed
Update graduation criteria to clarify metric stability class
1 parent b88799f commit cee12bf

File tree

1 file changed

+10
-7
lines changed
  • keps/sig-api-machinery/1693-warnings

1 file changed

+10
-7
lines changed

keps/sig-api-machinery/1693-warnings/README.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@
1313
- [Test Plan](#test-plan)
1414
- [Risks and Mitigations](#risks-and-mitigations)
1515
- [Graduation Criteria](#graduation-criteria)
16-
- [Beta](#beta)
17-
- [GA](#ga)
16+
- [Beta graduation](#beta-graduation)
17+
- [GA graduation](#ga-graduation)
1818
- [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy)
1919
- [Version Skew Strategy](#version-skew-strategy)
2020
- [Implementation History](#implementation-history)
@@ -181,17 +181,20 @@ drive automated action in clients, graduation criteria is primarily oriented
181181
toward the stability level of the administrator metrics, and the ability to
182182
disable the server sending warnings during the beta period.
183183

184-
#### Beta
184+
#### Beta graduation
185185

186+
* Test plan is implemented
186187
* API server output of `Warning` headers for deprecated API use is feature-gated and enabled by default
187-
* Server metric for deprecated API use is marked as beta-level
188+
* The metric for deprecated API use is registered at [stability level `ALPHA`](https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes)
188189
* client-go logs warnings by default
189190
* kubectl outputs warnings to stderr
190191

191-
#### GA
192+
#### GA graduation
192193

193-
* API server output of warning headers for deprecated API use is unconditionally enabled
194-
* Server metric for deprecated API use is marked as stable
194+
* At least two releases after Beta
195+
* Gathered feedback on metric structure and use from multi-cluster admins
196+
* API server output of `Warning` headers for deprecated API use is unconditionally enabled
197+
* Server metric for deprecated API use is registered at [stability level `STABLE`](https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes)
195198

196199
### Upgrade / Downgrade Strategy
197200

0 commit comments

Comments
 (0)