Close menu
Open menu

Installing the Galasa Ecosystem on Docker

The following section explains how to install a Galasa ecosystem on a Docker engine by using the Docker operator. Currently the Docker operator only supports the amd64 platform. A s390x (zLinux) implementation is planned for a future release.


To bring up the Galasa ecosystem by using the Docker operator, you need access to a Linux virtual machine (VM) with Docker engine installed on it.

The VM requires 4 VCPUs, 80GB of storage and a recommended minimum of 8GB of memory. The size of the VM provided is directly related to the number of tests that can be run in parallel. It is possible to bring up the ecosystem with 4GB of memory, but this will support a maximum of two tests running in parallel. Docker has a default value of 4GB of memory set, so you need to change this value which you can do by using Docker Desktop.

Instructions on installing a Docker engine can be found on the Docker documentation page. We are not aware of a minimum version of Docker engine the Docker operator requires.

About the Docker Operator

The Docker operator automatically brings up the following servers on the VM. For more detailed information about these servers, see the Ecosystem architecture documentation.

Note: If the VM has a firewall running, you might need to open the ports that are listed in the following tables.

The following servers are required for the Galasa ecosystem:

Name Description Port
etcd Contains the Configuration Property Store (CPS), the Dynamic Status Store (DSS) and the Credentials Store (CREDs) 2379
CouchDB Contains the Result Archive Store (RAS) 5984
API server The Galasa API server, including the bootstrap 8080
Resource Management The resource management service, handling the clean-up and management of resources in Galasa NA
Engine controller Responsible for spinning up docker containers to execute individual Galasa automation runs NA
Metrics server Indicates the health of the ecosystem to a Prometheus server NA

The following server is not required by the ecosystem but is automatically deployed by the Docker operator to improve understanding about how the ecosystem works and to run a SimbankIVT test to verify the installation of the ecosystem:

Name Description Port
SimPlatform Provides an instance of SimBank so that IVTs and demonstration pipelines can be run 2023, 2027, 2080, 2040

To use SimPlatform, you need to have access to Maven Central. Chat to us on our Galasa Slack workspace if you need help with this.

Installing the Galasa ecosystem on the Docker engine

The ecosystem needs to know the hostname or IP address of the VM on which the Docker engine is running. Due to the way Docker works, you cannot use localhost or - you must use the actual VM hostname or IP address. This information is provided in a config.yaml file.

  1. Copy the following YAML to create a config.yaml file on your VM, making a note of the full path of the file:
version: 0.24.0
  controllerVersion: 0.24.0
  engineVersion: 0.24.0
  version: 0.15.0

Note the two-spaced indentation on some of the lines - they are important in YAML.

If you opened any ports, check that the port numbers are correct in the config.yaml file.

  1. Deploy the Galasa ecosystem by running the following Docker command on the VM:
docker run -it -v \
/var/run/docker.sock:/var/run/docker.sock \
-v ${path}/config.yaml:/config.yaml \

where {path} is the full pathname to the directory containing your config.yaml file.

This command brings up the microservices that are required to run a Galasa ecosystem. When the command completes, nine docker containers should be running. The command might take a little time to complete.

  1. View the active containers by running the docker ps command.

The Galasa ecosystem is now successfully installed on the VM.

Connecting to the Galasa ecosystem

The bootstrap contains the information that Galasa needs to bring up a framework in the Eclipse environment to connect to the ecosystem. From your IDE, edit the bootstrap to reconfigure Galasa to point to the Galasa ecosystem that you created.

In Eclipse, you can edit the bootstrap by completing the following steps:

  1. Select Eclipse > Preferences > Galasa
  2. Update Bootstrap URI to point to http://{hostname}:8080/bootstrap
  3. Apply and close the preferences

Verifying the installation

You can verify the ecosystem installation by using the Galasa command line interface (Galasa CLI) to run the runs prepare and runs submit commands. To find out more about the Galasa CLI, see Using the Galasa CLI.

Alternatively, you can submit automation tests from within Eclipse; select the Galasa > Submit tests to automation option from the Eclipse menu to choose the runs that you want to submit.

Next steps

Now that the ecosystem is successfully created on the VM, anyone with access to that VM can run tests that use the centralized configuration settings and can view the test logs and results. Tests can be run headlessly, without the need to keep individual workstations active.