1.9 KiB
Developing
Prerequisites
You need to ensure you have the following tools installed:
- Docker
- Go - only needed for running the tests
- Glide
- dep (official Go dependency management tool)
- make
For running the Kubernetes tests, a Kubernetes environment is needed, for example Minikube or IBM Cloud Private.
Running the tests
There are three main sets of tests:
- Unit tests
- Docker tests, which test a complete Docker image, using the Docker API
- Kubernetes tests, which test the Helm charts (and the Docker image) via Helm
Running the tests
The unit and Docker tests can be run locally. For example:
make test-devserver
or:
make test-advancedserver
Running the tests with code coverage
You can produce code coverage results from the Docker tests by running the following:
make build-advancedserver-cover
make test-advancedserver-cover
In order to generate code coverage metrics from the Docker tests, the build step creates a new Docker image with an instrumented version of the code. Each test is then run individually, producing a coverage report each under test/docker/coverage/. These individual reports are then combined. The combined report is written to the coverage directory.
Running the Kubernetes tests
For the Kubernetes tests, you need to have built the Docker image, and pushed it to the registry used by your Kubernetes cluster. Most of the configuration used by the tests is picked up from your kubectl configuration, but you will typically need to specify the image details. For example:
DOCKER_REPO_DEVSERVER=mycluster.icp:8500/default/mq-devserver make test-kubernetes-devserver