Enhancement Description
- One-line enhancement description (can be used as a release note): k8s.io Group Protection
- Kubernetes Enhancement Proposal:
API groups are organized by namespace, similar to java packages. authorization.k8s.io is one example. When users create
CRDs, they get to specify an API group and their type will be injected into that group by the kube-apiserver.
The *.k8s.io or *.kubernetes.io groups are owned by the Kubernetes community and protected by API review (see What APIs need to be reviewed,
to ensure consistency and quality. To avoid confusion in our API groups and prevent accidentally claiming a
space inside of the kubernetes API groups, the kube-apiserver needs to be updated to protect these reserved API groups.
This KEP proposes adding an api-approved.kubernetes.io annotation to CustomResourceDefinition. This is only needed if
the CRD group is k8s.io, kubernetes.io, or ends with .k8s.io, .kubernetes.io. The value should be a link to a
to a URL where the current spec was approved, so updates to the spec should also update the URL.
metadata:
annotations:
"api-approved.kubernetes.io": "https://github.com/kubernetes/kubernetes/pull/78458"
Please keep this description up to date. This will help the Enhancement Team to track the evolution of the enhancement efficiently.
Enhancement Description
API groups are organized by namespace, similar to java packages.
authorization.k8s.iois one example. When users createCRDs, they get to specify an API group and their type will be injected into that group by the kube-apiserver.
The
*.k8s.ioor*.kubernetes.iogroups are owned by the Kubernetes community and protected by API review (see What APIs need to be reviewed,to ensure consistency and quality. To avoid confusion in our API groups and prevent accidentally claiming a
space inside of the kubernetes API groups, the kube-apiserver needs to be updated to protect these reserved API groups.
This KEP proposes adding an
api-approved.kubernetes.ioannotation to CustomResourceDefinition. This is only needed ifthe CRD group is
k8s.io,kubernetes.io, or ends with.k8s.io,.kubernetes.io. The value should be a link to ato a URL where the current spec was approved, so updates to the spec should also update the URL.
k/enhancements) update PR(s):k/k) update PR(s):k/website) update PR(s):Please keep this description up to date. This will help the Enhancement Team to track the evolution of the enhancement efficiently.