table of contents
other versions
- jessie 1.7.2+dfsg-2
- jessie-backports 2.2.1.0-2~bpo8+1
- stretch 2.2.1.0-2
- testing 2.7.7+dfsg-1
- stretch-backports 2.7.5+dfsg-1~bpo9+1
- unstable 2.7.8+dfsg-1
ANSIBLE(1) | System administration commands | ANSIBLE(1) |
NAME¶
ansible-pull - set up a remote copy of ansible on each managed nodeSYNOPSIS¶
ansible -d DEST -U URL [options] [ <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 a source repository. 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.ymlThe name of one the YAML format files to run as an
ansible playbook. This can be a relative path within the checkout. If not
provided, ansible-pull will look for a playbook based on the host’s
fully-qualified domain name, on the host hostname and finally a playbook named
local.yml.
OPTIONS¶
-d DEST, --directory=DESTDirectory to checkout repository into. If not provided, a
subdirectory of ~/.ansible/pull/ will be used.
-U URL, --url=URL
URL of the playbook repository to checkout.
-C CHECKOUT, --checkout=CHECKOUT
Branch/Tag/Commit to checkout. If not provided, uses
default behavior of module used to check out playbook repository.
-f, --force
Force running of playbook even if unable to update
playbook repository. This can be useful, for example, to enforce run-time
state when a network connection may not always be up or possible.
-i PATH, --inventory=PATH
The PATH to the inventory hosts file. This can be
a relative path within the checkout.
--purge
Purge the checkout after the playbook is run.
-m NAME, --module-name=NAME
Module used to checkout playbook repository. Defaults to
git.
-o, --only-if-changed
Run the playbook only if the repository has changed
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 is available in the documentation site: http://docs.ansible.com. IRC and mailing list info can be found in file CONTRIBUTING.md, available in: https://github.com/ansible/ansibleAUTHOR¶
:doctype:manpageAuthor.
05/26/2014 | Ansible 1.7 |