Skip to content

docs: expose Redpanda Console through Gateway API HTTPRoute (26.2)#1825

Open
david-yu wants to merge 1 commit into
betafrom
doc-console-gateway-httproute
Open

docs: expose Redpanda Console through Gateway API HTTPRoute (26.2)#1825
david-yu wants to merge 1 commit into
betafrom
doc-console-gateway-httproute

Conversation

@david-yu

@david-yu david-yu commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Documents Gateway API HTTPRoute support for Redpanda Console (redpanda-operator#1329, merged 2026-06-30, ships in operator/chart v26.2.x).

Changes

  1. New section Expose Redpanda Console with the Gateway API on deploy:console/kubernetes/deploy.adoc:
    • When to choose Gateway API over Ingress, the Gateway/route ownership split, and the mutual-exclusivity rule with the exact chart validation error (ingress and gateway cannot both be enabled; use one or the other)
    • Prerequisites: Gateway API CRDs (v1.5.1 standard install — not bundled), a compatible controller (Envoy Gateway / Istio / Cilium / NGINX Gateway Fabric), and a Gateway manifest including allowedRoutes.namespaces (the field that silently blocks cross-namespace route attachment when missed)
    • Operator (Console CR spec.gateway) and Helm (gateway values) tabs with callouts for parentRefs/sectionName, hostnames, pathType
    • Verification: Accepted/ResolvedRefs route conditions, the NotAllowedByListeners failure mode, Gateway address lookup, and a pre-DNS curl --resolve check
    • Switching between Ingress and Gateway API (both directions)
    • Both existing Ingress callouts (Operator + Helm install examples) now point at the new section
  2. What's new: Gateway API support for Redpanda Console entry under Redpanda Operator v26.2.x in get-started:release-notes/operator.adoc.

Verification

Field names and behavior verified against operator main: Console CRD spec.gateway (GatewayConfig: enabled, annotations, parentRefs[{name,namespace,sectionName}], hostnames, path, pathType) and the console chart gateway values block, including the "HTTPRoute renders but attaches to nothing without parentRefs" default noted in values.yaml. Note the eng PR body's CR example uses spec.clusterSource; the actual CRD json field is spec.cluster, and the docs follow the code. The feature's changelog entries carry no beta marker, so the section is not badged beta (unlike the TLSRoute guide for Redpanda listeners).

Preview pages

🤖 Generated with Claude Code

Add an 'Expose Redpanda Console with the Gateway API' section to the Console
Kubernetes deploy page (operator PR #1329): Gateway API CRD + controller +
Gateway prerequisites, Operator CRD and Helm tabs for the gateway block,
route verification (Accepted/ResolvedRefs, allowedRoutes gotcha), and
switching between Ingress and Gateway API. Both Ingress callouts now point
at the new section, and the operator v26.2.x what's-new gains an entry.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@david-yu
david-yu requested a review from a team as a code owner July 24, 2026 20:33
@netlify

netlify Bot commented Jul 24, 2026

Copy link
Copy Markdown

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 39d6114
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/6a63cc335948a80008692c6c
😎 Deploy Preview https://deploy-preview-1825--redpanda-docs-preview.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.

@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 439977ba-2e61-442c-8344-4cf9194c90e3

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc-console-gateway-httproute

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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.

1 participant