ansible-role-manager

A tool for installing and managing Ansible roles, playbooks & modules.


License
Other
Install
pip install ansible-role-manager==0.3.0

Documentation

Project page and docs:
http://mirskytech.github.io/ansible-role-manager
Development:
https://github.com/mirskytech/ansible-role-manager
Feature & issue tracking:
https://github.com/mirskytech/ansible-role-manager/issues
Package Index:
https://pypi.python.org/pypi/ansible-role-manager

Description

Provides the following utilities:

  • init Creates the Ansible recommended folder structure and initial core files for playbooks, roles and modules.
  • install Installs Ansible roles from Ansible Galaxy or located in any version control repository (git, mercurial and svn).
  • uninstall Remove dependencies from the playbook's library
  • freeze Create list of installed dependencies for a playbook

see arm help for all availble commands.

Installation of Ansible Role Manager (ARM)

Standard installation:

>> pip install ansible-role-manager

or installation for development:

>> pip install -e git+https://github.com/mirskytech/ansible-role-manager.git#egg=role-manager

or manual installation:

>> git clone https://github.com/mirskytech/ansible-role-manager.git
>> python setup.py install

Get Started

Create a well-structured playbooks (directory structure, initial files):

>> arm init -p MyNewPlaybook

Install a role from Ansible Galaxy:

>> arm install github_owner.github_repo

Install a role from an arbitrary git repository and name it locally as myrolename:

>> arm install git+ssh://github.com/github_owner/github_repo.git

or install with changing the locally installed name to myrolename:

>> arm install git+ssh://github.com/github_owner/github_repo.git#alias=myrolename

Dependencies

  • mercurial
  • git
  • python
    • ansible
    • requests
    • gitpython (0.3.2.RC1)
    • colorama
    • hgapi

References

Release Notes & Roadmap

http://mirskytech.github.io/ansible-role-manager/releasenotes.html