daml/BAZEL-oracle.md

25 lines
1.1 KiB
Markdown
Raw Normal View History

# Running tests against an Oracle database
Certain integration tests use Oracle as a DBMS for certain components (e.g. the JSON API).
These tests are executed separately on CI and you can see an up-to-date list of them in the [CI configuration](./ci/build.yml).
In order to execute them locally, the repository has a couple of conveniences:
- `dev-env` automatically sets up the environment variables
- `ORACLE_USERNAME` to `system`
- `ORACLE_PWD` to `hunter2`
- `ORACLE_PORT` to `1521`
- `bazel.rc` includes the `oracle` configuration key that leverages the environment variables mentioned above
This means that _once you have an Oracle database running locally with the proper credentials and using the proper port_, you can
run tests that require Oracle as in the following example:
bazel test --config=oracle //ledger-service/http-json-oracle/...
## Running an Oracle database locally
_If_ you have the necessary authorization, you can use the same process followed on CI to run Oracle.
Find the Oracle test job on the [CI configuration](./ci/build.yml) and run the commands that pull and run the Oracle database Docker image.