Skip to content
This repository has been archived by the owner on Mar 23, 2019. It is now read-only.
/ ansible-container Public archive

DEPRECATED -- Ansible Container was a tool to build Docker images and orchestrate containers using only Ansible playbooks.


Notifications You must be signed in to change notification settings


Repository files navigation


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:

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

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.


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.


DEPRECATED -- Ansible Container was a tool to build Docker images and orchestrate containers using only Ansible playbooks.







No packages published