Ansible Container empowers you to orchestrate, build, run, and ship Docker images built from Ansible playbooks.
[![Build Status](https://travis-ci.org/ansible/ansible-container.svg?branch=develop)](https://travis-ci.org/ansible/ansible-container) [![Code Coverage](https://codecov.io/gh/ansible/ansible-container/coverage.svg)](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:
Creates a directory ansible with files to get you started. Read the comments, and edit to suit your needs.
Downloads Ansible-Container-ready roles from [Ansible Galaxy](https://galaxy.ansible.com), and installs them in your project.
Creates images from your Ansible playbooks.
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.
Pushes the project’s container images to a registry of your choice.
Generates a playbook and role capable of deploying the project on a supported cloud provider.
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).
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.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size ansible-container-0.3.0.tar.gz (58.5 kB)||File type Source||Python version None||Upload date||Hashes View|