forklift

Listener for Docker Hub webhooks.

Installation

pip install -r requirements.txt

python forklift.py

Configuration

• Copy example.config to forklift.config
• Set a secure api_key
• Set docker_root to the directory that the target script is run relative to.
• Setup valid_containers
  • Top level key is {repository name}/{image_name}.
  • tag allows only the specified tag to trigger the target script. This is interpreted as a regular expression.
  • target is a path relative to docker_root to the script to run.
• Create a Docker Hub webhook that calls https://your_host/hook?apikey={your_apikey}

Development

pip install -r requirements_dev.txt

Design Notes

The shell command used to restart a container should use only strings from the program configuration, and must not contain any fragments sourced from the request data.

Running Tests

pytest