●Change8

Migrating to Linkerd edge-25.3.4

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

Released: 3/27/2025

1
Breaking Changes
2
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

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

linkerd multicluster link-genlinkunlinklinkerd viz tapauthority

Breaking Changes

●Issue #1

Linkerd now requires the Gateway API CRDs to be installed before installation. To fix this, either install the Gateway API CRDs manually before installing Linkerd, or set `installGatewayAPI=true` during installation (note: a CLI bug in this release prevents the CLI from installing them automatically).

Migration Steps

  1. 1
    If installing Linkerd for the first time, ensure the Gateway API CRDs are installed on the cluster beforehand, or set `installGatewayAPI=true` during installation.
  2. 2
    When performing multicluster operations, use `linkerd multicluster link-gen` instead of the deprecated `link` or `unlink` commands.

Release Summary

This release introduces mandatory Gateway API CRD installation, deprecates old multicluster commands in favor of `link-gen`, and restores IPv6 support. This version is explicitly marked as NOT RECOMMENDED.

Need More Details?

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

View Full Changelog