Documentation

Installation

Getting Ansible Container

Prerequisites:

Then simply:

$ sudo pip install ansible-container

If you do not have root privileges, you’ll need to use a virtualenv to create a Python sandbox:

$ virtualenv ansible-container
$ source ansible-container/bin/activate
$ pip install ansible-container

You’ll need to run the activate script in each shell session prior to invoking ansible-container. See the virtualenv docs for details.

Running from Source

If you’d like to run the bleeding edge version of Ansible Container, you can obtain it from our Github repository.

Prerequisites:

Clone the repo:

$ git clone https://github.com/ansible/ansible-container.git

We recommend that you use a Python Virtualenv to sandbox your installation. See the virtualenv docs for instructions.

If you just want to run ansible-container:

$ cd ansible-container
$ python ./setup.py install

Or, if you plan to help develop ansible-container:

$ cd ansible-container
$ python ./setup.py develop

If you run into the following error, you likely have an older version of setuptools installed:

Traceback (most recent call last):
  File "./setup.py", line 11, in <module>
    packages=find_packages(include='container.*'),
  TypeError: find_packages() got an unexpected keyword argument 'include'

Use the following to upgrade to the latest release, and then run the install command again:

$ pip install --upgrade setuptools

You may need to run the above command with sudo if you’re not using a virtualenv.