https://github.com/traefik/traefik-migration-tool

A migration tool from Traefik v1 to Traefik v2
https://github.com/traefik/traefik-migration-tool

traefik

Last synced: 2 months ago
JSON representation

A migration tool from Traefik v1 to Traefik v2

• Host: GitHub
• URL: https://github.com/traefik/traefik-migration-tool
• Owner: traefik
• License: apache-2.0
• Created: 2019-08-29T13:22:50.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2022-07-06T16:50:01.000Z (almost 3 years ago)
• Last Synced: 2025-03-28T13:36:44.603Z (3 months ago)
• Topics: traefik
• Language: Go
• Homepage: https://docs.traefik.io/migration/v1-to-v2/
• Size: 452 KB
• Stars: 149
• Watchers: 16
• Forks: 32
• Open Issues: 5
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - traefik/traefik-migration-tool - A migration tool from Traefik v1 to Traefik v2 (others)

README

        
# traefik-migration-tool

[![GitHub release](https://img.shields.io/github/release/traefik/traefik-migration-tool.svg)](https://github.com/traefik/traefik-migration-tool/releases/latest)

[![Build Status](https://github.com/traefik/traefik-migration-tool/actions/workflows/main.yml/badge.svg)](https://github.com/traefik/traefik-migration-tool/actions)

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

- [Commands documentation](docs/traefik-migration-tool.md)

## 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](https://github.com/traefik/traefik-migration-tool/releases)

* Unzip the archive.

* Add `traefik-migration-tool` in your `PATH`.

### With Docker

You can use a Docker image:

```sh

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

```

## 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`