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)](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 to build Docker images and orchestrate containers using only Ansible playbooks.

## How it works

Use Ansible Container to manage 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 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 images to a container registry of your choice.

  • ansible-container shipit

    Generates the necessary playbook and role to deploy your containers 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 tour of Ansible Container [visit our docs site](https://docs.ansible.com/ansible-container/).

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

Files for ansible-container, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size ansible-container-0.2.0.tar.gz (53.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page