Policies · Mesh* policies

MeshLoadBalancingStrategy

Load-balancing algorithm, hash policies and locality awareness for outbound traffic.

Kuma

Behaviour per target

--to-latest v2 (2.x) rewritten

Output: MeshLoadBalancingStrategy

  • to[].default.loadBalancer.{ringHash,maglev}.hashPolicies → to[].default.hashPolicies (auto-fixed).
  • hashPolicies[].type: SourceIP → type: Connection with connection.sourceIP: true (auto-fixed, at either location). 2.14 accepts SourceIP but builds no Envoy hash policy from it, so source-IP hashing starts to take effect once the output is applied; the warning says so.
--to-latest v3 (3.0) rewritten

Output: MeshLoadBalancingStrategy

v2 rewrites (3.0 removes SourceIP from the enum and rejects it), plus:

  • to[].default.localityAwareness.crossZone on an entry whose targetRef.kind is not MeshMultiZoneService is reported; 3.0 rejects it.
  • Labels-only refs and control-plane label removal. Allowed to[].targetRef.kind: Mesh, MeshService, MeshExternalService, MeshMultiZoneService, MeshHTTPRoute.

Timeline

VersionChange
2.10hashPolicies.type: SourceIP removed.
3.0Load-balancer-specific hashPolicies removed. crossZone requires a MeshMultiZoneService target.

Source files