Updated on 2025-04-27 GMT+08:00

AZ Deployment

  • If the parameter is set to Preferred, add-on pods will have labels with the key topology.kubernetes.io/zone for soft anti-affinity deployment, and the anti-affinity type is preferredDuringSchedulingIgnoredDuringExecution.

    Add-on pods will be preferentially scheduled to nodes in different AZs. If resources in some AZs are insufficient, some add-on pods may be scheduled to the same AZ which has sufficient resources.

  • If the parameter is set to Required, add-on pods will have labels with the key topology.kubernetes.io/zone for hard anti-affinity deployment, and the anti-affinity type is requiredDuringSchedulingIgnoredDuringExecution.

    A maximum of one pod of the same add-on can be deployed in each AZ. The number of pods that can run cannot exceed the number of AZs in the cluster. If the node where the add-on pod runs is faulty, the faulty pod cannot be automatically migrated to another node in the same AZ.

  • If the parameter is set to Equivalent mode, add-on pods will have labels with the key topology.kubernetes.io/zone for configuring topology spread constraints. The pod difference between different topology domains cannot exceed 1 for add-on pods to be evenly distributed in different AZs.

    The effect of this mode is between that of the preferred mode and that of the required mode. In the equivalent mode, add-on pods can be deployed in different AZs. Additionally, multiple pods can be deployed in a single AZ when there are more pods than AZs. To use this mode, you need to plan node resources in each AZ in advance to ensure that each AZ has sufficient node resources for deploying pods. (If there are more than 1 add-on pods in a single AZ, the nodes to which the add-on pods can be scheduled in each AZ should be one more than the actual add-on pods in the current AZ.) This ensures successful deployment of add-on pods although node resources in some AZ are insufficient and smooth scheduling of add-on pods during update.

Value Range

Preferred, Required, or Equivalent mode

Default Value

Preferred

Modifiable

Yes

Scope

CCE standard and CCE Turbo clusters

Suggestions

Set the parameter to Preferred.