Opinionated wrapper around docker
Project description
An opinionated wrapper around the docker-py API that lets you use YAML to define images and run tasks.
See http://harpoon.readthedocs.io for the full documentation.
Installation
Just use pip:
$ pip install docker-harpoon
Configuration
Before Harpoon can be used, it must be configured. Configuration is obtained from the following locations in the following order of precedence:
Provided –harpoon-config value
HARPOON_CONFIG environment variable
./harpoon.yml
Further, you can also define user-wide settings in your home directory at ~/.harpoonrc.yml. For example if you want the “dark” theme for the logging:
---
term_colors: dark
The contents of the harpoon config has only one mandatory option, images. This must be a dictionary of image_alias to image_options:
---
images:
cacafire:
commands:
- FROM ubuntu:14.04
- RUN apt-get update && apt-get -y install caca-utils
- CMD cacafire
A rough overview of all the options available can be found at http://harpoon.readthedocs.org/en/latest/docs/configuration.html
Usage
Once harpoon is installed, there will be a new program called harpoon.
When you call harpoon without any arguments it will print out the tasks you have available.
Unless you don’t have a config file, in which case it’ll complain you have no configuration file.
Once you have a valid configuration file and have chosen a task you wish to invoke, you may use the --task cli option to invoke that task:
$ harpoon --task <task>
Most tasks will also require you to specify an image to work with:
$ harpoon --task <task> --image <image_alias>
Simpler Usage
To save typing --task and --image too much, the first positional argument is treated as task (unless it is prefixed with a dash) and the second positional argument (if also not prefixed with a dash) is taken as the image.
So:
$ harpoon --task run --image my_amazing_image
Is equivalent to:
$ harpoon run my_amazing_image
Changelog
https://harpoon.readthedocs.io/en/latest/docs/changelog.html
Tests
Run:
> ./test.sh
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for docker_harpoon-0.18.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 576ac51df9046f1e02bc70657afc72addbfeb5ce7417139b83c23f0ceee1810c |
|
MD5 | d43e810167ed7b07e079c4f5fbbc7396 |
|
BLAKE2b-256 | 2750aa20949111de9fb3bde5d7d2b623b22e8a4ba84e1d71d80f7efa77559c4f |