Traefik 2.10.0 → 2.11.0
8 versions, 4 migration-guide sections in 1 version, 0 required stops
Version by version, oldest first
2.10.1 – 2.10.7: no action items (7 versions)
2.11.0 2024-02-12
Migration
IPWhiteList (HTTP)
In v2.11, the IPWhiteList middleware is deprecated, please use the IPAllowList middleware instead.
From doc.traefik.io/traefik/v2.11/migration/v2/#ipwhitelist-http
Migration
IPWhiteList (TCP)
In v2.11, the IPWhiteList middleware is deprecated, please use the IPAllowList middleware instead.
From doc.traefik.io/traefik/v2.11/migration/v2/#ipwhitelist-tcp
Migration
TLS CipherSuites
By default, cipher suites without ECDHE support are no longer offered by either clients or servers during pre-TLS 1.3 handshakes. This change can be reverted with the
tlsrsakex=1 GODEBUGsetting. (https://go.dev/doc/go1.22#crypto/tls)
The RSA key exchange cipher suites are way less secure than the modern ECDHE cipher suites and exposes to potential vulnerabilities like the Marvin Attack. Decision has been made to support ECDHE cipher suites only by default.
The following ciphers have been removed from the default list:
TLS_RSA_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384
To enable these ciphers, please set the option CipherSuites in your TLS configuration or set the environment variable GODEBUG=tlsrsakex=1.
From doc.traefik.io/traefik/v2.11/migration/v2/#tls-ciphersuites
Migration
Minimum TLS Version
By default, the minimum version offered by
crypto/tlsservers is now TLS 1.2 if not specified with config.MinimumVersion, matching the behavior of crypto/tls clients. This change can be reverted with thetls10server=1 GODEBUGsetting. (https://go.dev/doc/go1.22#crypto/tls)
To enable TLS 1.0, please set the option MinVersion to VersionTLS10 in your TLS configuration or set the environment variable GODEBUG=tls10server=1.
From doc.traefik.io/traefik/v2.11/migration/v2/#minimum-tls-version
Release notes from github.com/traefik/traefik/blob/master/CHANGELOG.md, and Migration: Steps needed between the versions (v2.11 documentation), checked 18 hours ago. Only text the vendor marks as breaking, or puts in a warning/caution/important note, is shown; read the full notes for anything else. Traefik's release notes (CHANGELOG.md, GitHub releases) are lists of merged pull requests and mark nothing as breaking. What is quoted instead is Traefik's migration documentation on doc.traefik.io: “Migration: Steps needed between the versions” (v3), the same page of the v2.11 documentation (v2), and “Configuration Details for Migrating from Traefik v2 to v3” (on 3.0.0). Each section of those pages is labelled “Migration” and shown on the release its heading names (“v3.3 to v3.4” on 3.4.0). A section naming a canceled release (v2.4.10, v2.9.0) is shown on the next release of that line. Versions are covered from 2.0.0. No required stop is documented.