forerunner

README

ForeRunner

Forerunner is a Golang application to allow for automated CI/CD manor of testing of Docker images.

Requirements

iCurrently, in order to build Forerunner you will need:

• Golang v1.8+

To run ForeRunner, you will need:

• Docker install
  • Docker daemon running
• Golang v1.8+
  • If you are running this via the source code

Usage

In order to use the forerunner application, you will need to do the following:

forerunner --path path/to/config.yaml image [images...]

With forerunner, it is possuible to test mutliple images consecutively but does require that they each use the same forerunner config.

The yaml file looks like this:

---
# Non Optional Arguements
Commands:
    - cmd1
    - cmd2
    - cmd3
# Optional configs
Network: <bridge|host|none|custom>
Environemnt:
    - <var>=<value>
    - ...

In the config, the commands are the shell script you wish to run on the host container to ensure that the container is configured correctly. This means you could run your automation tests against it.