Add defails about enabling or disabling extensions/v1beta1 api group (#18842)
This commit is contained in:
@@ -121,21 +121,22 @@ There are two supported paths to extending the API with [custom resources](/docs
|
|||||||
to make it seamless for clients.
|
to make it seamless for clients.
|
||||||
|
|
||||||
|
|
||||||
## Enabling API groups
|
## Enabling or disabling API groups
|
||||||
|
|
||||||
Certain resources and API groups are enabled by default. They can be enabled or disabled by setting `--runtime-config`
|
Certain resources and API groups are enabled by default. They can be enabled or disabled by setting `--runtime-config`
|
||||||
on apiserver. `--runtime-config` accepts comma separated values. For ex: to disable batch/v1, set
|
on apiserver. `--runtime-config` accepts comma separated values. For example: to disable batch/v1, set
|
||||||
`--runtime-config=batch/v1=false`, to enable batch/v2alpha1, set `--runtime-config=batch/v2alpha1`.
|
`--runtime-config=batch/v1=false`, to enable batch/v2alpha1, set `--runtime-config=batch/v2alpha1`.
|
||||||
The flag accepts comma separated set of key=value pairs describing runtime configuration of the apiserver.
|
The flag accepts comma separated set of key=value pairs describing runtime configuration of the apiserver.
|
||||||
|
|
||||||
IMPORTANT: Enabling or disabling groups or resources requires restarting apiserver and controller-manager
|
{{< note >}}Enabling or disabling groups or resources requires restarting apiserver and controller-manager
|
||||||
to pick up the `--runtime-config` changes.
|
to pick up the `--runtime-config` changes.{{< /note >}}
|
||||||
|
|
||||||
## Enabling resources in the groups
|
## Enabling specific resources in the extensions/v1beta1 group
|
||||||
|
|
||||||
DaemonSets, Deployments, HorizontalPodAutoscalers, Ingresses, Jobs and ReplicaSets are enabled by default.
|
DaemonSets, Deployments, StatefulSet, NetworkPolicies, PodSecurityPolicies and ReplicaSets in the `extensions/v1beta1` API group are disabled by default.
|
||||||
Other extensions resources can be enabled by setting `--runtime-config` on
|
For example: to enable deployments and daemonsets, set
|
||||||
apiserver. `--runtime-config` accepts comma separated values. For example: to disable deployments and ingress, set
|
`--runtime-config=extensions/v1beta1/deployments=true,extensions/v1beta1/daemonsets=true`.
|
||||||
`--runtime-config=extensions/v1beta1/deployments=false,extensions/v1beta1/ingresses=false`
|
|
||||||
|
{{< note >}}Individual resource enablement/disablement is only supported in the `extensions/v1beta1` API group for legacy reasons.{{< /note >}}
|
||||||
|
|
||||||
{{% /capture %}}
|
{{% /capture %}}
|
||||||
|
|||||||
Reference in New Issue
Block a user