traefik/docs/content/deprecation/features.md

# Feature Deprecation Notices

This page is maintained and updated periodically to reflect our roadmap and any decisions around feature deprecation.

| Feature                                                                                             | Deprecated | End of Support | Removal |
|-----------------------------------------------------------------------------------------------------|------------|----------------|---------|
| [Pilot](#pilot)                                                                                     | 2.7        | 2.8            | 2.9     |
| [Consul Enterprise Namespace](#consul-enterprise-namespace)                                         | 2.8        | N/A            | 3.0     |
| [TLS 1.0 and 1.1 Support](#tls-10-and-11)                                                           | N/A        | 2.8            | N/A     |
| [Nomad Namespace](#nomad-namespace)                                                                 | 2.10       | N/A            | 3.0     |
| [Kubernetes CRDs API Group `traefik.containo.us`](#kubernetes-crds-api-group-traefikcontainous)     | 2.10       | N/A            | 3.0     |
| [Kubernetes CRDs API Version `traefik.io/v1alpha1`](#kubernetes-crds-api-version-traefikiov1alpha1) | N/A        | N/A            | 3.0     |

## Impact

### Pilot

Metrics will continue to function normally up to 2.8, when they will be disabled.  
In 2.9, the Pilot platform and all Traefik integration code will be permanently removed.

Starting on 2.7 the pilot token will not be a requirement anymore for plugins.  
Since 2.8, a [new plugin catalog](https://plugins.traefik.io) is available, decoupled from Pilot.

### Consul Enterprise Namespace

Starting on 2.8 the `namespace` option of Consul and Consul Catalog providers is deprecated, 
please use the `namespaces` options instead.  

### TLS 1.0 and 1.1

Starting on 2.8 the default TLS options will use the minimum version of TLS 1.2. Of course, it can still be overridden with custom configuration.  

### Nomad Namespace

Starting on 2.10 the `namespace` option of the Nomad provider is deprecated,
please use the `namespaces` options instead.

### Kubernetes CRDs API Group `traefik.containo.us`

In v2.10, the Kubernetes CRDs API Group `traefik.containo.us` is deprecated, and its support will end starting with Traefik v3. Please use the API Group `traefik.io` instead.

### Kubernetes CRDs API Version `traefik.io/v1alpha1`

The newly introduced Kubernetes CRD API Version `traefik.io/v1alpha1` will subsequently be removed in Traefik v3. The following version will be `traefik.io/v1`.
Add a Feature Deprecation page 2022-03-24 11:28:07 +00:00			`# Feature Deprecation Notices`

			`This page is maintained and updated periodically to reflect our roadmap and any decisions around feature deprecation.`

Introduce traefik.io API Group CRDs 2023-03-20 14:38:08 +00:00			`\| Feature \| Deprecated \| End of Support \| Removal \|`
			`\|-----------------------------------------------------------------------------------------------------\|------------\|----------------\|---------\|`
			`\| [Pilot](#pilot) \| 2.7 \| 2.8 \| 2.9 \|`
			`\| [Consul Enterprise Namespace](#consul-enterprise-namespace) \| 2.8 \| N/A \| 3.0 \|`
			`\| [TLS 1.0 and 1.1 Support](#tls-10-and-11) \| N/A \| 2.8 \| N/A \|`
Support multiple namespaces in the Nomad Provider 2023-03-21 14:50:06 +00:00			`\| [Nomad Namespace](#nomad-namespace) \| 2.10 \| N/A \| 3.0 \|`
Introduce traefik.io API Group CRDs 2023-03-20 14:38:08 +00:00			\| [Kubernetes CRDs API Group `traefik.containo.us`](#kubernetes-crds-api-group-traefikcontainous) \| 2.10 \| N/A \| 3.0 \|
			\| [Kubernetes CRDs API Version `traefik.io/v1alpha1`](#kubernetes-crds-api-version-traefikiov1alpha1) \| N/A \| N/A \| 3.0 \|
Add a Feature Deprecation page 2022-03-24 11:28:07 +00:00
			`## Impact`

Remove Pilot support 2022-09-14 08:56:08 +00:00			`### Pilot`
Add a Feature Deprecation page 2022-03-24 11:28:07 +00:00
			`Metrics will continue to function normally up to 2.8, when they will be disabled.`
Remove Pilot support 2022-09-14 08:56:08 +00:00			`In 2.9, the Pilot platform and all Traefik integration code will be permanently removed.`
Add a Feature Deprecation page 2022-03-24 11:28:07 +00:00
Remove Pilot support 2022-09-14 08:56:08 +00:00			`Starting on 2.7 the pilot token will not be a requirement anymore for plugins.`
			`Since 2.8, a [new plugin catalog](https://plugins.traefik.io) is available, decoupled from Pilot.`
Support multiple namespaces for Consul and ConsulCatalog providers Co-authored-by: Kevin Pollet <pollet.kevin@gmail.com> 2022-06-03 10:00:09 +00:00
Update deprecation notices 2022-06-30 12:34:08 +00:00			`### Consul Enterprise Namespace`
Support multiple namespaces for Consul and ConsulCatalog providers Co-authored-by: Kevin Pollet <pollet.kevin@gmail.com> 2022-06-03 10:00:09 +00:00
			Starting on 2.8 the `namespace` option of Consul and Consul Catalog providers is deprecated,
			please use the `namespaces` options instead.
Change default TLS options for more security 2022-09-08 08:56:08 +00:00
			`### TLS 1.0 and 1.1`

			`Starting on 2.8 the default TLS options will use the minimum version of TLS 1.2. Of course, it can still be overridden with custom configuration.`
Introduce traefik.io API Group CRDs 2023-03-20 14:38:08 +00:00
Support multiple namespaces in the Nomad Provider 2023-03-21 14:50:06 +00:00			`### Nomad Namespace`

			Starting on 2.10 the `namespace` option of the Nomad provider is deprecated,
			please use the `namespaces` options instead.

Introduce traefik.io API Group CRDs 2023-03-20 14:38:08 +00:00			### Kubernetes CRDs API Group `traefik.containo.us`

			In v2.10, the Kubernetes CRDs API Group `traefik.containo.us` is deprecated, and its support will end starting with Traefik v3. Please use the API Group `traefik.io` instead.

			### Kubernetes CRDs API Version `traefik.io/v1alpha1`

			The newly introduced Kubernetes CRD API Version `traefik.io/v1alpha1` will subsequently be removed in Traefik v3. The following version will be `traefik.io/v1`.