Ansible Container is a tool to build Docker images and orchestrate containers using only Ansible playbooks.
Python Other
Clone or download
Voronenko Merge pull request #959 from tzok/develop
Lock ruamel.yaml version to [0.15.34; 0.15.51]. Fixes #958
Latest commit bdd8bc4 Aug 14, 2018
Failed to load latest commit information.
.github Removes main.yml May 2, 2017
container fix(tests) https validation in older python Jul 14, 2018
docs Hello world. Jan 29, 2018
proposals Add proposal for Multiple Containers per Pod (#639) Aug 14, 2017
test improve(tests) fixed container names Jun 5, 2018
.coveragerc Add unit and integration tests and run on Travis. Jun 20, 2016
.gitignore Fixed sdist issues with conductor build files Apr 18, 2017
.mailmap Add Ryan Brown -> Ryan S. Brown to mailmap Feb 22, 2017
.travis.yml chore(travis) fixed typo ubuntu:beaver->bionic Jun 14, 2018
AUTHORS Provide variable manager and loader to cache inspector Jan 25, 2018
CHANGELOG.rst Fixes typo Sep 13, 2017 Fix link syntax in Aug 30, 2017 Create Jun 17, 2016
LICENSE Release prep stuff May 16, 2016 Add JSONSchema document to manifest Dec 19, 2017
Makefile Add *develop* command and update *test* command in Makefile. Add *--f… Aug 15, 2016 Update Jul 28, 2018
ROADMAP.rst Updating roadmap with 0.9.3 Nov 11, 2017 Attempted fix from travis-ci#4704 Dec 18, 2017 Adds changelog (#699) Aug 15, 2017
codecov.yml Add unit and integration tests and run on Travis. Jun 20, 2016
conductor-requirements.txt Lock ruamel.yaml version to [0.15.34; 0.15.51] Aug 13, 2018
conductor-requirements.yml Pr/414 (#419) Apr 10, 2017
pre-commit Add pre-commit script and update AUTHORS Sep 26, 2016
release.yml Update release script. Sep 8, 2017
requirements.txt Lock ruamel.yaml version to [0.15.34; 0.15.51] Aug 13, 2018 improve(regression) syncronizing to pip changes Jun 5, 2018
tox.ini CI: execute the test suite using Python 3.4 and Python 3.5 (#300) Nov 16, 2016 Py3 cleanup Mar 26, 2017

Build Status Code Coverage

Ansible Container

Ansible Container is a tool for building Docker images and orchestrating containers using Ansible playbooks.

How it works

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

  • ansible-container init

    Creates files in the current directory 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 deploy

    Pushes the project's container images to a registry of your choice, and generates a playbook capable of deploying the project on a supported cloud provider.


Install using pip, the Python package manager:

$ sudo pip install "ansible-container[docker,openshift]"

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[docker,openshift]"

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

Getting started

For examples and a quick tour of Ansible Container visit Getting Started at our docs site.

Visit the Ansible Container Demo for a complete walk-through of managing an application from development through cloud deployment.

Get Involved

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


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

Ansible Container is an Ansible by Red Hat sponsored project.