ansible-container 0.3.0

Ansible Container empowers you to orchestrate, build, run, and ship Docker images built from Ansible playbooks.

[](https://travis-ci.org/ansible/ansible-container) [](https://codecov.io/gh/ansible/ansible-container)

# 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 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](https://galaxy.ansible.com), 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 container images to a registry of your choice.

• ansible-container shipit

  Generates a playbook and role capable of deploying the project 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](https://virtualenv.pypa.io/en/stable/) 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](https://docs.ansible.com/ansible-container/installation.html).

## Getting started

For examples and a quick tour of Ansible Container visit [Getting Started](http://docs.ansible.com/ansible-container/getting_started.html) at our docs site.

Visit the [Ansible Container Demo](https://ansible.github.io/ansible-container-demo/) for a complete walk-through of managing an application from development through cloud deployment.

## Get Involved

• Visit [Community Information and Contributing](https://docs.ansible.com/ansible-container/community/index.html) for all kinds of ways to contribute to and interact with the project. We welcome your feedback and ideas!

• Review [CONTRIBUTORS.md](./CONTRIBUTORS.md), if you’re considering submitting code.

• [Join the mailing list](https://groups.google.com/forum/#!forum/ansible-container)

• [Open an issue](https://github.com/ansible/ansible-container/issues)

• 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](https://pypi.org/project/ansible-container/).

• Submit pull requests for bug fixes and new features to develop.

• View [the roadmap](./ROADMAP.rst) for a list of features currently under development.

• Contributors welcome! Get started by reviewing [CONTRIBUTORS.md](./CONTRIBUTORS.md).

## Authors

View [AUTHORS](./AUTHORS) for a list contributors to Ansible Container. Thanks everyone!

Ansible Container is an [Ansible by Red Hat](https://ansible.com) sponsored project.