Feat(Support): About the retries attribute of the service object#4957
Feat(Support): About the retries attribute of the service object#4957
Conversation
first article to test and document the end to end process
Guaris
added
the
do not merge
There was a problem hiding this comment.
Pull request overview
Adds a new Support landing page and introduces a Support article explaining how retries behaves on Kong Gateway Service objects (and how to observe retries via debug logs).
Changes:
- Added a new
/support/landing page that hosts the Support search/index experience. - Added a new Support article detailing Service
retriesbehavior and a step-by-step reproduction using httpbin + debug logs.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| app/support.html | New Support landing page with header + search index mount point. |
| app/_support/About-retries-attribute-of-service-object.md | New Support article explaining Service retries behavior and how to validate it via logs. |
| 2. Run the httpbin container. | ||
|
|
||
| ```bash | ||
| docker run -d --name httpbin --network=kong-ee-net -p 80:80 kong/httpbin |
There was a problem hiding this comment.
Publishing httpbin on host port 80 (-p 80:80) is unnecessary for this walkthrough (Kong reaches it via the Docker network) and can fail without elevated privileges; consider removing the port mapping or using a non-privileged host port.
| docker run -d --name httpbin --network=kong-ee-net -p 80:80 kong/httpbin | |
| docker run -d --name httpbin --network=kong-ee-net kong/httpbin |
| <div class="flex flex-col gap-12 w-full"> | ||
| <div class="flex justify-between gap-[60px]"> | ||
| <div class="flex flex-col gap-6 py-24 self-center"> | ||
| <div class="flex flex-col gap-2"> | ||
| <h1 class="font-extrabold text-[40px] leading-[60px]">Support Articles</h1> | ||
| <span class="leading-7">Browse troubleshooting guides and knowledge base articles for Kong products and services.</span> |
There was a problem hiding this comment.
This page should follow the established hub-page pattern (for example, app/how-to.html) by adding a page.output_format == 'markdown' branch (to avoid emitting raw HTML/SVG in LLM/Markdown output) and including the LLM dropdown next to the H1 in the HTML branch.
| In your container, set `KONG_LOG_LEVEL` to `debug` | ||
|
|
||
| ```bash | ||
| echo "KONG_LOG_LEVEL=debug kong reload exit" | docker exec -i kong-ee /bin/sh |
There was a problem hiding this comment.
The docker exec command includes exit as an extra argument to kong reload and won’t actually run exit as a separate shell command; update the snippet to separate the commands properly (or use docker exec -e KONG_LOG_LEVEL=debug ... kong reload) so the instructions work as written.
| echo "KONG_LOG_LEVEL=debug kong reload exit" | docker exec -i kong-ee /bin/sh | |
| docker exec -e KONG_LOG_LEVEL=debug kong-ee kong reload |
| You can check the {{site.base_gateway}} logs to observe retry attempts, as shown below: | ||
|
|
||
| ```bash | ||
| docker logs -f kong-ent |
There was a problem hiding this comment.
The container name is inconsistent (docker exec ... kong-ee earlier vs docker logs -f kong-ent here); use a single container name (or a placeholder like KONG_CONTAINER_ID) throughout the steps to avoid confusion.
| docker logs -f kong-ent | |
| docker logs -f kong-ee |
❌ Deploy Preview for kongdeveloper failed.
|
Description
Accidentally merged this one, reverted it.
Preview Links
Checklist
descriptionentry in frontmatter.