• Stars
    star
    135
  • Rank 269,297 (Top 6 %)
  • Language
    Python
  • License
    Apache License 2.0
  • Created over 10 years ago
  • Updated over 8 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Manager to install, uninstall, update roles from Ansible Galaxy & git repositories.
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