From acb4cba32ca5ddb9ce6751f867ffda1560b4aa1e Mon Sep 17 00:00:00 2001 From: James Slagle Date: Tue, 28 May 2024 17:41:58 -0400 Subject: [PATCH] Document minor updates Signed-off-by: James Slagle --- docs/assemblies/creating-the-data-plane.adoc | 2 + .../proc_updating-the-data-plane-ovn.adoc | 68 +++++++++++++++++++ .../proc_updating-the-data-plane.adoc | 66 ++++++++++++++++++ docs/assemblies/updating-the-data-plane.adoc | 23 +++++++ 4 files changed, 159 insertions(+) create mode 100644 docs/assemblies/proc_updating-the-data-plane-ovn.adoc create mode 100644 docs/assemblies/proc_updating-the-data-plane.adoc create mode 100644 docs/assemblies/updating-the-data-plane.adoc diff --git a/docs/assemblies/creating-the-data-plane.adoc b/docs/assemblies/creating-the-data-plane.adoc index 2e90579ef..5a2402758 100644 --- a/docs/assemblies/creating-the-data-plane.adoc +++ b/docs/assemblies/creating-the-data-plane.adoc @@ -64,3 +64,5 @@ include::hashes.adoc[leveloffset=+1] include::ipam.adoc[leveloffset=+1] include::hotfixing-the-data-plane.adoc[leveloffset=+1] + +include::updating-the-data-plane.adoc[leveloffset=+1] diff --git a/docs/assemblies/proc_updating-the-data-plane-ovn.adoc b/docs/assemblies/proc_updating-the-data-plane-ovn.adoc new file mode 100644 index 000000000..b93d7d4fd --- /dev/null +++ b/docs/assemblies/proc_updating-the-data-plane-ovn.adoc @@ -0,0 +1,68 @@ +[id="proc_updating-the-data-plane-ovn-{context}"] += Updating OVN on the data plane + +[role="_abstract"] + +You update OVN content (containers) on the data plane once OVN on the control +plane has been updated. + +.Procedure + +. Validate that OVN has been updated on the control plane. ++ +---- +$ oc wait openstackversion --for=condition=OpenStackVersionMinorUpdateOVNControlplane +---- ++ +* Replace `` with the name of the OpenStack control plane resource. ++ +The following example output shows the condition has been met: ++ +---- +openstackversion.core.openstack.org/openstack-galera-network-isolation condition met +---- + +. Create an `OpenStackDataPlaneDeployment` CR and save it to a file named `openstack-edpm-update.yaml` on your workstation. ++ +---- +apiVersion: dataplane.openstack.org/v1beta1 +kind: OpenStackDataPlaneDeployment +metadata: + name: edpm-deployment-ipam-update +spec: + nodeSets: + - openstack-edpm-ipam + - + - ... + - + servicesOverride: + - ovn +---- ++ +* Replace `` with the names of the `OpenStackDataPlaneNodeSet` CRs that you want to include in your data plane minor update. ++ +[NOTE] +The `servicesOverride` field is set to include only `ovn` as the `ovn` service must be updated first in isolation. If using a custom service to manage `ovn`, then use that custom service name instead of `ovn` in `servicesOverride`. Additionally if other custom services must be updated at the same time as `ovn`, then they can be included in `servicesOverride` as well. + +. Save the `openstack-edpm-update.yaml` deployment file. + +. Update the data plane: ++ +---- +$ oc create -f openstack-edpm-update.yaml +---- + +. Verify that the data plane update deployment succeeded: ++ +---- +$ oc get openstackdataplanedeployment +NAME STATUS MESSAGE +edpm-deployment-ipam True Setup Complete +edpm-deployment-ipam-update True Setup Complete +---- + +Once OVN has been updated on the data plane, the rest of the control plane minor update will automatically proceed. Once the control plane minor update is finished, the rest of the data plane can be updated. + +.Troubleshooting + +See <> for troubleshooting any deployment failures. diff --git a/docs/assemblies/proc_updating-the-data-plane.adoc b/docs/assemblies/proc_updating-the-data-plane.adoc new file mode 100644 index 000000000..067af6128 --- /dev/null +++ b/docs/assemblies/proc_updating-the-data-plane.adoc @@ -0,0 +1,66 @@ +[id="proc_updating-the-data-plane-{context}"] += Updating other services on the data plane + +[role="_abstract"] + +Once OVN has been updated on the control plane and data plane, and the rest of the control plane has completed updating, you update the rest of the services on the data plane. + +.Procedure + +. Validate that the rest of the minor update has completed on the control plane. ++ +---- +$ oc wait openstackversion --for=condition=OpenStackVersionMinorUpdateControlplane +---- ++ +* Replace `` with the name of the OpenStack control plane resource. ++ +The following example output shows the condition has been met: ++ +---- +openstackversion.core.openstack.org/openstack-galera-network-isolation condition met +---- + +. Create an `OpenStackDataPlaneDeployment` CR and save it to a file named `openstack-edpm-update-services.yaml` on your workstation. ++ +---- +apiVersion: dataplane.openstack.org/v1beta1 +kind: OpenStackDataPlaneDeployment +metadata: + name: edpm-deployment-ipam-update-services +spec: + nodeSets: + - openstack-edpm-ipam + - + - ... + - + servicesOverride: + - update +---- ++ +* Replace `` with the names of the `OpenStackDataPlaneNodeSet` CRs that you want to include in your data plane minor update. ++ +[NOTE] +The `servicesOverride` field is set to include only `update`. The `update` service applies only the tasks needed to update the packages and containers on the EDPM nodes. When using custom services, include those here as well, or their equivalent custom services that apply the needed update tasks. + +. Save the `openstack-edpm-update-services.yaml` deployment file. + +. Update the data plane: ++ +---- +$ oc create -f openstack-edpm-update-services.yaml +---- + +. Verify that the data plane update deployment succeeded: ++ +---- +$ oc get openstackdataplanedeployment +NAME STATUS MESSAGE +edpm-deployment-ipam True Setup Complete +edpm-deployment-ipam-update True Setup Complete +edpm-deployment-ipam-update-services True Setup Complete +---- + +.Troubleshooting + +See <> for troubleshooting any deployment failures. diff --git a/docs/assemblies/updating-the-data-plane.adoc b/docs/assemblies/updating-the-data-plane.adoc new file mode 100644 index 000000000..eed11ee3f --- /dev/null +++ b/docs/assemblies/updating-the-data-plane.adoc @@ -0,0 +1,23 @@ +[id="assembly_updating-the-data-plane"] += Updating the data plane + +:context: dataplane + +[role="_abstract"] +You can perform a minor update of your OpenStack data plane environment to keep +it updated with the latest packages and containers. + +You must coordinate the minor update of the OpenStack data plane environment +with a minor update of the control plane. OVN containers on the data plane +nodes should not be updated until OVN containers on the control plane have been +updated. + +See +https://github.com/openstack-k8s-operators/dev-docs/blob/main/version_updates.md[OpenStackVersion] +and +https://github.com/openstack-k8s-operators/dev-docs/blob/main/ovs-update.md[Open +vSwitch update] for more information. + +include::proc_updating-the-data-plane-ovn.adoc[leveloffset=+1] + +include::proc_updating-the-data-plane.adoc[leveloffset=+1]