Skip to content

Commit 3307087

Browse files
caseydavenportctauchen
authored andcommitted
Fix v3 mode install and migration docs
Add the missing v1 CRD install step to the Calico quickstart, add the custom-resources.yaml step to the native v3 CRD manifest install flow, and call out the MutatingAdmissionPolicy feature gate as a prereq for migration from API server mode.
1 parent 914705c commit 3307087

3 files changed

Lines changed: 17 additions & 4 deletions

File tree

calico/getting-started/kubernetes/quickstart.mdx

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,13 @@ In this step, you will:
9494

9595
In this step, you will install Calico in your cluster.
9696

97-
1. Install the Tigera Operator and custom resource definitions.
97+
1. Install the $[prodname] custom resource definitions.
98+
99+
```bash
100+
kubectl create -f $[manifestsUrl]/manifests/v1_crd_projectcalico_org.yaml
101+
```
102+
103+
2. Install the Tigera Operator.
98104

99105
```bash
100106
kubectl create -f $[manifestsUrl]/manifests/tigera-operator.yaml
@@ -110,7 +116,7 @@ In this step, you will install Calico in your cluster.
110116
deployment.apps/tigera-operator created
111117
```
112118

113-
2. Install $[prodname] by creating the necessary custom resources.
119+
3. Install $[prodname] by creating the necessary custom resources.
114120

115121
```bash
116122
kubectl create -f $[manifestsUrl]/manifests/custom-resources.yaml
@@ -123,7 +129,7 @@ In this step, you will install Calico in your cluster.
123129
whisker.operator.tigera.io/default created
124130
```
125131

126-
3. Monitor the deployment by running the following command:
132+
4. Monitor the deployment by running the following command:
127133

128134
```bash
129135
watch kubectl get tigerastatus

calico/operations/crd-migration.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ The locked window is typically short (seconds to a few minutes depending on clus
5353

5454
- $[prodname] v3.32+ (or the release that includes the migration controller)
5555
- Cluster is currently running in API server mode (the aggregated API server is deployed)
56+
- The `MutatingAdmissionPolicy` [feature gate](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/) must be enabled on the Kubernetes API server before starting the migration. Native `projectcalico.org/v3` CRDs rely on MutatingAdmissionPolicies for defaulting, which are currently a **beta** Kubernetes feature and are not enabled by default.
5657
- **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.
5758

5859
## How to

calico/operations/native-v3-crds.mdx

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,12 +106,18 @@ Select the method below based on your preferred installation method.
106106

107107
:::
108108

109-
1. Install the Tigera Operator and custom resources:
109+
1. Install the Tigera Operator:
110110

111111
```bash
112112
kubectl create -f $[manifestsUrl]/manifests/tigera-operator.yaml
113113
```
114114

115+
1. Install $[prodname] by creating the necessary custom resources:
116+
117+
```bash
118+
kubectl create -f $[manifestsUrl]/manifests/custom-resources.yaml
119+
```
120+
115121
</TabItem>
116122
</Tabs>
117123

0 commit comments

Comments
 (0)