This codebase is the BDCS API server, it handles API requests for project information, recipes, and image composing.
It depends on the BDCS metadata store generated by the bdcs import
service, and can be run directly via cargo run if the system has Rust installed, or via Docker.
The server requires the nightly version of Rust (1.17 or later) which is best installed by following the instructions at https://rustup.rs, and then overriding the default compiler to use for the bdcs-api-rs project by running this in the repo directory:
rustup override set nightly
The host will need to have the following packages installed before building or running the bdcs-api-server
- openssl-devel
- sqlite-devel
- cmake
Running it directly on port 4000, using /var/tmp/recipes/ for recipe storage looks like this:
cargo run --bin bdcs-api-server -- --host 0.0.0.0 --port 4000 metadata.db /var/tmp/recipes/
This will download any required crates, build them, build bdcs-api-server and run it.
To see what command line options are available execute:
cargo run --bin bdcs-api-server -- --help
You may want to use --log to configure the path to the log file and update
/var/tmp/recipes to a directory where you have write permissions!
If you want to use the /api/mock/ service you can point it to a directory of
json mock api files by adding --mockfiles /path/to/files/
The docker image depends on a base image, named weld/fedora:25, which needs
have been previously built. If it is not available it can be built from
the welder-deployment repository by running make weld-f25.
Build the docker image by running:
sudo docker build -t weld/bdcs-api .
To run the API it requires access to a copy of the metadata.db created by the bdcs import service and to a directory of recipes. The recipes directory is initialized at runtime from the ./examples/recipes/ directory.
Create ~/tmp/mddb/ and copy metadata.db into it, and create an empty
~/tmp/recipes/ directory. You can then run the API server like this:
docker run -it --rm -v ~/tmp/mddb/:/mddb/:Z -v ~/tmp/recipes/:/bdcs-recipes/:Z -p 4000:4000 weld/bdcs-api
You can then access the UI at http://localhost:4000, try http://localhost:4000/api/v0/test to
make sure you get a response like API v0 test from the server.
If you want to use a local directory named mock-api for the /api/mock/
service you would add this to the commandline (before weld/bdcs-api):
-v ~/tmp/mock-api/:/mockfiles/:Z
The files in tests/results/v0/ are suitable to use with the /api/mock/ service.
See the documentation on the mock api for more information.
To execute the available tests:
cargo test
Use RUST_TEST_THREADS=1 to force sequential execution and debug failing tests!
General information about testing in Rust can be found at