ansible

1 Ansible 1.2 System administration commands

ansible-pull

set up a remote copy of ansible on each managed node

ansible -d DEST -U URL [ -C CHECKOUT ] [ -i INVENTORY ] [ <filename.yml> ]

## DESCRIPTION

Ansible is an extra-simple tool/framework/API for doing 'remote things' over SSH.

Use ansible-pull to set up a remote copy of ansible on each managed node, each set to run via cron and update playbook source via git. This inverts the default push architecture of ansible into a pull architecture, which has near-limitless scaling potential.

The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible-pull.

This is useful both for extreme scale-out as well as periodic remediation. Usage of the fetch module to retrieve logs from ansible-pull runs would be an excellent way to gather and analyze remote logs from ansible-pull.

## OPTIONAL ARGUMENT

filename.yml

- The name of one the YAML format files to run as an ansible playbook. This can be a relative path within the git checkout. If not provided, ansible-pull will look for a playbook based on the host’s fully-qualified domain name and finally a playbook named local.yml.

## OPTIONS

-d DEST, --directory=DEST

- Directory to checkout git repository into.

-U URL, --url=URL

- URL of git repository to clone.

-C CHECKOUT, --checkout=CHECKOUT

- Branch/Tag/Commit to checkout. Defaults to HEAD.

-i PATH, --inventory=PATH

- The PATH to the inventory hosts file. This can be a relative path within the git checkout.

--purge

- Purge the git checkout after the playbook is run.

## AUTHOR

Ansible was originally written by Michael DeHaan. See the AUTHORS file for a complete list of contributors.

## COPYRIGHT

Copyright © 2012, Michael DeHaan

Ansible is released under the terms of the GPLv3 License.

## SEE ALSO

ansible(1), ansible-playbook(1), ansible-doc(1)

Extensive documentation as well as IRC and mailing list info is available on the ansible home page: https://ansible.github.com/