Change8

edge-25.9.4

Breaking Changes
📦 linkerd
1 breaking1 features🐛 1 fixes🔧 3 symbols

Summary

This release is RECOMMENDED and introduces a breaking change where the `linkerd-crds` Helm chart no longer installs Gateway API CRDs by default. It fixes a critical bug related to stale endpoint data in native sidecar proxies and adds support for ReplacePrefixMatch in HTTPRoute filters.

⚠️ Breaking Changes

  • The `linkerd-crds` Helm chart no longer installs the Gateway API CRDs by default. To restore this behavior, set `installGatewayAPI=true` when installing the chart.

Migration Steps

  1. If you are running Linkerd 2.18/edge-25.4.4 or higher and previously relied on the `linkerd-crds` chart to install Gateway API CRDs, upgrading will not uninstall them. If you are upgrading from an earlier version, you must install the Gateway API CRDs manually if you require them.

✨ New Features

  • Added correct support for ReplacePrefixMatch in HTTPRoute RequestRedirect filters.

🐛 Bug Fixes

  • Fixed an issue where native sidecar proxies could have stale endpoint data, leading to traffic routing problems (specifically when targeting the linkerd-admin port in native-sidecar mode).

🔧 Affected Symbols

linkerd-crds Helm chartnative sidecar proxiesHTTPRoute RequestRedirect filters