User Tools

Site Tools


functest_docker

This is an old revision of the document!


Functest within a Docker

This is the unofficial procedure to run Functest within a docker.


  • Install Docker on the server you want the tests from (example for Ubuntu):
$ curl -sSL https://get.docker.com/ | sh

Ubuntu: https://docs.docker.com/installation/ubuntulinux/

RHEL: https://docs.docker.com/installation/rhel/


  • Add your user to docker group to be able to run commands without sudo:
$ sudo usermod -aG docker <your_user>

  • Pull the Functest Docker image from the hub:
$ docker pull opnfv/functest

  • Check that the image is available:
$ docker images

  • Run the docker container giving the environment variables
    • INSTALLER_TYPE. Possible values are "fuel" or "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

Now, you are inside the docker container.


  • Run the script to install functest environment and start the tests.
$ {repos_dir}/functest/docker/start.sh

NOTE: This will run ALL the tests we have for SR1:

  • vPing test case
  • ODL suite
  • Rally benchmark (this will take long) ←– need to change something to run only 1 set of tests and not all (see * below)
  • Tempest


* In order to run only 1 suite of Rally bench, you need to modify the call to rally within start.sh script:

$ vi {repos_dir}/functest/docker/start.sh
(go to line 126)
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', 'heat', 'keystone', 'neutron', 'nova', 'quotas', 'requests', 'vm', 'tempest', 'all', 'smoke']
functest_docker.1444208908.txt.gz · Last modified: 2015/10/07 09:08 by Jose Lausuch