...
In order to run the unit tests locally, you need to run an instance of MariaDB and an instance of the emulator for the REST endpoints CLAMP uses. You also need to set the values some variables in a number of configuration files. These values are automatically generated in the maven build but need to be set manually when running tests locally.
Info |
---|
If you follow the steps here, all the tests will pass in a Linux environment. In Windows and Mac environments, the Robot test case will not pass because Host Networking is not supported in Docker on WIndows and Mac. The robot test framework cannot reach "localhost" endpoints on the host machine. |
Open a console and go into the directory extra/bin-for-dev
Code Block language bash cd extra/bin-for-dev
Start an instance of the CLAMP MaraDB database in Docker using the helper script. This script uses docker-compose to bring up an instance of the CLAMP MariaDB.
Code Block language bash ./start-db.sh
Start an instance of the CLAMP endpoint emulator in Docker using the helper script. This script uses docker-compose to bring up an instance of the CLAMP endpoint emulator.
Code Block language bash ./start-emulator.sh
Check that the database and emulator are running
Code Block language bash docker ps
You should see the two images running
Code Block language bash CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 93cffd7e7d2e python:2-slim "/bin/sh -c 'pip ins…" 7 seconds ago Up 7 seconds 0.0.0.0:8085->8085/tcp clamp_third-party-proxy_1 0b26d68f4048 mariadb:10.5.4 "docker-entrypoint.s…" About a minute ago Up About a minute 0.0.0.0:3306->3306/tcp clamp_db_1
- In the file src/test/resources/application.properties:
- Change all occurrences of the string "${clamp.it.tests.http}" to "8080"
- Change all occurrences of the string "${docker.http-cache.port.host}" to "8085"
- Change all occurrences of the string "${docker.mariadb.port.host}" to "3306"
- In the file src/test/resources/https/https-test.properties:
- In the file src/test/resources/robotframework/robotframework-test.properties:
- Change all occurrences of the string "${clamp.it.tests.robotframework.http}" to "8080" (Any free port value)
- Change all occurrences of the string "${docker.http-cache.port.host}" to "8085"
- Change all occurrences of the string "${docker.mariadb.port.host}" to "3306"