-Installing Yardstick using Docker
----------------------------------
-
-Yardstick iteself has a Docker image, this Docker image (**Yardstick-stable**)
-serves as a replacement for installing the Yardstick framework in a virtual
-environment (for example as done in :ref:`install-framework`).
-It is recommended to use this Docker image to run Yardstick test.
-
-Yardstick-stable image
-^^^^^^^^^^^^^^^^^^^^^^
-Pull the Yardstick-stable Docker image from Docker hub:
-
-::
-
- docker pull opnfv/yardstick:stable
-
-Run the Docker image:
-
-::
-
- docker run \
- --privileged=true \
- --rm \
- -t \
- -e "INSTALLER_TYPE=${INSTALLER_TYPE}" \
- -e "INSTALLER_IP=${INSTALLER_IP}" \
- opnfv/yardstick \
- exec_tests.sh ${YARDSTICK_DB_BACKEND} ${YARDSTICK_SUITE_NAME}
-
-Where ``${INSTALLER_TYPE}`` can be apex, compass, fuel or joid, ``${INSTALLER_IP}``
-is the installer master node IP address (i.e. 10.20.0.2 is default for fuel). ``${YARDSTICK_DB_BACKEND}``
-is the IP and port number of DB, ``${YARDSTICK_SUITE_NAME}`` is the test suite you want to run.
-For more details, please refer to the Jenkins job defined in Releng project, labconfig information
-and sshkey are required. See the link
-https://git.opnfv.org/cgit/releng/tree/jjb/yardstick/yardstick-ci-jobs.yml.
-
-Note: exec_tests.sh is used for executing test suite here, furthermore, if someone
-wants to execute the test suite manually, it can be used as long as the parameters
-are configured correct. Another script called run_tests.sh is used for unittest in
-Jenkins verify job, in local manaul environment, it is recommended to run before
-test suite execuation.
-
-Basic steps performed by the **Yardstick-stable** container:
-
-1. clone yardstick and releng repos
-2. setup OS credentials (releng scripts)
-3. install yardstick and dependencies
-4. build yardstick cloud image
-5. Upload yardstick cloud image to glance
-6. upload cirros-0.3.3 cloud image and ubuntu-14.04 cloud image to glance
-7. run yardstick test scenarios
-8. cleanup
-
-If someone only wants to execute a single test case, one can log into the yardstick-stable
-container first using command:
-
-::