Merge pull request #32003 from kerthcet/feature/graduate-defaultPodTopologySpread-to-ga

feat: feature gate DefaultPodTopologySpread is GA
This commit is contained in:
Kubernetes Prow Robot
2022-03-04 17:00:51 -08:00
committed by GitHub
@@ -4,21 +4,11 @@ content_type: concept
weight: 40 weight: 40
--- ---
{{< feature-state for_k8s_version="v1.19" state="stable" >}}
<!-- leave this shortcode in place until the note about EvenPodsSpread is
obsolete -->
<!-- overview --> <!-- overview -->
You can use _topology spread constraints_ to control how {{< glossary_tooltip text="Pods" term_id="Pod" >}} are spread across your cluster among failure-domains such as regions, zones, nodes, and other user-defined topology domains. This can help to achieve high availability as well as efficient resource utilization. You can use _topology spread constraints_ to control how {{< glossary_tooltip text="Pods" term_id="Pod" >}} are spread across your cluster among failure-domains such as regions, zones, nodes, and other user-defined topology domains. This can help to achieve high availability as well as efficient resource utilization.
{{< note >}}
In versions of Kubernetes before v1.18, you must enable the `EvenPodsSpread`
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) on
the [API server](/docs/concepts/overview/components/#kube-apiserver) and the
[scheduler](/docs/reference/command-line-tools-reference/kube-scheduler/) in order to use Pod
topology spread constraints.
{{< /note >}}
<!-- body --> <!-- body -->
@@ -321,21 +311,17 @@ profiles:
``` ```
{{< note >}} {{< note >}}
The score produced by default scheduling constraints might conflict with the [`SelectorSpread` plugin](/docs/reference/scheduling/config/#scheduling-plugins)
score produced by the is disabled by default. It's recommended to use `PodTopologySpread` to achieve similar
[`SelectorSpread` plugin](/docs/reference/scheduling/config/#scheduling-plugins). behavior.
It is recommended that you disable this plugin in the scheduling profile when
using default constraints for `PodTopologySpread`.
{{< /note >}} {{< /note >}}
#### Internal default constraints #### Built-in default constraints {#internal-default-constraints}
{{< feature-state for_k8s_version="v1.20" state="beta" >}} {{< feature-state for_k8s_version="v1.24" state="stable" >}}
With the `DefaultPodTopologySpread` feature gate, enabled by default, the If you don't configure any cluster-level default constraints for pod topology spreading,
legacy `SelectorSpread` plugin is disabled. then kube-scheduler acts as if you specified the following default topology constraints:
kube-scheduler uses the following default topology constraints for the
`PodTopologySpread` plugin configuration:
```yaml ```yaml
defaultConstraints: defaultConstraints:
@@ -348,7 +334,7 @@ defaultConstraints:
``` ```
Also, the legacy `SelectorSpread` plugin, which provides an equivalent behavior, Also, the legacy `SelectorSpread` plugin, which provides an equivalent behavior,
is disabled. is disabled by default.
{{< note >}} {{< note >}}
The `PodTopologySpread` plugin does not score the nodes that don't have The `PodTopologySpread` plugin does not score the nodes that don't have