Skip to content

[EV-6717] Document enabling Calico Ingress Gateway via the Helm gatewayAPI toggle#2798

Open
xiumozhan wants to merge 1 commit into
tigera:mainfrom
xiumozhan:EV-6717-docs-enable-cig-via-helm
Open

[EV-6717] Document enabling Calico Ingress Gateway via the Helm gatewayAPI toggle#2798
xiumozhan wants to merge 1 commit into
tigera:mainfrom
xiumozhan:EV-6717-docs-enable-cig-via-helm

Conversation

@xiumozhan

Copy link
Copy Markdown
Contributor

What

Documents how to enable Calico Ingress Gateway (CIG) at Helm install time using the tigera-operator chart's gatewayAPI.enabled toggle, alongside the existing post-install kubectl apply method. Enterprise-only, in the current ("next") calico-enterprise/ docs.

Changes

  • networking/ingress-gateway/create-ingress-gateway.mdx: the enable step now presents both methods in tabs — Helm at install time (default) and kubectl after installation — both creating the same tigera-secure GatewayAPI resource and the default tigera-gateway-class.
  • reference/installation/helm_customization.mdx: adds Gateway API to the customizable-resources list and a gatewayAPI block to the sample values.yaml.
  • networking/ingress-gateway/customize-ingress-gateway.mdx: adds a tip noting that GatewayAPI spec fields can be set under gatewayAPI: in values.yaml at install time.

Dependency and timing

The gatewayAPI.enabled chart toggle ships via calico-private PR #12357 (targets the next Calico Enterprise release). This docs change should merge in lockstep with that release so the instructions match the shipped chart.

🤖 Generated with Claude Code

…ayAPI toggle

Add the Helm install-time path (gatewayAPI.enabled) for enabling Calico Ingress Gateway alongside the existing kubectl method, with the matching Helm values reference entry and sample, plus a customization note that GatewayAPI spec fields can be set under gatewayAPI in values.yaml. Enterprise-only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@xiumozhan xiumozhan requested a review from a team as a code owner June 23, 2026 00:07
Copilot AI review requested due to automatic review settings June 23, 2026 00:07
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 880358a
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6a39ce5b57d423000841fa64
😎 Deploy Preview https://deploy-preview-2798--calico-docs-preview-next.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.

@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 880358a
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6a39ce5bc2664100085a2eee
😎 Deploy Preview https://deploy-preview-2798--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 95 (🟢 up 25 from production)
Accessibility: 98 (no change from production)
Best Practices: 83 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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

Documents enabling Calico Ingress Gateway (CIG) via the tigera-operator Helm chart’s gatewayAPI.enabled toggle (install-time), alongside the existing post-install kubectl apply method, in Calico Enterprise “next” docs.

Changes:

  • Adds Gateway API to the Helm customization reference and includes a gatewayAPI: example block in values.yaml.
  • Updates the “Create an ingress gateway” guide to present Helm vs kubectl enablement methods in tabs.
  • Adds an install-time Helm tip to the ingress gateway customization guide.

Reviewed changes

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

File Description
calico-enterprise/reference/installation/helm_customization.mdx Adds Gateway API to the list of customizable resources and to the sample values.yaml.
calico-enterprise/networking/ingress-gateway/customize-ingress-gateway.mdx Adds a tip about setting GatewayAPI spec fields via Helm values.yaml at install time.
calico-enterprise/networking/ingress-gateway/create-ingress-gateway.mdx Adds Docusaurus tabs to show Helm vs kubectl methods for enabling Gateway API support.

- [Policy recommendation](api.mdx#policyrecommendationspec)
- [Authentication](api.mdx#authenticationspec)
- [Application layer](api.mdx#applicationlayerspec)
- [Gateway API (Calico Ingress Gateway)](api.mdx#gatewayapi)
Comment on lines +51 to +58
The Tigera Operator creates the `tigera-secure` `GatewayAPI` resource as part of the installation. To customize the gateway, set any [`GatewayAPI` spec field](../../reference/installation/api.mdx#gatewayapi) under `gatewayAPI:` — for example, to [define additional gateway classes](customize-ingress-gateway.mdx#configure-multiple-gateway-classes):

```yaml title='values.yaml'
gatewayAPI:
enabled: true
gatewayClasses:
- name: tigera-gateway-class
```
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.

2 participants