This page documents the compatibility matrix of versions of Contour, Envoy, Kubernetes, and the Contour Operator. These combinations of versions are specifically tested and supported by the Contour maintainers. Other combinations may work, but are not tested or supported.
|Contour Version||Envoy Version||Kubernetes Versions||Operator Version|
|1.11.0||1.16.2||1.19, 1.18, 1.17||1.11.0|
|1.10.1||1.16.2||1.19, 1.18, 1.17||N/A|
|1.10.0||1.16.0||1.19, 1.18, 1.17||N/A|
|1.9.0||1.15.1||1.18, 1.17, 1.16||N/A|
|1.8.2||1.15.1||1.18, 1.17, 1.16||N/A|
|1.8.1||1.15.0||1.18, 1.17, 1.16||N/A|
|1.8.0||1.15.0||1.18, 1.17, 1.16||N/A|
|1.7.0||1.15.0||1.18, 1.17, 1.16||N/A|
|1.6.1||1.14.3||1.18, 1.17, 1.16||N/A|
|1.6.0||1.14.2||1.18, 1.17, 1.16||N/A|
|1.5.1||1.14.2||1.18, 1.17, 1.16||N/A|
|1.5.0||1.14.1||1.18, 1.17, 1.16||N/A|
|1.4.0||1.14.1||1.17, 1.16, 1.15||N/A|
|1.3.0||1.13.1||1.17, 1.16, 1.15||N/A|
|1.2.1||1.13.1||1.17, 1.16, 1.15||N/A|
|1.2.0||1.13.0||1.17, 1.16, 1.15||N/A|
|1.1.0||1.12.2||1.15, 1.14, 1.13||N/A|
|1.0.1||1.12.2||1.15, 1.14, 1.13||N/A|
|1.0.0||1.11.2||1.15, 1.14, 1.13||N/A|
Contour utilizes client-go to watch for resources in a Kubernetes cluster. Since Kubernetes is backwards compatible with clients, older client-go versions will work with many different Kubernetes cluster versions. Contour also only consumes a small number of quite stable Kubernetes APIs. This means that Contour is likely compatible with more Kubernetes versions than those listed in the matrix. However, combinations not listed are not tested or supported by the Contour maintainers.
client-go package includes a compatibility matrix as to what Kubernetes API versions are supported with the version of client-go.
Note: Since Contour now uses
apiextensions.k8s.io/v1 for Custom Resource Definitions (CRDs), the minimum compatible Kubernetes version is v1.16.
Contour requires the following Envoy extensions. If you are using the image recommended in our example deployment no action is required. If you are providing your own Envoy it must be compiled with the following extensions:
Note: This list of extensions was last verified to be complete with Envoy v1.16.1.