Skip to content

Document v3 CRD mode as the default for new installs#2805

Open
caseydavenport wants to merge 9 commits into
tigera:mainfrom
caseydavenport:casey-v3-crd-docs
Open

Document v3 CRD mode as the default for new installs#2805
caseydavenport wants to merge 9 commits into
tigera:mainfrom
caseydavenport:casey-v3-crd-docs

Conversation

@caseydavenport

@caseydavenport caseydavenport commented Jun 26, 2026

Copy link
Copy Markdown
Member

Makes v3 CRD mode the documented default for new Calico installs, matching the operator change in tigera/operator#4973. New installs now get projectcalico.org/v3 served directly by CRDs with no aggregation API server. The v1 / aggregation-API-server path stays documented as an opt-out. Existing and upgraded clusters are unaffected - the operator picks the mode from the CRDs present and never flips an existing cluster.

What's here:

  • Reframed the Native v3 CRDs pages (Open Source + Enterprise) as the default rather than a tech preview, and fixed the Kubernetes floor to 1.32+ (the old 1.34+ and per-version v1beta1/v1alpha1 claims were wrong).
  • Flipped the fresh-install guides for both products to apply the v3 CRD manifest (v3_projectcalico_org.yaml). The operator and manifest installs that stay on the aggregation API server got a v3 opt-out note instead.
  • Added "your CRD mode is preserved" notes to the upgrade guides for both products, with the v3 manifest called out as the alternative for clusters already on native v3.
  • Release notes for both products.

Note on Enterprise: this assumes v3_projectcalico_org.yaml ships at the published EE manifests location. The release tooling already builds and publishes it (hashreleases and tagged releases both include it), so it should line up with real releases. The one gap is the ee/master/ dev location, which is stale and hasn't picked up the granular bundles - flagged to the DE team separately.

@caseydavenport caseydavenport requested a review from a team as a code owner June 26, 2026 22:19
Copilot AI review requested due to automatic review settings June 26, 2026 22:19
@netlify

netlify Bot commented Jun 26, 2026

Copy link
Copy Markdown

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

Name Link
🔨 Latest commit b263e52
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6a3f318d5db8f300086ec720
😎 Deploy Preview https://deploy-preview-2805--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 26, 2026

Copy link
Copy Markdown

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit b263e52
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6a3f318c4b79df00088bd3d4
😎 Deploy Preview https://deploy-preview-2805--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: 90 (🟢 up 2 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

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