●Change8

Migrating to Linkerd edge-25.1.1

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

Released: 1/16/2025

1
Breaking Changes
1
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

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

proxyproxyInitViz dashboardLink CR

Breaking Changes

●Issue #1

The minimum TLS version required when communicating with the Kubernetes API server has been bumped to v1.3. Ensure your Kubernetes API server supports TLS v1.3 (supported since v1.19, but Linkerd requires at least v1.22).

Migration Steps

  1. 1
    If you set `proxyInit.closeWaitTimeoutSecs`, you must now also ensure that `proxy.runAsRoot` is set, as this is now validated at install time.

Release Summary

This release bumps the minimum required TLS version to v1.3, adds RHEL iptables support, allows communication with unready pods, and introduces configuration options for pod annotations and Viz dashboard labels. This release is marked as NOT RECOMMENDED; use edge-25.1.2 instead.

Need More Details?

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

View Full Changelog