Policies · Legacy policies

Retry

Legacy HTTP, gRPC and TCP retry settings for a destination service.

Kuma

Behaviour per target

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

Output: MeshRetry

Outbound shape. conf changes:

  • tcp.maxConnectAttempts → tcp.maxConnectAttempt (singular).
  • http.retryOn enum values are recased (gateway_error → GatewayError, 5xx stays).
  • http.retriableMethods → extra http.retryOn entries (GET → HttpMethodGet).
  • http.retriableStatusCodes → extra http.retryOn entries, one per code (503 → "503"). MeshRetry accepts any HTTP status code in retryOn on 2.14 and 3.0. The retriable_status_codes condition is implied by the codes and dropped.
  • gRPC retryOn cancelled → Canceled.
  • numRetries, perTryTimeout, backOff.* keep their paths.

retryOn: retriable_headers has no MeshRetry equivalent and is dropped with a warning.

--to-latest v3 (3.0) converted

Output: MeshRetry

Same conversion with labels-only references. A destination with no kuma.io/service tag is an error (original in _manual/). The source object is listed for deletion.

Timeline

VersionChange
3.0Removed from the resource registry. Meshes created on 3.0 also no longer get the default mesh-retry-all-<mesh> policy.

Source files