Deprecated

The ansible-container project is now officially deprecated. We will no longer be maintaining this repo or accepting any issues or pull requests.

The ansible-container project did two things, broadly speaking: it built containers, and it deployed containers to Kubernetes. Now there are new successor projects that perform these tasks.

For people who have been using ansible-container to build containers, we recommend using the ansible-bender project: https://github.com/ansible-community/ansible-bender

For people who have been using ansible-container to deploy containers to Kubernetes, we recommend using Ansible Operators:

https://learn.openshift.com/ansibleop/ansible-operator-overview/

Thanks to all those who have used and contributed to ansible-container.

Original README below

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.

Installing

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

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.