-
Notifications
You must be signed in to change notification settings - Fork 135
Use new crd.projectcalico.org.v1 Helm chart to install CRDs #2495
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
✅ Deploy Preview for calico-docs-preview-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview succeeded!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
Updates the Helm-based installation guides to install Calico CRDs via the new crd.projectcalico.org.v1 Helm chart, instead of relying on the operator chart to install CRDs.
Changes:
- Split the OSS Helm install steps into (1) CRDs chart install, then (2) Tigera Operator chart install.
- Split the Calico Enterprise Helm install steps similarly, adding a CRDs chart install step before installing the operator.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| calico/getting-started/kubernetes/helm.mdx | Adds a dedicated Helm step to install CRDs from the new projectcalico/crd.projectcalico.org.v1 chart before installing the operator chart. |
| calico-enterprise/getting-started/install-on-clusters/kubernetes/helm.mdx | Adds a CRDs installation step ahead of the operator install for Enterprise Helm workflows. |
| 1. Create the necessary custom resource definitions. | ||
|
|
||
| ```bash | ||
| helm install calico-crds crd.projectcalico.org.v1-$[chart_version_name] --version $[releaseTitle] --namespace tigera-operator |
Copilot
AI
Jan 29, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The CRDs install command looks inconsistent with the rest of this page and likely won’t work as written: the chart reference crd.projectcalico.org.v1-$[chart_version_name] is neither repo-qualified (for tigera-ee/...) nor a local path (missing ./ and likely the .tgz filename produced by helm pull). Also, --namespace tigera-operator will fail unless the namespace already exists (this page currently only creates it later via --create-namespace on the operator install). Consider pulling the CRDs chart (like the operator chart) and installing from the local .tgz (or use a repo-qualified chart name), and add --create-namespace (or an explicit namespace creation step) before installing the CRDs release.
| helm install calico-crds crd.projectcalico.org.v1-$[chart_version_name] --version $[releaseTitle] --namespace tigera-operator | |
| helm install calico-crds tigera-ee/crds --version $[releaseTitle] --namespace tigera-operator --create-namespace |
| 1. Create the necessary custom resource definitions. | ||
|
|
Copilot
AI
Jan 29, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The earlier “Operator based installation” description still says the operator and CRDs are installed using a single Helm chart. With the new separate CRDs chart step, please update that text to reflect that CRDs are installed via the crd.projectcalico.org.v1 chart and the operator is installed via the tigera-operator chart, so the conceptual description matches the procedure.
| 1. Create the necessary custom resource definitions. | ||
|
|
Copilot
AI
Jan 29, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The “Operator based installation” concept section above still implies the operator and CRDs are installed using a single Helm chart. Since this procedure now installs CRDs via a separate crd.projectcalico.org.v1 chart before installing projectcalico/tigera-operator, please update that conceptual wording to match the new two-step flow to avoid confusing readers.

Product Version(s):
Issue:
Documents projectcalico/calico#11727
Link to docs preview:
SME review:
DOCS review:
Additional information:
Merge checklist: