aboutsummaryrefslogtreecommitdiffstats
path: root/docs/testing/user/configguide/configguide.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/testing/user/configguide/configguide.rst')
-rw-r--r--docs/testing/user/configguide/configguide.rst209
1 files changed, 153 insertions, 56 deletions
diff --git a/docs/testing/user/configguide/configguide.rst b/docs/testing/user/configguide/configguide.rst
index 13a8b591a..e65f358f7 100644
--- a/docs/testing/user/configguide/configguide.rst
+++ b/docs/testing/user/configguide/configguide.rst
@@ -13,10 +13,11 @@ Functest Dockers for OpenStack deployment
-----------------------------------------
Docker images are available on the dockerhub:
- * opnfv/functest-core
* opnfv/functest-healthcheck
* opnfv/functest-smoke
+ * opnfv/functest-smoke-cntt
* opnfv/functest-benchmarking
+ * opnfv/functest-benchmarking-cntt
* opnfv/functest-features
* opnfv/functest-vnf
@@ -28,8 +29,12 @@ cat env::
DEPLOY_SCENARIO=XXX # if not os-nosdn-nofeature-noha scenario
NAMESERVER=XXX # if not 8.8.8.8
- EXTERNAL_NETWORK=XXX # if not first network with router:external=True
- NEW_USER_ROLE=XXX # if not member
+ EXTERNAL_NETWORK=XXX # if not first network with router:external=True
+ DASHBOARD_URL=XXX # else tempest_horizon will be skipped
+ NEW_USER_ROLE=XXX # if not member
+ SDN_CONTROLLER_IP=XXX # if odl scenario
+ VOLUME_DEVICE_NAME=XXX # if not vdb
+ FLAVOR_EXTRA_SPECS=hw:mem_page_size:large # if fdio scenarios
See section on environment variables for details.
@@ -42,6 +47,7 @@ cat env_file::
export OS_PROJECT_NAME=XXX
export OS_PASSWORD=XXX
export OS_IDENTITY_API_VERSION=3
+ export OS_REGION_NAME=XXX
See section on OpenStack credentials for details.
@@ -52,6 +58,7 @@ Create a directory for the different images (attached as a Docker volume)::
images/cirros-0.4.0-aarch64-disk.img
images/cirros-0.4.0-x86_64-disk.img
images/cloudify-docker-manager-community-19.01.24.tar
+ images/Fedora-Cloud-Base-30-1.2.x86_64.qcow2
images/shaker-image-arm64.qcow2
images/shaker-image.qcow2
images/ubuntu-14.04-server-cloudimg-amd64-disk1.img
@@ -74,17 +81,18 @@ Results shall be displayed as follows::
+--------------------------+------------------+---------------------+------------------+----------------+
| TEST CASE | PROJECT | TIER | DURATION | RESULT |
+--------------------------+------------------+---------------------+------------------+----------------+
- | connection_check | functest | healthcheck | 00:01 | PASS |
+ | connection_check | functest | healthcheck | 00:03 | PASS |
| tenantnetwork1 | functest | healthcheck | 00:08 | PASS |
- | tenantnetwork2 | functest | healthcheck | 00:09 | PASS |
- | vmready1 | functest | healthcheck | 00:13 | PASS |
- | vmready2 | functest | healthcheck | 00:12 | PASS |
- | singlevm1 | functest | healthcheck | 00:48 | PASS |
- | singlevm2 | functest | healthcheck | 00:35 | PASS |
- | vping_ssh | functest | healthcheck | 00:53 | PASS |
- | vping_userdata | functest | healthcheck | 00:51 | PASS |
- | cinder_test | functest | healthcheck | 01:42 | PASS |
- | tempest_smoke | functest | healthcheck | 04:55 | PASS |
+ | tenantnetwork2 | functest | healthcheck | 00:16 | PASS |
+ | vmready1 | functest | healthcheck | 00:09 | PASS |
+ | vmready2 | functest | healthcheck | 00:10 | PASS |
+ | singlevm1 | functest | healthcheck | 00:51 | PASS |
+ | singlevm2 | functest | healthcheck | 00:41 | PASS |
+ | vping_ssh | functest | healthcheck | 00:56 | PASS |
+ | vping_userdata | functest | healthcheck | 00:42 | PASS |
+ | cinder_test | functest | healthcheck | 02:19 | PASS |
+ | tempest_smoke | functest | healthcheck | 07:02 | PASS |
+ | tempest_horizon | functest | healthcheck | 00:52 | PASS |
| odl | functest | healthcheck | 00:00 | SKIP |
+--------------------------+------------------+---------------------+------------------+----------------+
@@ -102,24 +110,52 @@ Run smoke suite::
Results shall be displayed as follows::
- +------------------------------------+------------------+---------------+------------------+----------------+
- | TEST CASE | PROJECT | TIER | DURATION | RESULT |
- +------------------------------------+------------------+---------------+------------------+----------------+
- | neutron-tempest-plugin-api | functest | smoke | 07:29 | PASS |
- | rally_sanity | functest | smoke | 13:07 | PASS |
- | refstack_defcore | functest | smoke | 06:32 | PASS |
- | tempest_full | functest | smoke | 33:01 | PASS |
- | tempest_scenario | functest | smoke | 11:31 | PASS |
- | patrole | functest | smoke | 02:14 | PASS |
- | neutron_trunk | functest | smoke | 00:00 | SKIP |
- | networking-bgpvpn | functest | smoke | 01:09 | PASS |
- | networking-sfc | functest | smoke | 00:00 | SKIP |
- | barbican | functest | smoke | 02:12 | PASS |
- +------------------------------------+------------------+---------------+------------------+----------------+
+ +---------------------------+------------------+---------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +---------------------------+------------------+---------------+------------------+----------------+
+ | tempest_neutron | functest | smoke | 16:49 | PASS |
+ | tempest_cinder | functest | smoke | 01:39 | PASS |
+ | tempest_keystone | functest | smoke | 00:57 | PASS |
+ | tempest_heat | functest | smoke | 24:33 | PASS |
+ | rally_sanity | functest | smoke | 18:41 | PASS |
+ | refstack_defcore | functest | smoke | 10:38 | PASS |
+ | tempest_full | functest | smoke | 55:19 | PASS |
+ | tempest_scenario | functest | smoke | 11:06 | PASS |
+ | tempest_slow | functest | smoke | 61:39 | PASS |
+ | patrole | functest | smoke | 02:46 | PASS |
+ | networking-bgpvpn | functest | smoke | 00:00 | SKIP |
+ | networking-sfc | functest | smoke | 00:00 | SKIP |
+ | tempest_barbican | functest | smoke | 02:30 | PASS |
+ +---------------------------+------------------+---------------+------------------+----------------+
Note: if the scenario does not support some tests, they are indicated as SKIP.
See User guide for details.
+Testing smoke CNTT suite
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Run smoke-cntt suite::
+
+ sudo docker run --env-file env \
+ -v $(pwd)/openstack.creds:/home/opnfv/functest/conf/env_file \
+ -v $(pwd)/images:/home/opnfv/functest/images \
+ opnfv/functest-smoke-cntt:hunter
+
+Results shall be displayed as follows::
+
+ +-------------------------------+------------------+---------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +-------------------------------+------------------+---------------+------------------+----------------+
+ | tempest_neutron_cntt | functest | smoke | 13:54 | PASS |
+ | tempest_cinder_cntt | functest | smoke | 01:46 | PASS |
+ | tempest_keystone_cntt | functest | smoke | 00:58 | PASS |
+ | tempest_heat_cntt | functest | smoke | 25:31 | PASS |
+ | rally_sanity_cntt | functest | smoke | 18:50 | PASS |
+ | tempest_full_cntt | functest | smoke | 44:32 | PASS |
+ | tempest_scenario_cntt | functest | smoke | 11:14 | PASS |
+ | tempest_slow_cntt | functest | smoke | 43:55 | PASS |
+ +-------------------------------+------------------+---------------+------------------+----------------+
+
Testing benchmarking suite
^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -135,15 +171,36 @@ Results shall be displayed as follows::
+--------------------+------------------+----------------------+------------------+----------------+
| TEST CASE | PROJECT | TIER | DURATION | RESULT |
+--------------------+------------------+----------------------+------------------+----------------+
- | rally_full | functest | benchmarking | 121:55 | PASS |
- | rally_jobs | functest | benchmarking | 24:21 | PASS |
- | vmtp | functest | benchmarking | 00:00 | SKIP |
- | shaker | functest | benchmarking | 00:00 | SKIP |
+ | rally_full | functest | benchmarking | 108:34 | PASS |
+ | rally_jobs | functest | benchmarking | 22:07 | PASS |
+ | vmtp | functest | benchmarking | 15:38 | PASS |
+ | shaker | functest | benchmarking | 25:12 | PASS |
+--------------------+------------------+----------------------+------------------+----------------+
Note: if the scenario does not support some tests, they are indicated as SKIP.
See User guide for details.
+Testing benchmarking CNTT suite
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Run benchmarking-cntt suite::
+
+ sudo docker run --env-file env \
+ -v $(pwd)/openstack.creds:/home/opnfv/functest/conf/env_file \
+ -v $(pwd)/images:/home/opnfv/functest/images \
+ opnfv/functest-benchmarking:hunter
+
+Results shall be displayed as follows::
+
+ +-------------------------+------------------+----------------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +-------------------------+------------------+----------------------+------------------+----------------+
+ | rally_full_cntt | functest | benchmarking | 106:60 | PASS |
+ | rally_jobs_cntt | functest | benchmarking | 21:16 | PASS |
+ | vmtp | functest | benchmarking | 16:15 | PASS |
+ | shaker | functest | benchmarking | 25:09 | PASS |
+ +-------------------------+------------------+----------------------+------------------+----------------+
+
Testing features suite
^^^^^^^^^^^^^^^^^^^^^^
@@ -184,21 +241,22 @@ Results shall be displayed as follows::
+----------------------+------------------+--------------+------------------+----------------+
| TEST CASE | PROJECT | TIER | DURATION | RESULT |
+----------------------+------------------+--------------+------------------+----------------+
- | cloudify | functest | vnf | 06:42 | PASS |
- | cloudify_ims | functest | vnf | 39:21 | PASS |
- | heat_ims | functest | vnf | 34:33 | PASS |
- | vyos_vrouter | functest | vnf | 20:20 | PASS |
- | juju_epc | functest | vnf | 56:55 | PASS |
+ | cloudify | functest | vnf | 04:35 | PASS |
+ | cloudify_ims | functest | vnf | 24:16 | PASS |
+ | heat_ims | functest | vnf | 30:36 | PASS |
+ | vyos_vrouter | functest | vnf | 15:37 | PASS |
+ | juju_epc | functest | vnf | 34:39 | PASS |
+----------------------+------------------+--------------+------------------+----------------+
Functest Dockers for Kubernetes deployment
------------------------------------------
Docker images are available on the dockerhub:
- * opnfv/functest-kubernetes-core
- * opnfv/functest-kubernetest-healthcheck
- * opnfv/functest-kubernetest-smoke
- * opnfv/functest-kubernetest-features
+ * opnfv/functest-kubernetes-healthcheck
+ * opnfv/functest-kubernetes-smoke
+ * opnfv/functest-kubernetes-security
+ * opnfv/functest-kubernetes-benchmarking
+ * opnfv/functest-kubernetes-cnf
Preparing your environment
^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -224,7 +282,8 @@ Results shall be displayed as follows::
+-------------------+------------------+---------------------+------------------+----------------+
| TEST CASE | PROJECT | TIER | DURATION | RESULT |
+-------------------+------------------+---------------------+------------------+----------------+
- | k8s_smoke | functest | healthcheck | 02:27 | PASS |
+ | k8s_quick | functest | healthcheck | 00:20 | PASS |
+ | k8s_smoke | functest | healthcheck | 00:45 | PASS |
+-------------------+------------------+---------------------+------------------+----------------+
Testing smoke suite
@@ -238,34 +297,72 @@ Run smoke suite::
Results shall be displayed as follows::
- +-------------------------+------------------+---------------+------------------+----------------+
- | TEST CASE | PROJECT | TIER | DURATION | RESULT |
- +-------------------------+------------------+---------------+------------------+----------------+
- | k8s_conformance | functest | smoke | 57:14 | PASS |
- +-------------------------+------------------+---------------+------------------+----------------+
+ +---------------------------+------------------+---------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +---------------------------+------------------+---------------+------------------+----------------+
+ | k8s_conformance | functest | smoke | 100:50 | PASS |
+ | xrally_kubernetes | functest | smoke | 13:19 | PASS |
+ +---------------------------+------------------+---------------+------------------+----------------+
-Testing features suite
+Testing security suite
^^^^^^^^^^^^^^^^^^^^^^
-Run features suite::
+Run smoke suite::
+
+ sudo docker run -it --env-file env \
+ -v $(pwd)/config:/root/.kube/config \
+ opnfv/functest-kubernetes-security:hunter
+
+Results shall be displayed as follows::
+
+ +---------------------------+------------------+------------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +---------------------------+------------------+------------------+------------------+----------------+
+ | kube_hunter | functest | security | 00:19 | PASS |
+ | kube_bench_master | functest | security | 00:01 | PASS |
+ | kube_bench_node | functest | security | 00:01 | PASS |
+ +---------------------------+------------------+------------------+------------------+----------------+
+
+Testing benchmarking suite
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Run benchmarking suite::
+
+ sudo docker run -it --env-file env \
+ -v $(pwd)/config:/root/.kube/config \
+ opnfv/functest-kubernetes-benchmarking:hunter
+
+Results shall be displayed as follows::
+
+ +--------------------------------+------------------+----------------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +--------------------------------+------------------+----------------------+------------------+----------------+
+ | xrally_kubernetes_full | functest | benchmarking | 37:48 | PASS |
+ +--------------------------------+------------------+----------------------+------------------+----------------+
+
+Testing cnf suite
+^^^^^^^^^^^^^^^^^
+
+Run cnf suite::
sudo docker run -it --env-file env \
-v $(pwd)/config:/root/.kube/config \
- opnfv/functest-kubernetes-features:hunter
+ opnfv/functest-kubernetes-cnf:hunter
Results shall be displayed as follows::
- +----------------------+------------------+------------------+------------------+----------------+
- | TEST CASE | PROJECT | TIER | DURATION | RESULT |
- +----------------------+------------------+------------------+------------------+----------------+
- | stor4nfv_k8s | stor4nfv | stor4nfv | 00:00 | SKIP |
- | clover_k8s | clover | clover | 00:00 | SKIP |
- +----------------------+------------------+------------------+------------------+----------------+
+ +-------------------------+------------------+--------------+------------------+----------------+
+ | TEST CASE | PROJECT | TIER | DURATION | RESULT |
+ +-------------------------+------------------+--------------+------------------+----------------+
+ | k8s_vims | functest | cnf | 09:09 | PASS |
+ | helm_vims | functest | cnf | 07:55 | PASS |
+ | cnf_conformance | functest | cnf | 02:18 | PASS |
+ +-------------------------+------------------+--------------+------------------+----------------+
Environment variables
=====================
-Several environement variables may be specified:
+Several environment variables may be specified:
* INSTALLER_IP=<Specific IP Address>
* DEPLOY_SCENARIO=<vim>-<controller>-<nfv_feature>-<ha_mode>