Skip to content

DOCS-2995: Fix version and manifest URL errors on CRD migration page for latest #2910

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.

Sign up for GitHub

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

Merged
ctauchen merged 3 commits into from
Aug 10, 2026
Merged

DOCS-2995: Fix version and manifest URL errors on CRD migration page for latest #2910

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
437cf3b
DOCS-2995: Fix version and manifest URL errors on CRD migration page …
ctauchen Aug 10, 2026
2d4c269
DOCS-2995: Skip link check for unpublished DatastoreMigration CRD man…
ctauchen Aug 10, 2026
e9d4626
DOCS-2995: Skip link check for the Project Calico LinkedIn page
ctauchen Aug 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions __tests__/crawler.test.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,9 @@ test('Crawl the docs and execute tests', async () => {
/^https:\/\/v1-(15|16|17|18)\.docs\.kubernetes\.io\/docs\/reference\/generated\/kubernetes-api\/v1\.(15|16|17|18)/i,
/^https:\/\/github\.com\/projectcalico\/calico\/tree\/master\/[\w/.-]+\.md$/i,
/^https:\/\/www\.linkedin\.com\/company\/tigera\/?$/,
// LinkedIn returns 999 to datacenter crawlers; the company page is fine in a browser. Same
// treatment as the tigera page above. Linked from the "about" / product-editions pages.
/^https:\/\/www\.linkedin\.com\/company\/project-calico\/?$/,
/^https:\/\/installer\.calicocloud\.io\/manifests\/.+\/manifests/,
'http://etcd.co',
'https://www.tigera.io/project-calico/community',
Expand All @@ -70,6 +73,10 @@ test('Crawl the docs and execute tests', async () => {
`https://installer.calicocloud.io/charts`,
`https://docs.tigera.io/calico/charts`,
'https://downloads.tigera.io/ee/charts',
// The DatastoreMigration CRD manifest is referenced by the CRD migration page but is not yet
// published to downloads.tigera.io for any released version; it ships once the publish step
// (calico-private master) is cut into a release. Live then; tracked in DOCS-2995.
/^https:\/\/downloads\.tigera\.io\/ee\/[\w.-]+\/manifests\/migration\.projectcalico\.org_datastoremigrations\.yaml$/,
'https://Q4GSZWRKBA-dsn.algolia.net',
'http://backend.stars:6379/status',
'http://client.client:9000/status',
Expand Down
6 changes: 3 additions & 3 deletions calico-enterprise_versioned_docs/version-3.23-2/operations/crd-migration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ The locked window is typically short (seconds to a few minutes depending on clus

## Before you begin

- $[prodname] v3.32+ (or the release that includes the migration controller)
- $[prodname] v3.23+ (or the release that includes the migration controller)
- Cluster is currently running in API server mode (the aggregated API server is deployed)
- **If using GitOps (ArgoCD, Flux):** pause sync before starting the migration. These tools may interfere with the API group switchover. You'll update your manifests to use `projectcalico.org/v3` after migration completes.

Expand All @@ -64,13 +64,13 @@ The locked window is typically short (seconds to a few minutes depending on clus
Apply the v3 CRD manifests from the $[prodname] release. While the aggregated API service is active, Kubernetes ignores these CRDs, so this is safe to do ahead of time.

```bash
kubectl apply -f $[manifestsUrl]/manifests/v3_projectcalico_org.yaml
kubectl apply -f $[filesUrl]/manifests/v3_projectcalico_org.yaml
```

2. **Install the DatastoreMigration CRD.**

```bash
kubectl apply -f $[manifestsUrl]/manifests/migration.projectcalico.org_datastoremigrations.yaml
kubectl apply -f $[filesUrl]/manifests/migration.projectcalico.org_datastoremigrations.yaml
```

3. **Create the DatastoreMigration CR.**
Expand Down