kumahq / kuma-website

🐻 The official website for Kuma, the control plane for modern service connectivity.
https://kuma.io
Apache License 2.0
104 stars 87 forks source link

The description of Envoy requirement is confusing. #1776

Closed spacewander closed 4 months ago

spacewander commented 5 months ago

What happened?

In https://kuma.io/docs/2.7.x/introduction/kuma-requirements/#envoy,

Versions of envoy supported are: ~1.25.0 which means >=1.25.0 and <1.25.0. You can find the current version in the version.sh file.

For the first sentence, if the supported Envoy is both >=1.25.0 and <1.25.0, it means we support every version of Envoy. Maybe this sentence misses a patch version?

And what's the difference between the supported version and the currently used version? I find that the current used version is 1.29.4, which is much newer than the supported one.

jakubdyszkiewicz commented 4 months ago

Triage: It is a bug in docs. We support Envoy version specified here https://github.com/kumahq/kuma/blob/master/tools/releases/version.sh#L11. We support -2 minor version of Kuma https://kuma.io/docs/2.7.x/production/upgrades-tuning/upgrades/#upgrade-kuma so the range starts from envoy version in -2 minor release of Kuma

spacewander commented 4 months ago

-2 minor version of Kuma

So the supported Envoy version is from the kuma@minor - 2/tools/releases/version.sh#xx to kuma@master/tools/releases/version.sh#xx?