diff --git a/README.md b/README.md index 12198e551d125ed381404f45e330d48731cd7e12..efc57cf994a8276a3a156b0fc3486af107bd97db 100644 --- a/README.md +++ b/README.md @@ -112,3 +112,16 @@ This is the procedure for that. See the integration instructions in the [astronauth repo](https://git.astron.nl/astron-sdc/astronauth) +### Running tests + +To run tests, you can spin up a dedicated test database locally using the the provided `docker-compose-ci.yml` file. This test database will not interfere with your local development database. For example, you can run this command from the `atdb/docker` folder: + +` docker compose -f .\docker-compose-ci.yml up -d` + +After spinning up the database, you can execute the tests with the following command: + +`python manage.py test --settings atdb.settings.ci` + +Dedicated settings for running the tests are provided in the `atdb/settings/ci.dev` file. For convenience, `test.bat` is provided to run the above command (Windows only). + +Finally, these tests are also executed in the CI pipeline through the test stage in the `.gitlab-ci.yml` file. \ No newline at end of file