Documentation

Installing

This topic provides instructions on installing Mazer CLI.

Latest Stable Release

The latest stable release is available on PyPi, and can be installed with pip, as shown below:

$ pip install mazer

Running from Source

The source code for mazer lives at https://github.com/ansible/mazer, and you can run the latest, bleeding edge code by cloning the repo, and running setup.py, as shown below:

$ git clone https://github.com/ansible/mazer.git
$ cd mazer
$ python setup.py install

You can also use pip to install directly from the GitHub repo, as shown in the following example:

pip install -v git+ssh://git@github.com/ansible/mazer.git

Installing the companion branch of ansible

The source code for the branch of ansible that supports mazer lives at https://github.com/ansible/mazer, and you can run the latest, bleeding edge code by cloning the repo, and running setup.py, as shown below:

$ git clone -b mazer_role_loader https://github.com/ansible/ansible.git
$ cd ansible
$ python setup.py install

You can also use pip to install directly from the GitHub repo, as shown in the following example:

pip install -e  git+ssh://git@github.com/ansible/ansible.git@mazer_role_loader#egg=ansible

Verifying installed version of ansible supports mazer content

The versions of ansible that support mazer content have a config option for setting the content path. If the install ansible has this config option, mazer content will work.

To verify that, run the command ansible-config list | grep DEFAULT_CONTENT_PATH. If ‘DEFAULT_CONFIG_PATH’ is found the correct branch of ansible is installed.

$ ansible-config list | grep DEFAULT_CONTENT_PATH
DEFAULT_CONTENT_PATH: