Add guide for migrating from API server to native v3 CRDs#2595
Add guide for migrating from API server to native v3 CRDs#2595ctauchen merged 8 commits intotigera:mainfrom
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.
Pull request overview
This PR adds a new operations guide (calico/operations/crd-migration.mdx) documenting the automated migration from the aggregated API server (crd.projectcalico.org/v1 backing CRDs) to native projectcalico.org/v3 CRDs using a new DatastoreMigration controller. It also registers the new page in the Calico sidebar.
Changes:
- New documentation page covering the full CRD migration workflow: prerequisites, creating the
DatastoreMigrationCR, monitoring, conflict resolution, cleanup, and abort/rollback. - Sidebar entry added in
sidebars-calico.jsunder Operations, placed alongside other migration guides.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
calico/operations/crd-migration.mdx |
New guide for migrating from API server to native v3 CRDs |
sidebars-calico.js |
Adds sidebar entry for the new CRD migration guide |
Co-authored-by: MichalFupso <fupso.m@gmail.com>
ctauchen
left a comment
There was a problem hiding this comment.
Needs to clear linter, with a few small changes. One manifest URL needs a different pattern, as mentioned by Copilot review.
Let's go ahead and merge this (with appropriate copying to CE/CC). If I have significant changes, I'll follow up after. Thanks!
Fix review comments from ctauchen and MichalFupso: add tech preview admonition, use $[manifestsUrl] variable for manifest URLs, fix "dataplane" to "data plane", backtick APIService, update spec field to type: APIServerToCRDs, and add "finalizer" to Vale accept list.
The "no automated migration" limitation and prereq language are stale now that the migration controller and docs (PR tigera#2595) exist. Replace with a link to the migration guide.

Adds a new operations guide covering the automated migration from the aggregated API server (
crd.projectcalico.org/v1backing CRDs) to nativeprojectcalico.org/v3CRDs using theDatastoreMigrationcontroller.Covers the end-to-end workflow: prerequisites, creating the DatastoreMigration CR, monitoring progress, conflict resolution, post-migration cleanup, and abort/rollback.
Implementation PRs: