Skip to content

Feat/expand migration examples 596#641

Open
Ashutoshx7 wants to merge 2 commits intokgateway-dev:mainfrom
Ashutoshx7:feat/expand-migration-examples-596
Open

Feat/expand migration examples 596#641
Ashutoshx7 wants to merge 2 commits intokgateway-dev:mainfrom
Ashutoshx7:feat/expand-migration-examples-596

Conversation

@Ashutoshx7
Copy link
Copy Markdown
Contributor

Description

This PR significantly expands the Ingress migration documentation by adding comprehensive, step-by-step examples for common NGINX patterns.

Motivation:
Addresses the lack of advanced migration examples noted in the Ingress Migration Epic #628. Specifically, it fills the feature parity gaps for the 2.2 release by providing clear paths for Authentication (JWT, OIDC, API Key) and standard Gateway API filters.

What changed:

  • Added 10 new migration examples in the Envoy-based migration guide:
    • Auth: Basic Auth, JWT Authentication, API Key Authentication, OIDC Authentication.
    • Traffic Control: Header Modifiers, Timeouts, URL Rewriting, Request Buffering, Traffic Mirroring.
    • Security: Client TLS (mTLS).
  • Fixed Build Errors: Resolved pre-existing build failures by adding the missing migration examples in the agentgateway section (canary.md and session-affinity.md).
  • Improved UX: Updated the migration index page with logical grouping and better weights for easier navigation.
  • Architectural Accuracy: All examples follow the correct kgateway patterns (e.g., using GatewayExtension for JWT/OIDC and TrafficPolicy for Auth/Timeouts).

Related issues:
Fixes #596
Part of #628

Change Type

/kind documentation
/kind fix

Changelog

Expand Ingress migration guides with 10 new advanced examples including OIDC, JWT, API Key, and mTLS.

This PR adds a new GitHub Actions workflow to automatically build and deploy PR previews to Netlify.

Features:
- Builds Hugo site with Go 1.21, Node 20, and Hugo 0.135.0 (Extended)
- Deploys preview to Netlify
- Posts the preview URL as a comment on the PR
- Caches Go and npm dependencies for faster builds
- Cancels obsolete in-progress builds for the same PR

Fixes kgateway-dev#593

Signed-off-by: Ashutosh Singh <karns7844@gmail.com>
- Added 10 new migration examples for Envoy-based Gateway API:
  - Basic Auth, JWT Authentication, API Key Authentication, OIDC Authentication
  - Header Modifiers, Timeouts, URL Rewriting, Request Buffering, Traffic Mirroring, Client TLS (mTLS)
- Fixed missing agentgateway examples (Canary, Session Affinity) to resolve build errors
- Updated migration index with logical grouping and improved weights
- Verified build passes with hugo

Signed-off-by: Ashutosh Singh <karns7844@gmail.com>
@Ashutoshx7 Ashutoshx7 force-pushed the feat/expand-migration-examples-596 branch from 778018a to 781fa00 Compare January 30, 2026 12:37
@Ashutoshx7
Copy link
Copy Markdown
Contributor Author

@artberger awaiting your reviews

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.

Ingress Migration: Add More Migration Examples

1 participant