Skip to content

feat(gateway): Distroless image#5581

Open
lena-larionova wants to merge 4 commits into
mainfrom
feat/os-support
Open

feat(gateway): Distroless image#5581
lena-larionova wants to merge 4 commits into
mainfrom
feat/os-support

Conversation

@lena-larionova

@lena-larionova lena-larionova commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Description

  • Adds the distroless image to the OS support table
    • Fixes the table to not display packages when there are none available
  • Set up guide for distroless in DB-less mode as the simplest option, with all the FAQs and caveats

Outstanding questions:

  • Is this supported with Konnect? - yes
  • Does this actually support all deployment modes (traditional with DB, hybrid)? - yes
  • Does it support AWS Graviton? - yes

Fixes #5417

Preview Links

https://deploy-preview-5581--kongdeveloper.netlify.app/gateway/install/#docker
https://deploy-preview-5581--kongdeveloper.netlify.app/gateway/install/docker-distroless/
https://deploy-preview-5581--kongdeveloper.netlify.app/gateway/version-support-policy/#supported-versions - 3.15 tab

@lena-larionova lena-larionova requested a review from a team as a code owner June 15, 2026 14:57
Copilot AI review requested due to automatic review settings June 15, 2026 14:57
@netlify

netlify Bot commented Jun 15, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 15d7e71
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a337842203c3a0008c0746e
😎 Deploy Preview https://deploy-preview-5581--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

Copilot AI left a comment

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.

Pull request overview

Adds documentation and support-matrix data for Kong Gateway “distroless” Docker images, and updates install/support UI includes to surface the new option and avoid showing package artifacts for Docker-only distributions.

Changes:

  • Add a new Gateway install how-to for running the distroless image in DB-less mode.
  • Update the Gateway install include to link to the distroless how-to (both markdown and HTML render paths).
  • Extend the Gateway OS/support data and table rendering to include a Distroless entry and suppress package rows when packages aren’t available.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
app/_includes/support/gateway.html Hide package support indicators when package: false so Docker-only distros don’t render empty/incorrect package rows.
app/_includes/install/gateway.html Adds a new “Distroless image” install option/link in the Docker install section.
app/_how-tos/gateway/install-gateway-distroless.md New how-to explaining how to pull and run the distroless image (DB-less) and validate it.
app/_data/support/packages.yml Adds a Distroless “OS” entry so the support table can render the name/version fields.
app/_data/products/gateway.yml Adds distroless to the per-release distributions list so it appears in the version support table.

Comment thread app/_data/products/gateway.yml

@cloudjumpercat cloudjumpercat left a comment

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.

Just a few nitpicks!

Comment thread app/_how-tos/gateway/install-gateway-distroless.md Outdated
Comment thread app/_how-tos/gateway/install-gateway-distroless.md Outdated
Comment thread app/_how-tos/gateway/install-gateway-distroless.md Outdated
Comment thread app/_how-tos/gateway/install-gateway-distroless.md Outdated
Comment thread app/_how-tos/gateway/install-gateway-distroless.md Outdated
@lena-larionova lena-larionova changed the base branch from release/gateway-3.15 to main June 18, 2026 04:47
@lena-larionova lena-larionova added do not merge Issues/ PRs whose changes should not be merged at this time release-docs Docs for release product:gateway labels Jun 18, 2026
@Kong Kong deleted a comment from CLAassistant Jun 18, 2026
@lena-larionova

lena-larionova commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

Deleted CLA assistant comment as it was listing ~20 users that has previously committed to main due to a rebase/retarget.

We will merge this PR separately from the 3.15 release. Distroless is going to release slightly after the GA.

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

Labels

do not merge Issues/ PRs whose changes should not be merged at this time product:gateway release-docs Docs for release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[KGW 3.15] Gateway Distroless System Support

4 participants