Version compatibility

Uses: Kong Gateway Operator
Related Documentation

The following table presents the general compatibility of Kong Gateway Operator with Kong Ingress Controller minor versions.

Kong Ingress Controller

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 Gateway Operator 1.0.x
Kong Gateway Operator 1.1.x
Kong Gateway Operator 1.2.x
Kong Gateway Operator 1.3.x
Kong Gateway Operator 1.4.x
Kong Gateway Operator 1.5.x
Kong Gateway Operator 1.6.x

General

The following table presents the general compatibility of Kong Gateway Operator with specific Kubernetes versions. Users should expect all the combinations marked with true to work and to be supported.

Kubernetes 1.25.x 1.26.x 1.27.x 1.28.x 1.29.x 1.3.x 1.31.x 1.32.x
Kong Gateway Operator 1.0.x
Kong Gateway Operator 1.1.x
Kong Gateway Operator 1.2.x
Kong Gateway Operator 1.3.x
Kong Gateway Operator 1.4.x
Kong Gateway Operator 1.5.x
Kong Gateway Operator 1.6.x

Gateway API

The following table presents the compatibility of Kong Gateway Operator with specific Gateway API versions. As Kong Gateway 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 0.8.1.x 1.0.0.x 1.1.0.x 1.2.0.x 1.3.0.x
Kong Gateway Operator 1.0.x
Kong Gateway Operator 1.1.x
Kong Gateway Operator 1.2.x
Kong Gateway Operator 1.3.x
Kong Gateway Operator 1.4.x
Kong Gateway Operator 1.5.x
Kong Gateway Operator 1.6.x

kubernetes-configuration CRDs

Starting with 1.5, Kong Gateway 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 Gateway Operator used gateway-operator CRDs, packaged with the operator helm chart.

Below table contains a compatibility matrix for kubernetes-configuration CRDs and Kong Gateway Operator versions.

kubernetes-configuration 1.3.x.x 1.4.x.x
Kong Gateway Operator 1.4.x
Kong Gateway Operator 1.5.x
Kong Gateway Operator 1.6.x
Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!