Traefik v2からv3へのマイグレーション¶

(2023.5.20更新)

Traefik v2からv3への移行時に一部の設定を変更する必要があります。

IPWhiteList¶

v3では、IPWhiteListミドルウェアをIPAllowListに名称変更しましたが、構成は何も変更していません。

v3では、gRPCリクエストの報告されるステータスコードはGrpc-Statusヘッダーの値になりました。

pilotオプションは、静的設定から削除されました。
tracing.datadog.globaltagオプションは削除されました。
Consul、Consul Catalog、Nomadの各プロバイダーからnamespaceオプションが削除されました。
ForwardAuthミドルウェア、および HTTP、Consul、Etcd、Redis、ZooKeeper、Marathon、Consul Catalog、Dockerの各プロバイダーからtls.caOptionalオプションが削除されました。
Headersミドルウェアから sslRedirect、sslTemporaryRedirect、sslHost、sslForceHost、featurePolicyオプションが削除されました。
StripPrefixミドルウェアからforceSlashオプションが削除されました。
preferServerCipherSuitesオプションが削除されました。

HeadersおよびHeadersRegexpmatcherはそれぞれ HeaderおよびHeaderRegexpに名称が変更されました。
QueryRegexpが導入され、正規表現を用いたクエリ値のマッチングが可能になりました。
HeaderRegexp、HostRegexp、PathRegexp、QueryRegexp、HostSNIRegexpの各matcherは、Go言語のregexp構文を使用するようになりました。
すべてのmatcherは、1つの値を取るようになり(但しHeaders、HeaderRegexp、Query、QueryRegexp は 2つ取ります)、以前の動作と同様に論理演算子を使用して明示的に結合する必要があります。
Queryは、値を持たないクエリ値(例: /search?mobile)にマッチする単一の値を取ることができます。
HostHeaderは削除されました。代わりにHostを使用してください。

v3では、バックエンドによって設定されていない場合、Content-Typeヘッダは自動検出されなくなりました。ContentTypeミドルウェアを使用して、Content-Typeヘッダー値の自動検出を有効にする必要があります。

v3では、HTTP/3は実験的な機能ではなくなりました。experimental.http3オプションは、静的設定から削除されました。

v3では、TCPServersTransportのサポートが導入されました。そのため、KubernetesCRDプロバイダを使用する場合、RBAC および CRD マニフェストを更新する必要があります。

TCP LoadBalancerのterminationDelayオプションは削除されました。このオプションは、TCPServersTransportレベルで直接設定できるようになったので、こちらのドキュメントを参照してください。

v3では、Rancher v1プロバイダーは削除されました。Rancher v1は活発にメンテナンスされておらず、v2は標準の Kubernetesプロバイダーとしてサポートされているからです。

Rancher 2.xはKubernetesを必要とし、Traefikがクエリするためのメタデータエンドポイントを持ちません。そのため、Rancher 2.xのユーザーはKubernetesのCRDプロバイダーを直接利用する必要があります。

v3では、Marathonプロバイダが削除されました。

v3では、InfluxDB v1.xのメンテナンスが2021年に終了したため、InfluxDB v1のメトリクスプロバイダは削除されています。

v3では、Kubernetes CRDsのAPIグループtraefik.containo.usは削除されました。代わりにAPIグループtraefik.ioを使用してください。

v3では、Dockerプロバイダが2つに分割されました。