This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
functest_docker [2015/10/21 14:27] Jose Lausuch [Offline Functest] |
functest_docker [2015/11/27 13:42] (current) Morgan Richomme |
||
---|---|---|---|
Line 54: | Line 54: | ||
* INSTALLER_IP. Usually "10.20.0.2" for fuel and "172.30.10.73" foreman. | * INSTALLER_IP. Usually "10.20.0.2" for fuel and "172.30.10.73" foreman. | ||
- | $ docker run -ti -e "INSTALLER_TYPE=fuel" -e "INSTALLER_IP=10.20.0.2" opnfv/functest | + | $ docker run -ti -e "INSTALLER_TYPE=fuel" -e "INSTALLER_IP=10.20.0.2" -e "NODE_NAME=opnfv-jump-2" opnfv/functest |
+ | |||
+ | note: for the dev labs, it is also possible to precise the path of your openstack creds, see [[https://wiki.opnfv.org/functest_docker#docker_options |Docker Options below]] | ||
Now, you are inside the docker container. | Now, you are inside the docker container. | ||
Line 61: | Line 64: | ||
$ ${repos_dir}/functest/docker/prepare_env.sh | $ ${repos_dir}/functest/docker/prepare_env.sh | ||
+ | |||
+ | |||
+ | NOTE: ${repos_dir} is a default environment variable inside the docker container, which points to /home/opnfv/repos | ||
* Run the script to start the tests | * Run the script to start the tests | ||
Line 69: | Line 75: | ||
* vPing test case | * vPing test case | ||
* ODL suite | * ODL suite | ||
- | * Rally benchmark (this will take long) <- in case you need, change a line to run only 1 set of tests and not all (see * below) | + | * Rally benchmark (this will take long) <- in case you need, change a line to run only 1 set of tests and not all (see [[#rally_suites|run_tests.sh options]] below) |
* Tempest | * Tempest | ||
- | |||
- | |||
- | * In order to run only 1 suite of Rally bench, you need to modify the call to rally within run_tests.sh script: | ||
- | |||
- | $ vi ${repos_dir}/functest/docker/run_tests.sh | ||
- | (go to line 68 or search the following line) | ||
- | python ${FUNCTEST_REPO_DIR}/testcases/VIM/OpenStack/CI/libraries/run_rally.py --debug ${FUNCTEST_REPO_DIR}/ all | ||
- | Change "all" to "keystone" for example: | ||
- | python ${FUNCTEST_REPO_DIR}/testcases/VIM/OpenStack/CI/libraries/run_rally.py --debug ${FUNCTEST_REPO_DIR}/ glance | ||
- | Other options are: | ||
- | ['authenticate', 'glance', 'cinder', 'ceilometer', 'heat', 'keystone', 'neutron', 'nova', 'quotas', 'requests', 'vm', 'all'] | ||
- | |||
Line 103: | Line 97: | ||
+ | NOTE: the output will be shown on the screen until you press ^C. To attach to the docker output again type: | ||
+ | |||
+ | $ docker ps | ||
+ | $ docker attach <ID_of_the_container> | ||
+ | |||
+ | ===== Docker options ===== | ||
+ | ==== I need to change some parameters in config_functest.yaml ==== | ||
In case you need to provide different configuration parameters to Functest (e.g. commit IDs or branches for the repositories, ...) copy the config_functest.yaml from the repository to your current directory and run docker with a volume: | In case you need to provide different configuration parameters to Functest (e.g. commit IDs or branches for the repositories, ...) copy the config_functest.yaml from the repository to your current directory and run docker with a volume: | ||
$ wget https://git.opnfv.org/cgit/functest/plain/testcases/config_functest.yaml | $ wget https://git.opnfv.org/cgit/functest/plain/testcases/config_functest.yaml | ||
Line 112: | Line 113: | ||
- | NOTE: the output will be shown on the screen until you press ^C. To attach to the docker output again type: | + | ==== I don't use the default OpenStack credentials ==== |
+ | You can also provide your own OpenStack credentials to the container. This way, it will not try to fetch the credentials automatically contacting the OS controller. | ||
+ | |||
+ | If you do this, you don't need to specify any more the environment variables INSTALLER_TYPE and INSTALLER_IP, since they are used only by the script that gets the credentials automatically (a script called fetch_os_credentials.sh). | ||
+ | $ docker run -t opnfv/functest \ | ||
+ | -v $(pwd)/<your_local_creds_file>:/home/opnfv/functest/conf/openstack.creds \ | ||
+ | "${cmd1} && ${cmd2}" | ||
+ | |||
+ | For more info: https://gerrit.opnfv.org/gerrit/#/c/3073/ | ||
+ | |||
+ | This is recommended if you don't install OPNFV with the default OpenStack credentials. | ||
+ | |||
+ | |||
+ | ===== run_tests.sh options ===== | ||
+ | ==== give test name as input ==== | ||
+ | You can tell run_tests.sh to run only the tests you desire. To do that, add the flag "-t or --test" plus the name of the available tests separated by comas. | ||
+ | |||
+ | Example: | ||
+ | |||
+ | $ ${repos_dir}/functest/docker/run_tests.sh --test vping,odl | ||
+ | Possible options are: | ||
+ | ['vping','odl','tempest','rally'] | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== Rally suites ==== | ||
+ | In order to run only 1 suite of Rally bench, you need to modify the call to rally within run_tests.sh script: | ||
+ | |||
+ | $ vi ${repos_dir}/functest/docker/run_tests.sh | ||
+ | (go to line 68 or search the following line) | ||
+ | python ${FUNCTEST_REPO_DIR}/testcases/VIM/OpenStack/CI/libraries/run_rally.py --debug ${FUNCTEST_REPO_DIR}/ all | ||
+ | Change "all" to "keystone" for example: | ||
+ | python ${FUNCTEST_REPO_DIR}/testcases/VIM/OpenStack/CI/libraries/run_rally.py --debug ${FUNCTEST_REPO_DIR}/ glance | ||
+ | Other options are: | ||
+ | ['authenticate', 'glance', 'cinder', 'ceilometer', 'heat', 'keystone', 'neutron', 'nova', 'quotas', 'requests', 'vm', 'all'] | ||
+ | |||
- | $ docker ps | ||
- | $ docker attach <ID_of_the_container> | ||
Line 128: | Line 163: | ||
| | ||
IMPORTANT: This is still under test! And probably some things need to be updated to be completely offline. | IMPORTANT: This is still under test! And probably some things need to be updated to be completely offline. | ||
+ | |||
+ | |||
+ |