Skip to content

Add NGINX Gateway Fabric routes guide#1920

Draft
willdavsmith wants to merge 5 commits into
radius-extensibility-docsfrom
nginx-gateway-routes-recipe
Draft

Add NGINX Gateway Fabric routes guide#1920
willdavsmith wants to merge 5 commits into
radius-extensibility-docsfrom
nginx-gateway-routes-recipe

Conversation

@willdavsmith

@willdavsmith willdavsmith commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a recipes guide for using NGINX Gateway Fabric as the Gateway API provider for Radius.Compute/routes.

The guide covers:

  • installing Radius with --skip-contour-install
  • installing Gateway API CRDs and NGINX Gateway Fabric
  • creating a Gateway API Gateway
  • registering a recipe pack for Radius.Compute/containers and Radius.Compute/routes
  • deploying a routed Radius application
  • verifying traffic through the NGINX Gateway service

The page is under docs/content/guides/recipes/howto-nginx-gateway-routes/ and uses Bicep snippets for the recipe pack and sample app.

Fixes: radius-project/radius#11952

Validation

  • cspell lint --config ../.github/configs/.cspell.yml --no-progress --dot content/guides/recipes/howto-nginx-gateway-routes/index.md content/guides/recipes/howto-nginx-gateway-routes/snippets/app.bicep content/guides/recipes/howto-nginx-gateway-routes/snippets/nginx-routes-recipe-pack.bicep
  • HUGO_CACHEDIR=/tmp/radius-docs-hugo-cache GOMODCACHE=/tmp/radius-docs-go-mod-cache GOCACHE=/tmp/radius-docs-go-build-cache GOTOOLCHAIN=local ./node_modules/.bin/hugo --gc --minify

The Hugo build reaches site rendering and then fails on an existing unrelated target-branch issue: ambiguous ref "networking" in content/guides/applications/containers/overview/index.md.

@github-actions

github-actions Bot commented Jun 15, 2026

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@willdavsmith willdavsmith force-pushed the nginx-gateway-routes-recipe branch from 201f2e1 to 2641e66 Compare June 15, 2026 21:18
@willdavsmith willdavsmith requested a review from a team as a code owner June 15, 2026 21:18
@willdavsmith willdavsmith changed the base branch from edge to radius-extensibility-docs June 15, 2026 21:18
@willdavsmith willdavsmith force-pushed the nginx-gateway-routes-recipe branch from 2641e66 to 4f51792 Compare June 15, 2026 21:20
@brooke-hamilton brooke-hamilton requested a review from Copilot June 16, 2026 14:43

Copilot AI 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.

Pull request overview

Adds a new “recipes” how-to guide demonstrating how to use NGINX Gateway Fabric as the Kubernetes Gateway API provider for Radius.Compute/routes, including Bicep snippets for the recipe pack and a sample routed app.

Changes:

  • Add a new how-to page walking through installing Radius without Contour, installing Gateway API + NGINX Gateway Fabric, and verifying routed traffic.
  • Add a Bicep snippet to register a recipe pack for Radius.Compute/containers and Radius.Compute/routes configured to target a specific Gateway.
  • Add a Bicep snippet for a minimal NGINX container app with a Radius.Compute/routes HTTP route.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File Description
docs/content/guides/recipes/howto-nginx-gateway-routes/index.md New guide page describing the end-to-end setup and verification steps.
docs/content/guides/recipes/howto-nginx-gateway-routes/snippets/nginx-routes-recipe-pack.bicep New recipe pack definition for containers + routes, with Gateway targeting parameters.
docs/content/guides/recipes/howto-nginx-gateway-routes/snippets/app.bicep New sample app defining an NGINX container and an HTTP route resource.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/content/guides/recipes/howto-nginx-gateway-routes/index.md
Comment thread docs/content/guides/recipes/howto-nginx-gateway-routes/snippets/app.bicep Outdated
Comment thread docs/content/guides/recipes/howto-nginx-gateway-routes/snippets/app.bicep Outdated
Comment thread docs/content/guides/recipes/howto-nginx-gateway-routes/snippets/app.bicep Outdated

@brooke-hamilton brooke-hamilton left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

🚀

Comment thread docs/content/guides/recipes/howto-nginx-gateway-routes/index.md Outdated
Signed-off-by: willdavsmith <willdavsmith@gmail.com>
Signed-off-by: willdavsmith <willdavsmith@gmail.com>
Signed-off-by: willdavsmith <willdavsmith@gmail.com>
Signed-off-by: willdavsmith <willdavsmith@gmail.com>
Signed-off-by: willdavsmith <willdavsmith@gmail.com>
@willdavsmith willdavsmith force-pushed the nginx-gateway-routes-recipe branch from 1b9464f to dc2ad26 Compare June 17, 2026 20:06
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.

3 participants