From fa9568403c15614260472f17e0e4038327b701a2 Mon Sep 17 00:00:00 2001 From: Ashleigh Brennan Date: Tue, 2 Sep 2025 11:34:45 -0500 Subject: [PATCH] CNV-67472: Clean up docs structure before adding new content --- .../virt-about-cluster-checkup-framework.adoc | 21 ---------- .../virt-checking-storage-configuration.adoc | 4 +- modules/virt-latency-checkup-web-console.adoc | 4 +- ...easuring-latency-vm-secondary-network.adoc | 6 +-- snippets/virt-about-running-checkups.adoc | 19 +++++++++ .../virt-running-cluster-checkups.adoc | 41 +++++++++---------- 6 files changed, 46 insertions(+), 49 deletions(-) delete mode 100644 modules/virt-about-cluster-checkup-framework.adoc create mode 100644 snippets/virt-about-running-checkups.adoc diff --git a/modules/virt-about-cluster-checkup-framework.adoc b/modules/virt-about-cluster-checkup-framework.adoc deleted file mode 100644 index ede84bee20f5..000000000000 --- a/modules/virt-about-cluster-checkup-framework.adoc +++ /dev/null @@ -1,21 +0,0 @@ -// Module included in the following assemblies: -// -// * virt/monitoring/virt-running-cluster-checkups.adoc - -:_mod-docs-content-type: CONCEPT -[id="virt-about-cluster-checkup-framework_{context}"] -= About the {VirtProductName} cluster checkup framework - -A _checkup_ is an automated test workload that allows you to verify if a specific cluster functionality works as expected. The cluster checkup framework uses native Kubernetes resources to configure and execute the checkup. - -By using predefined checkups, cluster administrators and developers can improve cluster maintainability, troubleshoot unexpected behavior, minimize errors, and save time. They can also review the results of the checkup and share them with experts for further analysis. Vendors can write and publish checkups for features or services that they provide and verify that their customer environments are configured correctly. - -Running a predefined checkup in an existing namespace involves setting up a service account for the checkup, creating the `Role` and `RoleBinding` objects for the service account, enabling permissions for the checkup, and creating the input config map and the checkup job. You can run a checkup multiple times. - -[IMPORTANT] -==== -You must always: - -* Verify that the checkup image is from a trustworthy source before applying it. -* Review the checkup permissions before creating the `Role` and `RoleBinding` objects. -==== diff --git a/modules/virt-checking-storage-configuration.adoc b/modules/virt-checking-storage-configuration.adoc index d5fb5739d977..4a3fc5e4ba58 100644 --- a/modules/virt-checking-storage-configuration.adoc +++ b/modules/virt-checking-storage-configuration.adoc @@ -9,7 +9,8 @@ Use a predefined checkup to verify that the {product-title} cluster storage is configured optimally to run {VirtProductName} workloads. .Prerequisites -* You have installed the OpenShift CLI (`oc`). + +* You have installed the {oc-first}. * The cluster administrator has created the required `cluster-reader` permissions for the storage checkup service account and namespace, such as in the following example: + [source,yaml] @@ -29,7 +30,6 @@ subjects: ---- <1> The namespace where the checkup is to be run. - .Procedure . Create a `ServiceAccount`, `Role`, and `RoleBinding` manifest file for the storage checkup: diff --git a/modules/virt-latency-checkup-web-console.adoc b/modules/virt-latency-checkup-web-console.adoc index 74b6880514b1..76c389e25f34 100644 --- a/modules/virt-latency-checkup-web-console.adoc +++ b/modules/virt-latency-checkup-web-console.adoc @@ -25,4 +25,6 @@ Run a latency checkup to verify network connectivity and measure the latency bet . Optional: Target specific nodes by enabling *Select nodes* and specifying the *Source node* and *Target node*. . Click *Run*. -You can view the status of the latency checkup in the *Checkups* list on the *Latency checkup* tab. Click on the name of the checkup for more details. \ No newline at end of file +.Verification + +* To view the status of the latency checkup, go to the *Checkups* list on the *Latency checkup* tab. Click on the name of the checkup for more details. diff --git a/modules/virt-measuring-latency-vm-secondary-network.adoc b/modules/virt-measuring-latency-vm-secondary-network.adoc index cdebda11dfaf..06fb7b683037 100644 --- a/modules/virt-measuring-latency-vm-secondary-network.adoc +++ b/modules/virt-measuring-latency-vm-secondary-network.adoc @@ -6,9 +6,7 @@ [id="virt-measuring-latency-vm-secondary-network_{context}"] = Running a latency checkup by using the CLI -You use a predefined checkup to verify network connectivity and measure latency between two virtual machines (VMs) that are attached to a secondary network interface. The latency checkup uses the ping utility. - -You run a latency checkup by performing the following steps: +You run a latency checkup using the CLI by performing the following steps: . Create a service account, roles, and rolebindings to provide cluster access permissions to the latency checkup. . Create a config map to provide the input to run the checkup and to store the results. @@ -19,7 +17,7 @@ You run a latency checkup by performing the following steps: .Prerequisites -* You installed the OpenShift CLI (`oc`). +* You installed the {oc-first}. * The cluster has at least two worker nodes. * You configured a network attachment definition for a namespace. diff --git a/snippets/virt-about-running-checkups.adoc b/snippets/virt-about-running-checkups.adoc new file mode 100644 index 000000000000..cd9b00b23b85 --- /dev/null +++ b/snippets/virt-about-running-checkups.adoc @@ -0,0 +1,19 @@ +// Text snippet included in the following modules: +// +// * +// +// Text snippet included in the following assemblies: +// +// * /virt/monitoring/virt-running-cluster-checkups.adoc + +:_mod-docs-content-type: SNIPPET + +Running a predefined checkup in an existing namespace involves setting up a service account for the checkup, creating the `Role` and `RoleBinding` objects for the service account, enabling permissions for the checkup, and creating the input config map and the checkup job. You can run a checkup multiple times. + +[IMPORTANT] +==== +You must always: + +* Verify that the checkup image is from a trustworthy source before applying it. +* Review the checkup permissions before creating the `Role` and `RoleBinding` objects. +==== diff --git a/virt/monitoring/virt-running-cluster-checkups.adoc b/virt/monitoring/virt-running-cluster-checkups.adoc index e189128dd5ec..49422b6e46d2 100644 --- a/virt/monitoring/virt-running-cluster-checkups.adoc +++ b/virt/monitoring/virt-running-cluster-checkups.adoc @@ -6,46 +6,45 @@ include::_attributes/common-attributes.adoc[] toc::[] -{VirtProductName} includes the following predefined checkups that can be used for cluster maintenance and troubleshooting: +A _checkup_ is an automated test workload that allows you to verify if a specific cluster functionality works as expected. The cluster checkup framework uses native Kubernetes resources to configure and execute the checkup. + +:FeatureName: The {VirtProductName} cluster checkup framework +include::snippets/technology-preview.adoc[] + +As a developer or cluster administrator, you can use predefined checkups to improve cluster maintainability, troubleshoot unexpected behavior, minimize errors, and save time. You can review the results of the checkup and share them with experts for further analysis. Vendors can write and publish checkups for features or services that they provide and verify that their customer environments are configured correctly. + +[id="virt-running-cluster-checkups-latency"] +== Running predefined latency checkups + +You can use a latency checkup to verify network connectivity and measure latency between two virtual machines (VMs) that are attached to a secondary network interface. The predefined latency checkup uses the ping utility. -* Latency checkup, which verifies network connectivity and measures latency between two virtual machines (VMs) that are attached to a secondary network interface. -+ [IMPORTANT] ===== Before you run a latency checkup, you must first xref:../../virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc#virt-connecting-vm-to-linux-bridge[create a bridge interface] on the cluster nodes to connect the VM's secondary interface to any interface on the node. If you do not create a bridge interface, the VMs do not start and the job fails. ===== -* Storage checkup, which verifies if the cluster storage is optimally configured for {VirtProductName}. +include::snippets/virt-about-running-checkups.adoc[] -:FeatureName: The {VirtProductName} cluster checkup framework -include::snippets/technology-preview.adoc[] +include::modules/virt-latency-checkup-web-console.adoc[leveloffset=+2] -include::modules/virt-about-cluster-checkup-framework.adoc[leveloffset=+1] +include::modules/virt-measuring-latency-vm-secondary-network.adoc[leveloffset=+2] -[id="virt-running-cluster-checkups-console_{context}"] -== Running checkups by using the web console +[id="virt-running-cluster-checkups-storage"] +== Running predefined storage checkups -Use the following procedures the first time you run checkups by using the web console. For additional checkups, click *Run checkup* on either checkup tab, and select the appropriate checkup from the drop down menu. +You can use a storage checkup to verify that the cluster storage is optimally configured for {VirtProductName}. -include::modules/virt-latency-checkup-web-console.adoc[leveloffset=+2] +include::snippets/virt-about-running-checkups.adoc[] include::modules/virt-storage-checkup-web-console.adoc[leveloffset=+2] -[id="virt-running-cluster-checkups-cli_{context}"] -== Running checkups by using the CLI - -Use the following procedures the first time you run checkups by using the command line. - -include::modules/virt-measuring-latency-vm-secondary-network.adoc[leveloffset=+2] - include::modules/virt-checking-storage-configuration.adoc[leveloffset=+2] - ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] [role="_additional-resources"] [id="additional-resources_running-cluster-checkups"] == Additional resources endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] -* xref:../../virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc#virt-connecting-vm-to-linux-bridge[Attaching a virtual machine to multiple networks] -endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] \ No newline at end of file +* xref:../../virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc#virt-connecting-vm-to-linux-bridge[Connecting a virtual machine to a Linux bridge network] +endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]