The following table presents the general compatibility of Kong Operator with Kong Ingress Controller minor versions.
Version compatibility
Uses:
Kong Operator
Related Documentation
Kong Ingress Controller
Note: Kong Operator 2.0.0+ includes Kong Ingress Controller. The table below is only relevant for Kong Gateway Operator versions below 2.0.0.
| Kong Ingress Controller | 2.11.x | 2.12.x | 3.0.x | 3.1.x | 3.2.x | 3.3.x | 3.4.x |
|---|---|---|---|---|---|---|---|
| Kong Operator 1.0.x | Supported | Supported | Supported | Supported | Supported | Supported | Supported |
| Kong Operator 1.1.x | Supported | Supported | Supported | Supported | Supported | Supported | Supported |
| Kong Operator 1.2.x | Not supported | Not supported | Not supported | Supported | Supported | Supported | Supported |
| Kong Operator 1.3.x | Not supported | Not supported | Not supported | Supported | Supported | Supported | Supported |
| Kong Operator 1.4.x | Not supported | Not supported | Not supported | Supported | Supported | Supported | Supported |
| Kong Operator 1.5.x | Not supported | Not supported | Not supported | Supported | Supported | Supported | Supported |
| Kong Operator 1.6.x | Not supported | Not supported | Not supported | Supported | Supported | Supported | Supported |
General
The following table presents the general compatibility of Kong Operator with specific Kubernetes versions. Users should expect all the combinations marked with true to work and to be supported.
| Kubernetes | 1.27.x | 1.28.x | 1.29.x | 1.3.x | 1.31.x | 1.32.x | 1.33.x | 1.34.x | 1.35.x |
|---|---|---|---|---|---|---|---|---|---|
| Kong Operator 2.0.x | Not supported | Supported | Supported | Supported | Supported | Supported | Supported | Not supported | Not supported |
| Kong Operator 2.1.x | Not supported | Not supported | Not supported | Supported | Supported | Supported | Supported | Supported | Supported |
Gateway API
The following table presents the compatibility of Kong Operator with specific Gateway API versions. As Kong Operator 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.
| Gateway API | 1.0.0.x | 1.1.0.x | 1.2.0.x | 1.3.0.x | 1.4.0.x |
|---|---|---|---|---|---|
| Kong Operator 2.0.x | Supported | Supported | Supported | Supported | Not supported |
| Kong Operator 2.1.x | Supported | Supported | Supported | Supported | Supported |
kubernetes-configuration CRDs
Note: Kong Operator 2.0.0+ moved the CRD definitions to its repository. With that
kubernetes-configurationCRDs are not relevant for Kong Operator 2.0.0+ and the compatibility table below is only relevant for Kong Gateway Operator versions below 2.0.0.
Starting with 1.5, Kong Operator works with kubernetes-configuration CRDs.
These CRDs are backwards compatible with CRDs from gateway-operator 1.4 and older unless stated otherwise in the release notes in kuberentes-configuration CHANGELOG.md.
Older versions of Kong Operator used gateway-operator CRDs, packaged with the operator helm chart.
Below table contains a compatibility matrix for kubernetes-configuration CRDs and Kong Operator versions.
| kubernetes-configuration | 1.3.x.x | 1.4.x.x |
|---|---|---|
| Kong Operator 1.4.x | Not supported | Not supported |
| Kong Operator 1.5.x | Supported | Not supported |
| Kong Operator 1.6.x | Supported | Supported |