Testrunner

Testrunner is a binary and docker container for running common tests without requiring to write code. It's a simple and fast way to add functional testing to an application, as its test spec is defined in a yaml file.

Testrunner also has useful integrations with GCP Deployment Manager and Kubernetes applications.

Development

Preprequisites

This repository uses bazel to build the binary and container. It also supports cloudbuild to build and publish your container on GCP from source.

The repository is also compatible with go tool. You'll need to install dependencies separately as they are not vendored.

Generate BUILD files

bazel run //:gazelle

Build locally

Run tests

bazel test //...

Binary

Build and run the binary:

bazel run //runner:main -- -logtostderr --test_spec=$PWD/examples/testspecs/http.yaml

Container

To build and run the docker container:

# Build container
docker build --tag=testrunner .

# Run the installed container, mounting the test definition
# files as a volume.
docker run --rm \
  -v=$PWD/examples:/examples \
  testrunner -logtostderr --test_spec=/examples/testspecs/http.yaml