github.com/projectcontour/contour@v1.28.2/site/content/resources/compatibility-matrix.md (about) 1 --- 2 title: Compatibility Matrix 3 layout: page 4 --- 5 6 This page documents the compatibility matrix of versions of Contour, Envoy, Kubernetes, and Gateway API. 7 These combinations of versions are specifically tested in CI and supported by the Contour maintainers. 8 9 ## Compatibility Matrix 10 11 | Contour Version | Envoy Version | Kubernetes Versions | Gateway API Version | 12 | --------------- | :------------------- | ------------------- | --------------------| 13 | main | [1.29.1][46] | 1.29, 1.28, 1.27 | [1.0.0][110] | 14 | 1.27.0 | [1.28.0][45] | 1.28, 1.27, 1.26 | [0.8.1][109] | 15 | 1.26.1 | [1.27.2][42] | 1.28, 1.27, 1.26 | [0.8.1][109] | 16 | 1.26.0 | [1.27.0][41] | 1.28, 1.27, 1.26 | [0.8.0][108] | 17 | 1.25.3 | [1.26.6][43] | 1.27, 1.26, 1.25 | [0.6.2][107] | 18 | 1.25.2 | [1.26.4][40] | 1.27, 1.26, 1.25 | [0.6.2][107] | 19 | 1.25.1 | [1.26.4][40] | 1.27, 1.26, 1.25 | [0.6.2][107] | 20 | 1.25.0 | [1.26.1][35] | 1.27, 1.26, 1.25 | [0.6.2][107] | 21 | 1.24.6 | [1.25.11][44] | 1.26, 1.25, 1.24 | [0.6.0][106] | 22 | 1.24.5 | [1.25.9][39] | 1.26, 1.25, 1.24 | [0.6.0][106] | 23 | 1.24.4 | [1.25.6][36] | 1.26, 1.25, 1.24 | [0.6.0][106] | 24 | 1.24.3 | [1.25.4][32] | 1.26, 1.25, 1.24 | [0.6.0][106] | 25 | 1.24.2 | [1.25.2][31] | 1.26, 1.25, 1.24 | [0.6.0][106] | 26 | 1.24.1 | [1.25.1][28] | 1.26, 1.25, 1.24 | [0.6.0][106] | 27 | 1.24.0 | [1.25.0][25] | 1.26, 1.25, 1.24 | [0.6.0][106] | 28 | 1.23.6 | [1.24.10][38] | 1.25, 1.24, 1.23 | [0.5.1][105] | 29 | 1.23.5 | [1.24.5][33] | 1.25, 1.24, 1.23 | [0.5.1][105] | 30 | 1.23.4 | [1.24.3][30] | 1.25, 1.24, 1.23 | [0.5.1][105] | 31 | 1.23.3 | [1.24.2][27] | 1.25, 1.24, 1.23 | [0.5.1][105] | 32 | 1.23.2 | [1.24.1][24] | 1.25, 1.24, 1.23 | [0.5.1][105] | 33 | 1.23.1 | [1.24.1][24] | 1.25, 1.24, 1.23 | [0.5.1][105] | 34 | 1.23.0 | [1.24.0][21] | 1.25, 1.24, 1.23 | [0.5.1][105] | 35 | 1.22.6 | [1.23.7][34] | 1.24, 1.23, 1.22 | [0.5.0][104] | 36 | 1.22.5 | [1.23.5][29] | 1.24, 1.23, 1.22 | [0.5.0][104] | 37 | 1.22.4 | [1.23.4][26] | 1.24, 1.23, 1.22 | [0.5.0][104] | 38 | 1.22.3 | [1.23.3][23] | 1.24, 1.23, 1.22 | [0.5.0][104] | 39 | 1.22.2 | [1.23.3][23] | 1.24, 1.23, 1.22 | [0.5.0][104] | 40 | 1.22.1 | [1.23.1][20] | 1.24, 1.23, 1.22 | [0.5.0][104] | 41 | 1.22.0 | [1.23.0][19] | 1.24, 1.23, 1.22 | [0.5.0][104] | 42 | 1.21.3 | [1.22.6][22] | 1.23, 1.22, 1.21 | [0.4.3][103] | 43 | 1.21.2 | [1.22.6][22] | 1.23, 1.22, 1.21 | [0.4.3][103] | 44 | 1.21.1 | [1.22.2][17] | 1.23, 1.22, 1.21 | [0.4.3][103] | 45 | 1.21.0 | [1.22.0][16] | 1.23, 1.22, 1.21 | [0.4.3][103] | 46 | 1.20.2 | [1.21.3][18] | 1.23, 1.22, 1.21 | [0.4.1][102] | 47 | 1.20.1 | [1.21.1][15] | 1.23, 1.22, 1.21 | [0.4.1][102] | 48 | 1.20.0 | [1.21.0][14] | 1.23, 1.22, 1.21 | [0.4.1][102] | 49 | 1.19.1 | [1.19.1][13] | 1.22, 1.21, 1.20 | [0.3.0][101] | 50 | 1.19.0 | [1.19.1][13] | 1.22, 1.21, 1.20 | [0.3.0][101] | 51 | 1.18.3 | [1.19.1][13] | 1.21, 1.20, 1.19 | [0.3.0][101] | 52 | 1.18.2 | [1.19.1][13] | 1.21, 1.20, 1.19 | [0.3.0][101] | 53 | 1.18.1 | [1.19.1][13] | 1.21, 1.20, 1.19 | [0.3.0][101] | 54 | 1.18.0 | [1.19.0][10] | 1.21, 1.20, 1.19 | [0.3.0][101] | 55 | 1.17.2 | [1.18.4][12] | 1.21, 1.20, 1.19 | [0.3.0][101] | 56 | 1.17.1 | [1.18.3][9] | 1.21, 1.20, 1.19 | [0.3.0][101] | 57 | 1.17.0 | [1.18.3][9] | 1.21, 1.20, 1.19 | [0.3.0][101] | 58 | 1.16.1 | [1.18.4][12] | 1.21, 1.20, 1.19 | [0.3.0][101] | 59 | 1.16.0 | [1.18.3][9] | 1.21, 1.20, 1.19 | [0.3.0][101] | 60 | 1.15.2 | [1.18.4][12] | 1.21, 1.20, 1.19 | [0.3.0][101] | 61 | 1.15.1 | [1.18.3][9] | 1.21, 1.20, 1.19 | [0.3.0][101] | 62 | 1.15.0 | [1.18.2][8] | 1.21, 1.20, 1.19 | [0.3.0][101] | 63 | 1.14.2 | [1.17.4][11] | 1.20, 1.19, 1.18 | [0.2.0][100] | 64 | 1.14.1 | [1.17.2][7] | 1.20, 1.19, 1.18 | [0.2.0][100] | 65 | 1.14.0 | [1.17.1][6] | 1.20, 1.19, 1.18 | [0.2.0][100] | 66 | 1.13.1 | [1.17.1][6] | 1.20, 1.19, 1.18 | [0.2.0][100] | 67 | 1.13.0 | [1.17.0][5] | 1.20, 1.19, 1.18 | [0.2.0][100] | 68 | 1.12.0 | [1.17.0][5] | 1.19, 1.18, 1.17 | N/A | 69 | 1.11.0 | [1.16.2][4] | 1.19, 1.18, 1.17 | N/A | 70 | 1.10.1 | [1.16.2][4] | 1.19, 1.18, 1.17 | N/A | 71 | 1.10.0 | [1.16.0][3] | 1.19, 1.18, 1.17 | N/A | 72 | 1.9.0 | [1.15.1][2] | 1.18, 1.17, 1.16 | N/A | 73 74 <br /> 75 76 ## Notes on Compatibility 77 78 **As of Contour version 1.16.0, Contour only subscribes to Ingress v1 resources (and no longer falls back to Ingress v1beta1). The minimum compatible Kubernetes version for Contour 1.16.0 and above is Kubernetes 1.19.** 79 80 Contour utilizes [client-go][98] to watch for resources in a Kubernetes cluster. 81 We depend on the latest version of the library and by extension only support the latest versions of Kubernetes. 82 While the `client-go` [compatibility matrix][99] may list older versions of Kubernetes as being compatible and supported by upstream, the Contour project only tests a given version of Contour against the versions listed in the table above. 83 Combinations not listed are not tested, guaranteed to work, or supported by the Contour maintainers. 84 85 ## Envoy Extensions 86 Contour requires the following Envoy extensions. 87 If you are using the image recommended in our [example deployment][1] no action is required. 88 If you are providing your own Envoy it must be compiled with the following extensions: 89 90 - Access Loggers: 91 - envoy.access_loggers.file 92 - envoy.access_loggers.http_grpc 93 - envoy.access_loggers.tcp_grpc 94 95 - Compression: 96 - envoy.compression.gzip.compressor 97 98 - HTTP Filters: 99 - envoy.filters.http.compressor 100 - envoy.filters.http.cors 101 - envoy.filters.http.ext_authz 102 - envoy.filters.http.grpc_stats 103 - envoy.filters.http.grpc_web 104 - envoy.filters.http.health_check 105 - envoy.filters.http.lua 106 - envoy.filters.http.router 107 108 - Listener filters 109 - envoy.filters.listener.http_inspector 110 - envoy.filters.listener.original_dst 111 - envoy.filters.listener.proxy_protocol 112 - envoy.filters.listener.tls_inspector 113 114 - Network filters 115 - envoy.filters.network.client_ssl_auth 116 - envoy.filters.network.ext_authz 117 - envoy.filters.network.http_connection_manager 118 - envoy.filters.network.tcp_proxy 119 120 - Transport sockets 121 - envoy.transport_sockets.upstream_proxy_protocol 122 - envoy.transport_sockets.raw_buffer 123 124 - Http Upstreams 125 - envoy.upstreams.http.http 126 - envoy.upstreams.http.tcp 127 128 __Note:__ This list of extensions was last verified to be complete with Envoy v1.16.1. 129 130 131 [1]: {{< param github_url >}}/tree/{{< param latest_version >}}/examples/contour 132 133 [2]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.15.1 134 [3]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.16.0 135 [4]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.16.2 136 [5]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.17.0 137 [6]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.17.1 138 [7]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.17.2 139 [8]: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.18.2 140 [9]: https://www.envoyproxy.io/docs/envoy/v1.18.3/version_history/current 141 [10]: https://www.envoyproxy.io/docs/envoy/v1.19.0/version_history/current 142 [11]: https://www.envoyproxy.io/docs/envoy/v1.17.4/version_history/current 143 [12]: https://www.envoyproxy.io/docs/envoy/v1.18.4/version_history/current 144 [13]: https://www.envoyproxy.io/docs/envoy/v1.19.1/version_history/current 145 [14]: https://www.envoyproxy.io/docs/envoy/v1.21.0/version_history/current 146 [15]: https://www.envoyproxy.io/docs/envoy/v1.21.1/version_history/current 147 [16]: https://www.envoyproxy.io/docs/envoy/v1.22.0/version_history/current 148 [17]: https://www.envoyproxy.io/docs/envoy/v1.22.2/version_history/current 149 [18]: https://www.envoyproxy.io/docs/envoy/v1.21.3/version_history/current 150 [19]: https://www.envoyproxy.io/docs/envoy/v1.23.0/version_history/v1.23/v1.23.0 151 [20]: https://www.envoyproxy.io/docs/envoy/v1.23.1/version_history/v1.23/v1.23.1 152 [21]: https://www.envoyproxy.io/docs/envoy/v1.24.0/version_history/v1.24/v1.24.0 153 [22]: https://www.envoyproxy.io/docs/envoy/v1.22.6/version_history/current 154 [23]: https://www.envoyproxy.io/docs/envoy/v1.23.3/version_history/v1.23/v1.23.3 155 [24]: https://www.envoyproxy.io/docs/envoy/v1.24.1/version_history/v1.24/v1.24.1 156 [25]: https://www.envoyproxy.io/docs/envoy/v1.25.0/version_history/v1.25/v1.25.0 157 [26]: https://www.envoyproxy.io/docs/envoy/v1.23.4/version_history/v1.23/v1.23.4 158 [27]: https://www.envoyproxy.io/docs/envoy/v1.24.2/version_history/v1.24/v1.24.2 159 [28]: https://www.envoyproxy.io/docs/envoy/v1.25.1/version_history/v1.25/v1.25.1 160 [29]: https://www.envoyproxy.io/docs/envoy/v1.23.5/version_history/v1.23/v1.23.5 161 [30]: https://www.envoyproxy.io/docs/envoy/v1.24.3/version_history/v1.24/v1.24.3 162 [31]: https://www.envoyproxy.io/docs/envoy/v1.25.2/version_history/v1.25/v1.25.2 163 [32]: https://www.envoyproxy.io/docs/envoy/v1.25.4/version_history/v1.25/v1.25.4 164 [33]: https://www.envoyproxy.io/docs/envoy/v1.24.5/version_history/v1.24/v1.24.5 165 [34]: https://www.envoyproxy.io/docs/envoy/v1.23.7/version_history/v1.23/v1.23.7 166 [35]: https://www.envoyproxy.io/docs/envoy/v1.26.1/version_history/v1.26/v1.26.1 167 [36]: https://www.envoyproxy.io/docs/envoy/v1.25.6/version_history/v1.25/v1.25.6 168 [37]: https://www.envoyproxy.io/docs/envoy/v1.26.2/version_history/v1.26/v1.26.2 169 [38]: https://www.envoyproxy.io/docs/envoy/v1.24.10/version_history/v1.24/v1.24.10 170 [39]: https://www.envoyproxy.io/docs/envoy/v1.25.9/version_history/v1.25/v1.25.9 171 [40]: https://www.envoyproxy.io/docs/envoy/v1.26.4/version_history/v1.26/v1.26.4 172 [41]: https://www.envoyproxy.io/docs/envoy/v1.27.0/version_history/v1.27/v1.27.0 173 [42]: https://www.envoyproxy.io/docs/envoy/v1.27.2/version_history/v1.27/v1.27.2 174 [43]: https://www.envoyproxy.io/docs/envoy/v1.26.6/version_history/v1.26/v1.26.6 175 [44]: https://www.envoyproxy.io/docs/envoy/v1.25.11/version_history/v1.25/v1.25.11 176 [45]: https://www.envoyproxy.io/docs/envoy/v1.28.0/version_history/v1.28/v1.28.0 177 [46]: https://www.envoyproxy.io/docs/envoy/v1.29.1/version_history/v1.29/v1.29.1 178 179 [98]: https://github.com/kubernetes/client-go 180 [99]: https://github.com/kubernetes/client-go#compatibility-matrix 181 182 [100]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.2.0 183 [101]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.3.0 184 [102]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.4.1 185 [103]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.4.3 186 [104]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.5.0 187 [105]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.5.1 188 [106]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.6.0 189 [107]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.6.2 190 [108]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.8.0 191 [109]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v0.8.1 192 [110]: https://github.com/kubernetes-sigs/gateway-api/releases/tag/v1.0.0