resmo / ansible-container

Ansible Container is a tool to build Docker images and orchestrate containers using only Ansible playbooks.

Ansible Container

Ansible Container is a tool to build Docker images and orchestrate containers using only Ansible playbooks.

How it works

Use Ansible Container to manage container lifecycle from development, through testing, to production:

• ansible-container init

  Creates a directory ansible with files to get you started. Read the comments and edit to suit your needs.

• ansible-container install

  Downloads Ansible-Container-ready roles from Ansible Galaxy and installs them in your project.

• ansible-container build

  Creates images from your Ansible playbooks.

• ansible-container run

  Launches the containers specified in the orchestration document, container.yml, for testing the built images. The format of container.yml is nearly identical to Docker Compose.

• ansible-container push

  Pushes the project's images to a container registry of your choice.

• ansible-container shipit

  Generates the necessary playbook and role to deploy your containers on a supported cloud provider.

Installing

Install using pip, the Python package manager:

$ sudo pip install ansible-container

Or, to install without root privileges, use virtualenv to first create a Python sandbox:

$ virtualenv ansible-container
$ source ansible-container/bin/activate
$ pip install ansible-container

For more details, prerequisite, and instructions on installing the latest development release, please view our Installation Guide.

Getting started

For examples and a tour of Ansible Container visit our docs site.

If you just can't wait, the following provides a quick install and run of the demo app.

Assuming you already installed Ansible Container, start by creating an empty project folder, and then initialize it with a Container App from Ansible Galaxy:

$ mkdir demo
$ cd demo
$ ansible-container init chouseknecht.django-gulp-nginx

From the project directory, build the images:

$ ansible-container build

And finally, from the project directory, run the app:

$ ansible-container run

The demo web server is available at port 8080. If you're running Docker Machine, for example, you can access the site using the IP address of the Docker Machine host like so:

$ open http://$(docker-machine ip default):8080/admin

(Replace default with the name of your Docker Machine host.)

Get Involved

• Visit Community Information and Contributing for all kinds of ways to contribute to and interact with the project. We welcome your feedback and ideas!
• Review CONTRIBUTORS.md, if you're considering submitting code.
• Join the mailing list
• Open an issue
• Join the #ansible-container channel on irc.freenode.net.

Branch Information

• The develop branch is the release actively under development.
• The master branch corresponds to the latest stable release available at PyPi.
• Submit pull requests for bug fixes and new features to develop.
• View the roadmap for a list of features currently under development.
• Contributors welcome! Get started by reviewing CONTRIBUTORS.md.

Authors

View AUTHORS for a list contributors to Ansible Container. Thanks everyone!

Ansible Container is an Ansible by Red Hat sponsored project.