●Change8

Migrating to Linkerd edge-25.4.3

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

Released: 4/16/2025

1
Breaking Changes
1
Migration Steps
2
Affected Symbols

⚠️ Check Your Code

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

CLIGateway API resources

Breaking Changes

●Issue #1

The default port for tracing has changed from the OpenCensus port (55678) to the OpenTelemetry port (4317). If you rely on the old default port for tracing ingestion, you must update your configuration to use 4317.

Migration Steps

  1. 1
    If you are using tracing, ensure your tracing configuration points to port 4317 instead of the previous default of 55678.

Release Summary

This release updates several dependencies and modifies the CLI to better handle Gateway API CRDs. Crucially, it changes the default tracing port to 4317 (OpenTelemetry standard).

Need More Details?

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

View Full Changelog