●Change8

Migrating to Linkerd edge-25.1.2

Version edge-25.1.2 introduces 2 breaking changes. This guide details how to update your code.

Released: 1/23/2025

2
Breaking Changes
2
Migration Steps
2
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

Link.probeSpec.periodlinkerd viz stat

Breaking Changes

●Issue #1

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.

●Issue #2

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. 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. 2
    Remove usage of the `authority` target when running `linkerd viz stat` commands.

Release 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.

Need More Details?

View the full release notes and all changes for Linkerd edge-25.1.2.

View Full Changelog