Consul
Consul on Kubernetes 2.0.0
We are pleased to announce the following Consul updates.
Release highlights
- Multi-port service support: Consul on Kubernetes now supports multi-port services in both transparent proxy and non-transparent proxy modes. In transparent proxy mode, no changes are required to downstream or upstream service deployments. You can configure the required configuration entries, such as service intentions and exported services, to enable multi-port communication through the service mesh. Applications can address specific ports on a multi-port upstream using the virtual address format
<port-name>.<service>.virtual.consul. In non-transparent proxy mode, you can define multi-port upstreams using theconsul.hashicorp.com/connect-service-upstreamsannotation with thedestination_portparameter. For more information, refer to Enable transparent proxy mode on Kubernetes and Consul on Kubernetes annotations and labels reference.
Supported software
This version of Consul on Kubernetes supports the following software versions:
- Consul v2.0.x
- Consul Dataplane 1.9.x - 2.0.x
- Kubernetes 1.30.x - 1.34.x
- kubectl 1.30.x - 1.34.x
- Helm 3.11.3+
Upgrading
For more detailed information, please refer to the upgrade details page and the changelogs.
Known issues
- Consul does not support a combination of protocols for a multi-port service. All ports of a service must use the same protocol.
- Kubernetes annotations have a character limit, which constrains the number of upstreams you can specify for a service using the
consul.hashicorp.com/connect-service-upstreamsannotation.
Changelogs
The changelogs for this major release version and any maintenance versions are listed below.