Skip to content

localghost/docksible

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

docksible

Build docker images with ansible.

🌵 First release available for downloading in releases.

What is docksible?

docksible is a utility tool that helps you build docker images provisioned with ansible's playbooks.

Why docksible?

There are other ways to provision docker containers with ansible, like simply using ansible-playbook with ansible_connection set to docker or using ansible-container. However, at least for me, neither of the available solutions was convenient enough to use. They either required some extra glue code or flooded my machine with multiple dependencies. While what I wanted was to have a single binary through which I could provision my containers using exactly the same playbooks I use for VMs or bare metal hosts. And so docksible was born.

Ahh, and I also wanted to learn Go.

Requirements

The only requirements for docksible are: docksible binary, docker engine and a playbook to run.

How to use it

Assuming you have following structure of ansible's scripts:

ansible/
  - playbook.yml
  - roles/*

you enter ansible directory and you run:

docksible --tag my_image centos:7.3.1611 playbook.yml

And soon you have image my_image based on CentOS 7.3 ready waiting for you in your docker engine. See here for full reference and more examples.

Build Status