Policies · Mesh* policies

MeshTimeout

Connection, idle and request timeouts on inbound (rules[]) and outbound (to[]) traffic.

Kuma

Behaviour per target

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

Output: MeshTimeout

  • from[] → rules[]: each from[i].default becomes rules[i].default and the source targetRef is dropped (rules apply to every client).
  • When from[] and to[] coexist, the policy is split: <name> carries rules[] and <name>-outbound carries to[]. The validator rejects rules[] and to[] in one spec.
  • MeshSubset refs with kuma.io/service tags and old <name>_<ns>_svc_<port> MeshService names are rewritten: top level to Dataplane, to[] to MeshService (labels when the policy and target namespaces differ).
  • spec.targetRef.proxyTypes is reported (removed in 3.0, see Policy targeting). The 2.x default mesh-gateways-timeout-all-<mesh> (proxyTypes: [Gateway], streamIdleTimeout: 5s) gets a delete-before-upgrading advisory.
--to-latest v3 (3.0) rewritten

Output: MeshTimeout

Same rewrites as v2, plus the rules every Mesh* policy gets under v3:

  • spec.targetRef.proxyTypes is removed when that keeps the scope or only adds former gateway proxies ([Sidecar], both values, or a kind other than Mesh/MeshSubset). [Gateway] alone is written to _manual/: without the field the policy selects every proxy.

  • The default mesh-gateways-timeout-all-<mesh> is not converted. On 3.0 it sets a 5s streamIdleTimeout on every sidecar (kumahq/kuma#18857). The original goes to _manual/ and is listed under Delete Before Upgrading to 3.0, with the skipCreatingInitialPolicies step that keeps 2.14 Kubernetes from recreating it.

  • name/namespace/mesh on MeshService, MeshExternalService, MeshMultiZoneService and MeshHTTPRoute refs become labels (kuma.io/display-name, k8s.kuma.io/namespace, plus the policy's kuma.io/zone).

  • to[].targetRef.kind must be Mesh, MeshService, MeshExternalService, MeshMultiZoneService or MeshHTTPRoute; anything else is reported.

  • Control-plane-owned labels (kuma.io/origin, kuma.io/zone, kuma.io/policy-role, …) are removed.

Timeline

VersionChange
2.10rules[] API added; from[] deprecated. Dataplane added as a top-level kind; MeshSubset deprecated.
3.0from removed. Real resources selected by labels only. Top-level targetRef limited to Mesh and Dataplane. targetRef.proxyTypes removed; the default mesh-gateways-timeout-all-<mesh> then applies to every proxy.

Source files