gimoh/devops-utils repository overview

⁠devops-utils

Docker image containing a set of utilities handy in a devops style environment.

Full documentation can be found on RTFD⁠.

⁠Features

• built in utilities:
  • Ansible⁠
  • Fabric⁠
  • docker⁠
  • docker-compose⁠
  • docker-machine⁠
  • IPython⁠, ptpython⁠ and konch⁠
• external runner which wraps docker run to make it look like the utilities are installed on the host
• extensible startup process allowing derived images to customise options and the runtime environment

⁠Installation

The image can be run directly, but also contains an external runner program that wraps the docker run invocation to expose the utilities directly. Running the image with install parameter and a host directory mounted on /target will install the runner and appropriate links:

docker run -v $HOME/.local/bin:/target --rm gimoh/devops-utils install

Replace $HOME/.local/bin with a directory where you want to place the runner.

See docs⁠ for more details.

⁠Usage

First usage scenario is when you build a derived image containing your source (e.g. Ansible playbooks, etc.). An example Dockerfile:

FROM gimoh/devops-utils

ADD . /opt/app
WORKDIR /opt/app

The second usage scenario is when you want to use your development tree as source. This may be done with either the original or derived image:

devops-utils ++dev ansible-playbook -i hosts.ini your-playbook.yml
# or
ansible-playbook ++dev -i hosts.ini your-playbook.yml

Check all available runner options with:

devops-utils ++help

When using a derived image, the options, environment and startup process can be customised.

See docs⁠ for more details.