You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
for more details) and only applies to new beta API introduced after v1.24.
926
929
927
930
## Examples and docs
928
931
@@ -985,7 +988,11 @@ complexity of upgradeability and lack of long-term support and lack of
985
988
upgradability.
986
989
- Beta level:
987
990
- Object Versioning: API version name contains `beta` (e.g. `v2beta3`)
988
-
- Availability: in official Kubernetes releases, and enabled by default
991
+
- Availability: in official Kubernetes releases; feature is disabled by default,
992
+
but may be enabled by flag. This applies to new beta API introduced after v1.24
993
+
(see [KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-architecture/3136-beta-apis-off-by-default/README.md)
994
+
for more deatils). Beta APIs which were introduced before v1.24 are enabled by
995
+
default.
989
996
- Audience: users interested in providing feedback on features
990
997
- Completeness: all API operations, CLI commands, and UI support should be
991
998
implemented; end-to-end tests complete; the API has had a thorough API review
@@ -1191,7 +1198,7 @@ provides some details
1191
1198
1192
1199
In future Kubernetes versions:
1193
1200
1194
-
* if the feature progresses to beta or stable status, the feature gate can be removed or be enabled by default.
1201
+
* if the feature progresses to stable status, the feature gate can be removed or be enabled by default.
1195
1202
* if the schema of the alpha field must change in an incompatible way, a new field name must be used.
1196
1203
* if the feature is abandoned, or the field name is changed, the field should be removed from the gostruct, with a tombstone comment ensuring the field name and protobuf tag are not reused:
1197
1204
@@ -1253,7 +1260,12 @@ This ensures a cluster with multiple servers at skewed releases (which happens d
1253
1260
will not allow data to be persisted which the previous release of the API server would choke on.
1254
1261
1255
1262
Typically, a feature gate is used to do this rollout, starting in alpha and disabled by default in release 1,
1256
-
and graduating to beta and enabled by default in release 2.
1263
+
and graduating to stable and enabled by default in release 2.
1264
+
With beta as an intermediate step, release 3 (stable) would enable the feature gate by default.
1265
+
The behavior changed with Kubernetes v1.24
1266
+
(for details see the [KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-architecture/3136-beta-apis-off-by-default/README.md)).
1267
+
Beta APIs introduced before v1.24 will be enabled by default.
1268
+
Beta API introduced after v1.24 will be disabled by default.
1257
1269
1258
1270
1. Add a feature gate to the API server to control enablement of the new enum value (and associated function):
1259
1271
@@ -1342,7 +1354,7 @@ The recommended place to do this is in the REST storage strategy's Validate/Vali
1342
1354
}
1343
1355
```
1344
1356
1345
-
5. After at least one release, the feature can be promoted to beta or GA and enabled by default.
1357
+
5. After at least one release, the feature can be promoted to beta or GA. But it will only be enabled by defaultforGA.
1346
1358
1347
1359
In [staging/src/k8s.io/apiserver/pkg/features/kube_features.go](https://git.k8s.io/kubernetes/staging/src/k8s.io/apiserver/pkg/features/kube_features.go):
0 commit comments