Merge pull request #93245 from kylape/ROX-28896

ROX-28896: Add CRD upgrade instructions for roxctl upgrade

Author: kcarmichael08

modules/upgrade-central-cluster-crds.adoc

@@ -0,0 +1,33 @@
+// Module included in the following assemblies:
+//
+// * upgrade/upgrade-roxctl.adoc
+:_mod-docs-content-type: PROCEDURE
+[id="upgrade-central-cluster-crds{context}"]
+= Upgrading the SecurityPolicy custom resource definition
+
+[role="_abstract"]
+You can update the `SecurityPolicy` custom resource definition (CRD) to the latest version by generating the new CRD and applying it to the cluster.
+
+.Procedure
+
+. Use `roxctl` to generate a new set of resources by entering the following command:
++
+[source,terminal,subs=attributes+]
+----
+$ roxctl central generate k8s pvc > bundle.zip
+----
+
+. Extract the CRD from the archive by entering the following command:
++
+[source,terminal,subs=attributes+]
+----
+$ unzip bundle.zip central/00-securitypolicy-crd.yaml
+----
+
+. Apply the extracted CRD to your cluster by entering the following command:
++
+[source,terminal,subs=attributes+]
+----
+$ oc apply -f central/00-securitypolicy-crd.yaml <1>
+----
+<1> If you use Kubernetes, enter `kubectl` instead of `oc`.

upgrading/upgrade-roxctl.adoc

@@ -43,7 +43,9 @@ include::modules/install-roxctl-cli-windows.adoc[leveloffset=+2]
 [id="upgrade-central-cluster"]
 == Upgrading the Central cluster
 
-After you have created a backup of the Central database and generated the necessary resources by using the provisioning bundle, the next step is to upgrade the Central cluster. This process involves upgrading Central and Scanner.
+After you have created a backup of the Central database and generated the necessary resources by using the provisioning bundle, the next step is to upgrade the Central cluster. This process requires upgrading the `SecurityPolicy` custom resource definition (CRD), Central, and Scanner.
+
+include::modules/upgrade-central-cluster-crds.adoc[leveloffset=+2]
 
 include::modules/upgrade-central-cluster-central.adoc[leveloffset=+2]