Skip to main content

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

Project description

[![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:

  • 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

## 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansible-container-0.3.0.tar.gz (58.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page