smartbear/soapuios-testrunner repository overview

⁠Running SoapUI Open Source Functional Tests in Docker

⁠About

The soapuios-testrunner Docker image runs SoapUI Open Source functional tests⁠ within containers.

⁠Docker command syntax

To run a SoapUI functional test in a Docker container, use the following command line:

docker run -v="Project Folder":/project -v="Report Folder":/reports -v="Extensions Folder":/ext -e COMMAND_LINE="Test Runner Arguments" -it smartbear/soapuios-testrunner:latest

⁠Arguments

• -v=Project Folder:/project
  Required. Specifies the path to the folder that contains the SoapUI project. When a container starts this folder is copied to the container.
  Usage: -v="C:\Work\SoapUI Project":/project
  Note: On some systems, you may need to change the path in the following way:
  "C:\Work\SoapUI Project" -> "/host_mnt/C/Work/SoapUI Project"

• -v=Extensions Folder:/ext
  Specifies the folder whose content should be copied to the /bin/ext folder of the SoapUI installation in the container. Use this argument if your project requires additional libraries, such as database drivers or plugins.
  Usage: -v="C:\Work\SoapUI Extensions":/ext
  Note: On some systems, you may need to change the path in the following way:
  "C:\Work\SoapUI Extensions" -> "/host_mnt/C/Work/SoapUI Extensions"

• -v=Plugin Folder:/root/.soapuios/plugins
  Specifies the folder with plugins that should be installed to SoapUI in the container.
  Usage: -v="C:\Users\<User>\.soapuios\plugins":/root/.soapuios/plugins
  Note: On some systems, you may need to change the path in the following way:
  "C:\Users\<User>\.soapuios\plugins" -> "/host_mnt/C/Users/<User>/.soapuios/plugins"

• v=Report Folder:/reports
  Specifies the folder on a local machine to which the generated reports will be exported.
  Usage: -v="C:\Work\Reports":/reports
  Note: On some systems, you may need to change the path in the following way:
  "C:\Work\Reports" -> "/host_mnt/C/Work/Reports"

• -e COMMAND_LINE="Test Runner Arguments"
  Required. Specifies arguments for the test runner. To refer to the project volume, use the %project% variable. To refer to the reports volume, use the %reports% variable.
  Usage: -e COMMAND_LINE="-f/%reports% '/%project%/Sample-soapui-project.xml'"

• -it
  Required. This command enables an interactive command-line interface within the Docker container.

• soapuios-testrunner:latest
  Required. Specifies the image to create a container from.

⁠Full command sample

docker run -v="C:\TestRunner\Project":/project -v="C:\TestRunner\Reports":/reports -v="C:\TestRunner\Extensions":/ext -e COMMAND_LINE="-f/%reports% '/%project%/Sample-soapui-project.xml'" -it smartbear/soapuios-testrunner:latest

⁠Exit codes

Besides the standard Docker exit codes (see the Docker documentation⁠) the soapuios-testrunner Docker image uses the following codes:

⁠Troubleshooting

If you cannot run Docker due to the Drive has not been shared error, perform the following steps:

1. Right-click the Docker icon in the notification area and select Settings.
2. On the Shared Drives page of the Settings dialog, select all the drives you use to run the Docker image.
3. Click Apply. You may need to enter the credentials of your system account to apply the changes.

Note: If your drives have already been shared, but the error occurs anyway, turn off sharing. After you apply the changes, repeat these steps to share the drives again.