| commit | 2c6469dd880be25e31b39b269baa2ac0a2086365 | [log] [tgz] |
|---|---|---|
| author | Ievgeniia Zadorozhna <izadorozhna@mirantis.com> | Wed Aug 10 17:21:10 2022 +0300 |
| committer | Oleksandr Savatieiev <osavatieiev@mirantis.com> | Mon Aug 15 15:04:19 2022 +0000 |
| tree | e36db59594d9e15d69b90caab37393c2c8c8f11e | |
| parent | 90aa8023612c8fc4c08399d7407539ce4c8d9ecf [diff] |
Switched creation of SGs, FIPs to Neutron instead of Nova * Since there were "novaclient.v2.security_group_rules module is deprecated" warnings, switched creation of SG to the Neutron instead of Nova. * Since there were "novaclient.v2.floating_ips module is deprecated" warning, switched creating of FIP to the Neutron instead of Nova. * Added special methods for creating/deleting FIPs. Added the exception in case FIP is already absent. * Added check whether the iperf tool is installed at the VMs and raising and exception in case iperf tool is not installed in the VM (due to Internet access issue or transfering & installing offline packages). Related-PROD: PROD-36943 Change-Id: I165e1358754f3c98adbf8e4cdbfb0b10d2ac117f
Requirements
At least Python 3.6 is required for the tests.
Installation
cd mos-spt/ virtualenv .venv . .venv/bin/activate pip install -r requirements.txt
Configuration
Open global_config.yaml file to override the settings, or export the environment variables.
Settings
The following options can be set in global_config.yaml file, or by exporting the environment variables.
| Environment Variable | Default | Description |
|---|---|---|
| IMAGE_SIZE_MB | 9000 | Specific image size (in MB) to upload/download at Glance |
| Environment Variable | Default | Description |
|---|---|---|
| flavor_name | spt-test | Flavor name |
| flavor_ram | 1536 | To define RAM allocation for specific flavor, MB |
| flavor_vcpus | 1 | To define a count of vCPU for flavor |
| flavor_disk | 5 | To define a count of disks on flavor, GB |
| image_name | cvp.ubuntu.2004 | Cloud Ubuntu image to create VMs. Use 20.04 image in case internet_at_vms=false since the offline packages are set for Ubuntu 20.04. You can use any other Ubuntu image in case internet_at_vms=true. |
| CMP_HOSTS | "" | Pair of compute hosts to create VMs at different hosts. By default, some random pair from nova compute list will be selected. To set some pair, set CMP_HOSTS: ["cmp001", "cmp002"] in global_config.yaml file, or export CMP_HOSTS="cmp001,cmp002". |
| skipped_nodes | "" | Skip some compute hosts, so they are not selected at CMP_HOSTS pair. To set some nodes to skip, set skipped_nodes: ["cmp003"] in global_config.yaml file, or export skipped_nodes="cmp003". |
| nova_timeout | 300 | Timeout to VM to be ACTIVE, seconds. |
| external_network | public | External network name to allocate the Floating IPs |
| custom_mtu | default | The MTU to set at the VMs. If "default" is set, the MTU will be set automatically from the newly created SPT internal networks. The default value in the networks comes from the Neutron configuration. In case you want to test the bandwidth with some specific custom MTU, set the value like 8950. |
| ssh_timeout | 500 | Timeout to VM to be reachable via SSH, seconds. |
| iperf_prep_string | "sudo /bin/bash -c 'echo "91.189.88.161 archive.ubuntu.com" >> /etc/hosts'" | Preparation string to set ubuntu repository host in /etc/hosts of VMs |
| internet_at_vms | 'true' | In case True, the Internet is present at VMs, and the tests are able to install iperf3 by apt update; apt install iperf3. In case VMs have no Internet, set 'false' and the iperf3 will be installed from offline *.deb packages. |
| iperf_deb_package_dir_path | /opt/packages/ | Path to the local directory where the iperf3 *.deb packages are present. In the toolset offline images they are located at /opt/packages. Or you can download iperf3 deb package and its dependencies and put them at some custom folder. |
| iperf_time | 60 | iperf3 -t option value: time in seconds to transmit for (iperf -t option). |
| multiple_threads_number | 10 | Number of iperf/iperf3 parallel client threads to run (iperf3/iperf -P option value) |
| multiple_threads_iperf_utility | 'iperf3' | The tool for bandwidth measurements. Options to set: 'iperf' to use v2 and 'iperf3' to use v3. Eventually, this is the name of the utility that is installed at Ubuntu VMs from apt. |
In case internet_at_vms=false, please make sure that iperf_deb_package_dir_path is set correctly and has iperf3 deb package and its dependencies.
Executing tests
Run tests:
pytest -sv --tb=short tests/
In case the test is skipped and you want to know the reason, use python -rs option:
pytest -rs --tb=short tests/
Enable logging
In case something went wrong, use -o log_cli=true option to see detailed logs:
pytest -sv --tb=short -o log_cli=true tests/
By default, the log level is INFO log_cli_level=info. In case you want to go deeper for the API requests (with URIs, payloads, etc), set cli_level=debug in pytest.ini file.