●Change8

edge-25.1.2

Breaking Changes
📦 linkerd
⚠ 2 breaking✨ 3 features🐛 1 fixes🔧 2 symbols

Summary

This RECOMMENDED release updates OpenTelemetry conventions, reduces multicluster load, and fixes a service-mirror bug, while introducing a breaking change to the Link resource's probe period format.

⚠️ Breaking Changes

  • The format of the Link resource's `probeSpec.period` has changed to require a [GEP-2257] duration string. Links created by edge-25.1.1 will fail validation if edited or redeployed in this release unless `probeSpec.period` is updated to the new duration string format.
  • The ability to query by `authority` in `linkerd viz stat` has been removed. Users must update their commands to no longer use the `authority` target.

Migration Steps

  1. If you have existing Link resources created with edge-25.1.1, you must update their `probeSpec.period` field to conform to the [GEP-2257] duration string format before editing or redeploying them.
  2. Remove usage of the `authority` target when running `linkerd viz stat` commands.

✨ New Features

  • OpenTelemetry trace labels have been updated to follow current [HTTP semantic conventions].
  • Reduced load on the Kubernetes API server when a multicluster setup mirrors many Services.
  • The CNI `updateStrategy` can now be configured (thanks, [Shane Starcher]!).

🐛 Bug Fixes

  • Fixed an issue where cluster watch would restart upon Link status updates in service-mirror (issue 13031).

🔧 Affected Symbols

Link.probeSpec.periodlinkerd viz stat