Skip to content

traefik/traefik-migration-tool

Repository files navigation

traefik-migration-tool

GitHub release Build Status

A migration tool from Traefik v1 to Traefik v2.

Features:

  • ⛵ Migrate 'Ingress' to Traefik 'IngressRoute' resources.
  • 🔒 Migrate acme.json file from Traefik v1 to Traefik v2.
  • 🖹 Migrate the static configuration contained in the file traefik.toml to a Traefik v2 file.

Usage

Install

From Binaries

You can use pre-compiled binaries:

  • To get the binary just download the latest release for your OS/Arch from the releases page
  • Unzip the archive.
  • Add traefik-migration-tool in your PATH.

With Docker

You can use a Docker image:

docker run --rm -w /data -v ${PWD}:/data traefik/traefik-migration-tool <options here>

Limits

Unsupported annotations:

  • ingress.kubernetes.io/preserve-host
  • ingress.kubernetes.io/session-cookie-name
  • ingress.kubernetes.io/affinity
  • ingress.kubernetes.io/buffering
  • ingress.kubernetes.io/circuit-breaker-expression
  • ingress.kubernetes.io/max-conn-amount
  • ingress.kubernetes.io/max-conn-extractor-func
  • ingress.kubernetes.io/responseforwarding-flushinterval
  • ingress.kubernetes.io/load-balancer-method
  • ingress.kubernetes.io/auth-realm
  • ingress.kubernetes.io/service-weights
  • ingress.kubernetes.io/error-pages