From 5491eddd79c61aba18ae603a0148d7985415c8ee Mon Sep 17 00:00:00 2001 From: Kirsten Laskoski Date: Thu, 11 Jul 2024 14:11:41 -0400 Subject: [PATCH] cnf ran: update readme to match current state Over time the README has gotten out of sync with changes to the cnf/ran subdirectory. This PR updates the README to account for the ZTP and CPU frequency tests as well as changes to helpers, such as the renaming to ranhelper and removal of the redfish package. --- tests/cnf/ran/README.md | 41 ++++++++++++++++++++++++++++++++--------- 1 file changed, 32 insertions(+), 9 deletions(-) diff --git a/tests/cnf/ran/README.md b/tests/cnf/ran/README.md index 49240d0e6..62f4c950f 100644 --- a/tests/cnf/ran/README.md +++ b/tests/cnf/ran/README.md @@ -20,17 +20,19 @@ Some test suites (ZTP, TALM) require clusters to be deployed via GitOps ZTP and | [containernshide](containernshide/containernshide_suite_test.go) | Tests that containers have a hidden mount namespace | | [powermanagement](powermanagement/powermanagement_suite_test.go) | Tests powersave settings using workload hints | | [talm](talm/talm_suite_test.go) | Tests the topology aware lifecycle manager (TALM) | +| [gitopsztp](gitopsztp/ztp_suite_test.go) | Tests zero touch provisioning (ZTP) and Argo CD | ### Internal pkgs | Name | Description | |------------------------------------------------------|-------------------------------------------------------------| -| [cluster](internal/cluster/cluster.go) | Provides a way to execute commands on clusters with retries | -| [helper](internal/helper/helper.go) | Common helpers, currently just for checking pod health | +| [rancluster](internal/rancluster/rancluster.go) | Helpers for viewing the state of a cluster itself | +| [ranhelper](internal/ranhelper/ranhelper.go) | Common helpers that do not fit into a more specific package | | [ranconfig](internal/ranconfig/config.go) | Configures environment variables and default values | | [raninittools](internal/raninittools/raninitools.go) | Provides an APIClient for access to cluster | | [ranparam](internal/ranparam/const.go) | Labels and other constants used in the test suites | -| [redfish](internal/redfish/redfish.go) | Wrapper around gofish to provide access to the Redfish API | +| [stats](internal/stats/stats.go) | Basic statistics functions with unit tests | +| [version](internal/version/version.go) | Allows getting and checking cluster and operator versions | ### Eco-goinfra pkgs @@ -77,14 +79,21 @@ These inputs are all specific to the TALM pre-cache tests. They are also all opt - `ECO_CNF_RAN_PTP_OPERATOR_NAMESPACE`: Namespace that the PTP operator uses. - `ECO_CNF_RAN_TALM_PRECACHE_POLICIES`: List of policies to copy for the precache operator tests. +#### ZTP generator inputs + +This input is specific to the ZTP generator tests and is optional. + +- `ECO_CNF_RAN_ZTP_SITE_GENERATE_IMAGE`: Container image to use for generating CRs from the site config. + ### Running the RAN test suites +Except for the container namespace hiding tests, a dump of relevant CRs will be generated for failed tests only when `ECO_ENABLE_REPORT=true`. + #### Running the container namespace hiding test suite ``` # export KUBECONFIG= -# export ECO_TEST_FEATURES=ran -# export ECO_TEST_LABELS=containernshide +# export ECO_TEST_FEATURES=containernshide # make run-tests ``` @@ -92,20 +101,20 @@ These inputs are all specific to the TALM pre-cache tests. They are also all opt ``` # export KUBECONFIG= -# export ECO_TEST_FEATURES=ran -# export ECO_TEST_LABELS=powermanagement +# export ECO_TEST_FEATURES=powermanagement # export ECO_CNF_RAN_BMC_USERNAME= # export ECO_CNF_RAN_BMC_PASSWORD= # export ECO_CNF_RAN_BMC_HOSTS= # make run-tests ``` +If using more selective labels that do not include the powersaving tests, such as `ECO_TEST_LABELS="powermanagement && !powersave"`, then the `ECO_CNF_RAN_BMC_*` environment variables are not required. + #### Running the TALM test suite ``` # export KUBECONFIG= -# export ECO_TEST_FEATURES=ran -# export ECO_TEST_LABELS=talm +# export ECO_TEST_FEATURES=talm # export ECO_CNF_RAN_KUBECONFIG_HUB= # export ECO_CNF_RAN_KUBECONFIG_SPOKE2= # export ECO_CNF_RAN_BMC_USERNAME= @@ -116,4 +125,18 @@ These inputs are all specific to the TALM pre-cache tests. They are also all opt If using more selective labels that do not include TALM pre-cache, such as with `ECO_TEST_LABELS="talm && !precache"`, then the `ECO_CNF_RAN_BMC_*` environment variables are not required. +#### Running the ZTP test suite + +``` +# export KUBECONFIG= +# export ECO_TEST_FEATURES=ran +# export ECO_TEST_LABELS="ran-ztp && !no-container" +# export ECO_CNF_RAN_KUBECONFIG_HUB= +# make run-tests +``` + +The ZTP generator test cannot be run in a container and thus has the `no-container` label. To run it, set `ECO_TEST_LABELS="ran-ztp && no-container"`. + ### Additional Information + +Note that excluding a label using `ECO_TEST_LABELS=!my-label` may require `set +H` in the shell first. If not, you may see errors like `bash: !my: event not found`.