Merge pull request #406 from klgill/BetaDocs-RestructureDataPlaneAdop…

…tion Beta docs restructure data plane adoption
openstack-k8s-operators · Apr 18, 2024 · 7938110 · 7938110
2 parents 63c9b5e + f75d872
commit 7938110
Show file tree

Hide file tree

Showing 8 changed files with 231 additions and 244 deletions.
diff --git a/docs_user/assemblies/assembly_adopting-openstack-control-plane-services.adoc b/docs_user/assemblies/assembly_adopting-openstack-control-plane-services.adoc
@@ -21,11 +21,14 @@ include::../modules/proc_adopting-the-placement-service.adoc[leveloffset=+1]
 include::../modules/proc_adopting-the-compute-service.adoc[leveloffset=+1]
 
 include::../assemblies/assembly_adopting-the-block-storage-service.adoc[leveloffset=+1]
+include::../modules/proc_adopting-the-openstack-dashboard.adoc[leveloffset=+1]
 
 include::../assemblies/assembly_adopting-the-shared-file-systems-service.adoc[leveloffset=+1]
 
 include::../assemblies/assembly_adopting-the-bare-metal-provisioning-service.adoc[leveloffset=+1]
 
+include::../modules/proc_adopting-the-orchestration-service.adoc[leveloffset=+1]
+
 include::../modules/proc_adopting-telemetry-services.adoc[leveloffset=+1]
 
 include::../modules/proc_adopting-autoscaling.adoc[leveloffset=+1]

diff --git a/docs_user/assemblies/assembly_adopting-the-data-plane.adoc b/docs_user/assemblies/assembly_adopting-the-data-plane.adoc
@@ -0,0 +1,20 @@
+[id="adopting-data-plane_{context}"]
+
+:context: adopting-data-plane
+
+= Adopting the data plane
+
+Adopting the {rhos_long} data plane involves the following steps:
+
+. Stopping any remaining services on the {rhos_prev_long} ({OpenStackShort}) control plane.
+. Deploying the required custom resources.
+. If applicable, performing a fast-forward upgrade on Compute services from {OpenStackShort} {rhos_prev_ver} to {rhos_acro} {rhos_curr_ver}.
+
+[WARNING]
+After the {rhos_acro} control plane is managing the newly deployed data plane, you must not re-enable services on the {OpenStackShort} {rhos_prev_ver} control plane and data plane. Re-enabling services causes workloads to be managed by two control planes or two data planes, resulting in data corruption, loss of control of existing workloads, inability to start new workloads, or other issues.
+
+include::../modules/proc_stopping-infrastructure-management-and-compute-services.adoc[leveloffset=+1]
+
+include::../modules/proc_adopting-compute-services-to-the-data-plane.adoc[leveloffset=+1]
+
+include::../modules/proc_performing-a-fast-forward-upgrade-on-compute-services.adoc[leveloffset=+1]
diff --git a/docs_user/assemblies/ceph_migration.adoc b/docs_user/assemblies/ceph_migration.adoc
@@ -9,7 +9,6 @@ ifdef::context[:parent-context: {context}]
 :toc: left
 :toclevels: 3
 
-include::../modules/ceph-rbd_migration.adoc[leveloffset=+1]
 include::../modules/ceph-rgw_migration.adoc[leveloffset=+1]
 include::../modules/ceph-mds_migration.adoc[leveloffset=+1]
 include::../modules/ceph-monitoring_migration.adoc[leveloffset=+1]

diff --git a/docs_user/assemblies/openstack_adoption.adoc b/docs_user/assemblies/openstack_adoption.adoc
@@ -9,8 +9,7 @@ ifdef::context[:parent-context: {context}]
 :toc: left
 :toclevels: 3
 
-include::../modules/openstack-stop_remaining_services.adoc[leveloffset=+1]
-include::../modules/openstack-dataplane_adoption.adoc[leveloffset=+1]
+
 
 ifdef::parent-context[:context: {parent-context}]
 ifndef::parent-context[:!context:]
diff --git a/docs_user/main.adoc b/docs_user/main.adoc
@@ -18,6 +18,10 @@ include::assemblies/assembly_migrating-databases-to-the-control-plane.adoc[level
 
 include::assemblies/assembly_adopting-openstack-control-plane-services.adoc[leveloffset=+1]
 
+include::assemblies/assembly_adopting-the-data-plane.adoc[leveloffset=+1]
+
 include::assemblies/assembly_migrating-ceph-rbd.adoc[leveloffset=+1]
 
+include::assemblies/ceph_migration.adoc[leveloffset=+1]
+
 include::assemblies/swift_migration.adoc[leveloffset=+1]