●Change8

Migrating to Linkerd edge-25.2.2

Version edge-25.2.2 introduces 1 breaking change. This guide details how to update your code.

Released: 2/20/2025

1
Breaking Changes
2
Migration Steps
2
Affected Symbols

⚠️ Check Your Code

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

ServerRoute

Breaking Changes

●Issue #1

The default tracing protocol has changed from OpenCensus to OpenTelemetry. If you rely on OpenCensus tracing, you must explicitly configure it, as it is no longer the default.

Migration Steps

  1. 1
    If you require IPv6 functionality, use version edge-25.4.1 or later instead of this release due to a known bug affecting IPv6.
  2. 2
    If you rely on OpenCensus for tracing, you must explicitly configure it, as OpenTelemetry is now the default.

Release Summary

This release changes the default tracing protocol to OpenTelemetry and includes fixes for policy controller lease handling and deterministic ordering of Server resources. Sites requiring IPv6 should avoid this version.

Need More Details?

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

View Full Changelog