Skip to content
This repository has been archived by the owner on Jul 5, 2020. It is now read-only.
/ ansible_customer Public archive

Python module to manage an Ansible project, linked to Infopen cookiecutter-ansible-customer template

License

Notifications You must be signed in to change notification settings

infOpen/ansible_customer

Repository files navigation

Ansible customer

Documentation Status Updates Python 3 Codecov master Codecov develop Codacy master Codacy develop

Python module to manage an Ansible project, linked to Infopen Ansible customer cookiecutter template.

It expose some cli to manage an Ansible project, with settings for each environment.

We use Invoke tasks, linked to their cli to run commands inside contexts.

Testing

You must have Docker >= 1.13.0 installed to run the tests. We use it to check Ansible commands

To run tests locally, just run needed environments using tox:

$ TOXENV=py27-ansible23 tox

You can enable Paramiko debug if you have an error on Docker fixture create (ex: Exception: Timeout reached while waiting on service!)

$ PARAMIKO_DEBUG=1 TOXENV=py27-ansible23 tox

Features

Ansible cli wrapper

Entry point: aci-ansible

This is the wrapper over the ansible command.

Ping

aci-ansible ping my_hosts [--limit=foo]

Simple task to run ping module over an host list.

Setup

aci-ansible setup my_hosts [--limit=foo]

Simple task to run setup module over an host list.

Ansible-playbook cli wrapper

Entry point: aci-ansible-playbook

This is the wrapper over the ansible-playbook command.

List-tags

aci-ansible-playbook list_tags my_playbook

Simple task to list tags managed by a playbook.

List-tasks

aci-ansible-playbook list_tasks my_playbook

Simple task to list tasks managed by a playbook.

Run

aci-ansible-playbook run my_playbook [--limit=foo]

Simple task to run a playbook.

Ansible-galaxy cli wrapper

Entry point: aci-ansible-galaxy

This is the wrapper over the ansible-galaxy command.

Install

aci-ansible-galaxy install requirement_file [-f]

Simple task to install roles managed by the requirement file.

List-roles

aci-ansible-galaxy list_roles [--role-name=my_role]

Simple task to list role(s) installed.

Remove

aci-ansible-galaxy remove my_role1[,my_role2,...]

Simple task to remove role(s).

Molecule cli wrapper

Entry point: aci-molecule

This is the wrapper over the molecule command.

Create

aci-molecule create scenario_name [--driver=docker]

Simple task to start test instances.

Converge

aci-molecule converge scenario_name

Simple task to configure test instances.

Dependency

aci-molecule dependency scenario_name

Simple task to download dependencies required by scenario.

Destroy

aci-molecule destroy scenario_name [--driver=docker]

Simple task to destroy test instances.

List

aci-molecule list scenario_name [--output=simple]

Simple task to list test instances status.

Login

aci-molecule login scenario_name host

Simple task to login into test instance.

Test

aci-molecule test scenario_name [--driver=docker]

Simple task to run tests against instances and destroy them.

Verify

aci-molecule verify scenario_name

Simple task to run automated tests against instances.

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

About

Python module to manage an Ansible project, linked to Infopen cookiecutter-ansible-customer template

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published