docs/testing/run-test-docker.md

1 # Run OpenBMC Test Automation Using Docker
3 Running OpenBMC automation using Docker involves creating a Docker image and
4 then running automation tests inside the Docker container.
18 3. Clone openbmc-build-scripts repository.
20    `git clone https://github.com/openbmc/openbmc-build-scripts`
22 4. Change directory to openbmc-build-scripts.
24    `cd openbmc-build-scripts`
28    "openbmc/ubuntu-robot-qemu". You can check images using "docker images"
31    `./scripts/build-qemu-robot-docker.sh`
37    --build-arg http_proxy=<IP>:<PORT> --build-arg https_proxy=<IP>:<PORT>
40 ## Code update process using robot test code
46 2. Clone openbmc-test-automation repository.
48    `git clone https://github.com/openbmc/openbmc-test-automation`
56    docker run --user root \
57              --env HOME=${HOME} \
58              --workdir ${HOME} \
59              --volume ${HOME}/OpenBMC_Automation:${HOME} \
60              --tty openbmc/ubuntu-robot-qemu python -m robot \
61                  -v OPENBMC_HOST:<BMC IP> \
62                  -v FILE_PATH:<BMC_IMG_PATH> \
63                  -i Initiate_Code_Update_BMC \
64                  ${HOME}/openbmc-test-automation/extended/code_update/update_bmc.robot
67    Example to run BMC code update using witherspoon-20170614071422.all.tar image
71    docker run --user root \
72              --env HOME=${HOME} \
73              --workdir ${HOME} \
74              --volume ${HOME}/OpenBMC_Automation:${HOME} \
75              --tty openbmc/ubuntu-robot-qemu python -m robot \
76                  -v OPENBMC_HOST:1.11.222.333 \
77                  -v FILE_PATH:/home/witherspoon-20170614071422.all.tar \
78                  -i Initiate_Code_Update_BMC \
79                  ${HOME}/openbmc-test-automation/extended/code_update/update_bmc.robot
91 ## Executing Automation Test
93 1. Execute docker run to execute OpenBMC automation test cases.
95    **Note:** This runs a Docker container using openbmc/ubuntu-robot-qemu image.
97    Robot test code is extracted and ran on this container using run-robot.sh
101    docker run --user root \
102              --env HOME=${HOME} \
103              --env IP_ADDR=<BMC IP> \
104              --env SSH_PORT=22 \
105              --env HTTPS_PORT=443 \
106              --env ROBOT_TEST_CMD="tox -e <System Type> -- <Robot Cmd>" \
107              --workdir ${HOME} \
108              --volume ${WORKSPACE}:${HOME} \
109              --tty openbmc/ubuntu-robot-qemu \
110                  ${HOME}/openbmc-build-scripts/scripts/run-robot.sh
113    Example to run entire test suite:
116    docker run --user root \
117              --env HOME=${HOME} \
118              --env IP_ADDR=1.11.222.333 \
119              --env SSH_PORT=22 \
120              --env HTTPS_PORT=443 \
121              --env ROBOT_TEST_CMD="tox -e witherspoon -- tests" \
122              --workdir ${HOME} \
123              --volume ${HOME}/OpenBMC_Automation:${HOME} \
124              --tty openbmc/ubuntu-robot-qemu \
125                  ${HOME}/openbmc-build-scripts/scripts/run-robot.sh
128 2. After the execution, test results will be available in below files.