SOAPUI PRO & DOCKER

This project was created to aid in the execution of SoapUI PRO tests in container based environments. This is a work in progress, and the full feature set found in the SoapUI Testrunner has not been tested on the container version.

This implementation of SoapUI and Docker requires building the project file into the container, and then passing arguments to tailor how this will run outside of the default full project execution. A library of images could then be built/maintained, and pulled in as needed for execution by a pipeline or larger process.

If you are interested in other base image versions of this repository - there is a branch supporting RHEL and (potentially) some others down the line.

This is not supported by Smartbear

---

REQUIREMENTS & RESTRICTIONS

• Docker 17.09 +
• Valid SoapUI PRO floating license
• License hosted on Protection floating license server and configured as described in official docs.
• Local project file
• Currently only supports flat XML projects (default type)

---

CLONE REPOSITORY

$ git clone https://github.com/nate01776/soapuipro_docker.git
$ cd ./soapui_docker

---

BUILD

  $ docker build \
      --build-arg ls_address=[server_address] \
      --build-arg project_path=[project_path] \
      -t [tag_name] .

• server_address (REQ): License server IP address or hostname
• project_path (REQ): Local path of project XML to be built into container
• tag_name: Tag associated w/build (eg. soapuiproject).
• The XML project file should be copied into the same repository the container will be built from
• Build will typically take ~5 minutes depending on available resources

EXAMPLE

  $ docker build \
      --build-arg ls_address=127.0.0.1 \
      --build-arg project_path=./readyapi_project.xml \
      -t soapui:project_2 .

---

RUN

AS FULL PROJECT

$ docker run [tag_name]

• tag_name: Same tag as from build step.

WITH ARGUMENTS

  $ docker run [tag_name] \
      "[readyapi_arguments]" \
      "./readyapi/project/run.xml"

• tag_name: Same tag as from build step.
• readyapi_arguments: Commands should be passed in as they would against the testrunner, these are mapped to the runner inside of the container and executed. Ensure the full list - including the project run file - is wrapped as a string.

EXAMPLE

  $ docker run soapui:project_2 \
      "-sTestSuite 1" \
      "-cTestCase 1" \
      "-EDefault environment" \
      "./readyapi/project/run.xml"

More information on the associated arguments can be found in the official documentation.

FUTURE

• Support packaged projects instead of XML files - this will allow inclusion of Datasources in some of the standard types, as well as potentially composite projects.
• Support for composite projects on local machine
• Support ability to pull composite project from repository endpoint
• Support for all report types