Skip to content

docs: add without-LoadBalancer testing instructions to traffic pages - #9573

Open
kkukadia wants to merge 2 commits into
envoyproxy:mainfrom
kkukadia:docs/testing-sections-traffic
Open

docs: add without-LoadBalancer testing instructions to traffic pages#9573
kkukadia wants to merge 2 commits into
envoyproxy:mainfrom
kkukadia:docs/testing-sections-traffic

Conversation

@kkukadia

Copy link
Copy Markdown

What this PR does / why we need it:

HTTP Routing, GRPC Routing, HTTP Timeouts, HTTP Redirects, HTTP URL Rewrite, and TCP Routing only showed how to test through an external LoadBalancer address, so clusters without one (e.g. kind) had no way to follow along.

Adds a port-forward alternative for the pages with their own Gateway (HTTP Routing, GRPC Routing, TCP Routing), and points the pages that reuse the default eg Gateway (HTTP Redirects, HTTP URL Rewrite, HTTP Timeouts) at the GATEWAY_HOST already set up in Quickstart - same pattern used in the docs elsewhere (e.g. External Processing, Wasm Extensions).

Which issue(s) this PR fixes:

Part of #5799 (traffic-routing batch)

Release Notes: No

HTTP Routing, GRPC Routing, HTTP Timeouts, HTTP Redirects, HTTP URL
Rewrite, and TCP Routing only showed how to test through an external
LoadBalancer address, leaving clusters without one (e.g. kind) with no
way to follow along.

Adds a port-forward alternative for the pages with their own Gateway
(HTTP Routing, GRPC Routing, TCP Routing), and points the pages that
reuse the default eg Gateway (HTTP Redirects, HTTP URL Rewrite, HTTP
Timeouts) at the GATEWAY_HOST already set up in Quickstart, matching
the pattern used elsewhere in the docs.

Signed-off-by: k1chik <kkukdia@gmail.com>
@kkukadia
kkukadia requested a review from a team as a code owner July 24, 2026 01:20
@netlify

netlify Bot commented Jul 24, 2026

Copy link
Copy Markdown

Deploy Preview for cerulean-figolla-1f9435 ready!

Name Link
🔨 Latest commit d07d648
🔍 Latest deploy log https://app.netlify.com/projects/cerulean-figolla-1f9435/deploys/6a64da956c327700080451c6
😎 Deploy Preview https://deploy-preview-9573--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: 3fd7d54774

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +78 to +82
Ensure the `GATEWAY_HOST` environment variable from the [Quickstart](../../quickstart) is set. If not, follow the
Quickstart instructions to set the variable.

```shell
export GATEWAY_HOST=$(kubectl get gateway/eg -o jsonpath='{.status.addresses[0].value}')
echo $GATEWAY_HOST

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Restore no-LoadBalancer host setup

For clusters without LoadBalancer support—the environment this docs change is meant to unblock—the Quickstart does not export GATEWAY_HOST; it only starts a port-forward and curls localhost:8888. After following these new lines, echo $GATEWAY_HOST remains blank and the curl below expands to an unusable http:///get URL (the same pattern was added to URL Rewrite and Timeouts), so the eg-based traffic tasks still cannot be followed on kind-like clusters. Please include the port-forward plus GATEWAY_HOST=localhost:8888 setup here or make Quickstart export it.

Useful? React with 👍 / 👎.

The without-LoadBalancer tab port-forwarded and curled localhost:8888
directly but never exported GATEWAY_HOST, so pages that tell readers
to reuse the variable from Quickstart (HTTP Redirects, HTTP URL
Rewrite, HTTP Timeouts) ended up with it unset on kind-like clusters.

Signed-off-by: k1chik <kkukdia@gmail.com>
@zirain

zirain commented Jul 29, 2026

Copy link
Copy Markdown
Member

@codex review

@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: d07d6482b4

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

```

```shell
export GATEWAY_HOST=localhost:8888

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Keep GATEWAY_HOST host-only for downstream tasks

When users choose the new Without LoadBalancer path, this shared GATEWAY_HOST now includes a port, but several task pages that tell users to reuse the Quickstart variable still treat it as a bare address. For example, site/content/en/latest/tasks/security/jwt-authentication.md appends :80, producing localhost:8888:80, and site/content/en/latest/tasks/traffic/http-redirect.md passes it to curl --resolve, whose documented form is <[+]host:port:addr[,addr]...> and rejects localhost:8888 as the address. Please keep GATEWAY_HOST host-only and introduce a separate URL/port variable, or update the downstream consumers before exporting a port here.

Useful? React with 👍 / 👎.

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