Files

62 lines
2.4 KiB
Markdown

---
title: "Traefik Helm Chart Documentation"
description: "Migrate to the latest version of Traefik Mesh, a simple and lightweight service mesh, in your cluster's Helm chart. Read the technical documentation."
---
# Migrations
Helm Chart
{: .subtitle }
## v2.1 to v3.0
### Traefik Mesh renaming
All existing resources have been renamed and prefixed by `traefik-mesh`.
For example, the `maesh-controller`resource has been renamed to `traefik-mesh-controller`.
### Mesh Property Name
Inside the Traefik Mesh helm chart, the `mesh` property has been renamed to `proxy`.
### Image version
Since version `v1.4`, Traefik Mesh uses plain [Traefik](https://github.com/traefik/traefik/) Docker image for proxies.
Therefore, to change the image version used for the controller, or the proxies you should use the `controller.image` and `proxy.image` options.
### Default Mode
The `mesh.defaultMode` option has been removed.
You should use the new `defaultMode` option to configure the default traffic mode.
## v2.0 to v2.1
### Default Mode
The `mesh.defaultMode` option has been deprecated and will be removed in a future major release.
You should use the new `defaultMode` option to configure the default traffic mode.
### Prometheus and Grafana services
Prior to version `v2.1`, when the Metrics chart is deployed, Prometheus and Grafana services are exposed by default through a `NodePort`.
For security reasons, those services are not exposed by default anymore.
To expose them you should use the new `prometheus.service` and `grafana.service` options, more details in the corresponding [values.yaml](https://github.com/traefik/mesh-helm-chart/blob/8a7a193a1718129ad6e02ff313b219029d6daffe/mesh/charts/metrics/values.yaml).
## v1.x to v2.0
### Image version
Since version `v1.2`, [Traefik](https://github.com/traefik/traefik/) is used as a library.
Therefore, the `controller.image` and `mesh.image` options have been removed.
You should use the new `image` option as described in the [documentation](../install.md#deploy-helm-chart).
### Log Level
The `controller.logging.debug` and `mesh.logging` options have been removed.
You should use the new `controller.logLevel` and `mesh.logLevel` options to configure the logging level for the controller and proxies.
### SMI Mode
The `smi.enable` option has been deprecated and removed.
You should use the new and backward compatible ACL mode option as described in the [documentation](../install.md#access-control-list).