Version Compatibility
Kong’s Ingress Controller is compatible with different flavors of Kong. The following sections detail on compatibility between versions for the last five controller versions. Compatibility for older versions is available in those versions’ documentation.
Kong
By Kong, we are here referring to the official distribution of the Open-Source Kong Gateway.
| Kubernetes Ingress Controller | 2.1.x | 2.2.x | 2.3.x | 2.4.x | 2.5.x | 2.6.x | 2.7.x | 2.8.x |
|---|---|---|---|---|---|---|---|---|
| Kong 1.5.x | ||||||||
| Kong 2.0.x | ||||||||
| Kong 2.1.x | ||||||||
| Kong 2.2.x | ||||||||
| Kong 2.3.x | ||||||||
| Kong 2.4.x | ||||||||
| Kong 2.5.x | ||||||||
| Kong 2.6.x | ||||||||
| Kong 2.7.x | ||||||||
| Kong 2.8.x | ||||||||
| Kong 3.0.x |
Kong Enterprise
Kong Enterprise is the official enterprise distribution, which includes all other enterprise functionality, built on top of the Open-Source Kong Gateway.
| Kubernetes Ingress Controller | 2.1.x | 2.2.x | 2.3.x | 2.4.x | 2.5.x | 2.6.x | 2.7.x | 2.8.x |
|---|---|---|---|---|---|---|---|---|
| Kong Enterprise 1.5.x | ||||||||
| Kong Enterprise 2.1.x | ||||||||
| Kong Enterprise 2.2.x | ||||||||
| Kong Enterprise 2.3.x | ||||||||
| Kong Enterprise 2.4.x | ||||||||
| Kong Enterprise 2.5.x | ||||||||
| Kong Enterprise 2.6.x | ||||||||
| Kong Enterprise 2.7.x | ||||||||
| Kong Enterprise 2.8.x | ||||||||
| Kong Enterprise 3.0.x |
Kubernetes
General
The following table presents the general compatibility of Kubernetes Ingress Controller with specific Kubernetes versions. Users should expect all the combinations marked with to work and to be supported if there are bugs.
| Kubernetes Ingress Controller | 2.1.x | 2.2.x | 2.3.x | 2.4.x | 2.5.x | 2.6.x | 2.7.x | 2.8.x |
|---|---|---|---|---|---|---|---|---|
| Kubernetes 1.16 | ||||||||
| Kubernetes 1.17 | ||||||||
| Kubernetes 1.18 | ||||||||
| Kubernetes 1.19 | ||||||||
| Kubernetes 1.20 | ||||||||
| Kubernetes 1.21 | ||||||||
| Kubernetes 1.22 | ||||||||
| Kubernetes 1.23 | ||||||||
| Kubernetes 1.24 | ||||||||
| Kubernetes 1.25 | ||||||||
| Kubernetes 1.26 |
Gateway API
The following table presents the compatibility of Kubernetes Ingress Controller’s Gateway API with specific Kubernetes minor versions. As Kubernetes Ingress Controller implements Gateway API features using the upstream project, which defines its own compatibility declarations, the expected compatibility of Gateway API features might be limited to those.
| Kubernetes Ingress Controller | 2.4.x | 2.5.x | 2.6.x | 2.7.x | 2.8.x |
|---|---|---|---|---|---|
| Kubernetes 1.17 | |||||
| Kubernetes 1.18 | |||||
| Kubernetes 1.19 | |||||
| Kubernetes 1.20 | |||||
| Kubernetes 1.21 | |||||
| Kubernetes 1.22 | |||||
| Kubernetes 1.23 | |||||
| Kubernetes 1.24 | |||||
| Kubernetes 1.25 | |||||
| Kubernetes 1.26 |
For specific Gateway API resources support, please refer to the Gateway API Support page.
Istio
The Kubernetes Ingress Controller can be integrated with an Istio Service Mesh to use Kong Gateway as an ingress gateway for application traffic into the mesh network. See an example of this in the Istio Guide.
For each Kubernetes Ingress Controller release, tests are run to verify this documentation with upcoming versions of KIC and Istio. The following table lists the tested combinations:
| Kubernetes Ingress Controller | 2.1.x | 2.2.x | 2.3.x | 2.4.x | 2.5.x | 2.6.x | 2.7.x | 2.8.x |
|---|---|---|---|---|---|---|---|---|
| Istio 1.8 | ||||||||
| Istio 1.9 | ||||||||
| Istio 1.10 | ||||||||
| Istio 1.11 | ||||||||
| Istio 1.12 | ||||||||
| Istio 1.13 | ||||||||
| Istio 1.14 | ||||||||
| Istio 1.15 | ||||||||
| Istio 1.16 |