Skip to content

docs: clarify Envoy Proxy version support in the compatibility matrix - #9915

Open
zhaohuabing wants to merge 2 commits into
envoyproxy:mainfrom
zhaohuabing:docs-matrix-envoy-minor
Open

docs: clarify Envoy Proxy version support in the compatibility matrix#9915
zhaohuabing wants to merge 2 commits into
envoyproxy:mainfrom
zhaohuabing:docs-matrix-envoy-minor

Conversation

@zhaohuabing

@zhaohuabing zhaohuabing commented Sep 1, 2026

Copy link
Copy Markdown
Member

Related to #9656

@zhaohuabing
zhaohuabing requested a review from a team as a code owner September 1, 2026 09:13
@netlify

netlify Bot commented Sep 1, 2026

Copy link
Copy Markdown

Deploy Preview for cerulean-figolla-1f9435 ready!

Name Link
🔨 Latest commit cd4f981
🔍 Latest deploy log https://app.netlify.com/projects/cerulean-figolla-1f9435/deploys/6a9cf0d7304b440008a9116e
😎 Deploy Preview https://deploy-preview-9915--cerulean-figolla-1f9435.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4c8b56258e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread site/content/en/news/releases/matrix.md Outdated
Comment thread site/content/en/news/releases/matrix.md Outdated
@zhaohuabing
zhaohuabing force-pushed the docs-matrix-envoy-minor branch from 4c8b562 to d05887b Compare September 1, 2026 09:24
The matrix listed one Envoy Proxy patch version per Envoy Gateway minor
release, which invited the reading that a nearby Envoy Proxy version is
also supported. It is not: each Envoy Gateway release is built and tested
against exactly one Envoy Proxy minor version.

Show the Envoy Proxy column as a minor series, since the exact patch
advances across our patch releases, and note where to find the exact
image for a given release.

Also warn about overriding the Envoy Proxy image. That failure mode is
easy to miss: a rejected configuration is invisible while the proxies
keep running and only surfaces when one restarts, at which point it has
no last known good configuration to fall back on.

Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
Signed-off-by: Huabing (Robin) Zhao <huabing@tetrate.io>
@zhaohuabing
zhaohuabing force-pushed the docs-matrix-envoy-minor branch from d05887b to d8a92ba Compare September 1, 2026 09:32
Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>

# Conflicts:
#	site/content/en/news/releases/matrix.md

Envoy Gateway relies on the Envoy Proxy and the Gateway API, and runs within a Kubernetes cluster. Not all versions of each of these products can function together for Envoy Gateway. Supported version combinations are listed below; **bold** type indicates the versions of the Envoy Proxy and the Gateway API actually compiled into each Envoy Gateway release.

Each Envoy Gateway release supports exactly one Envoy Proxy minor version: the one it is built and tested against. This is unlike the Kubernetes column, which lists a range of tested versions. Running a different Envoy Proxy minor version is not supported.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we reframe in a way, where we say it ships with this image and is tested with this, compatibility with older or newer versions is unknown ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants