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