ansible-pull

Pull and run playbook from git

$ ansible-pull -U [https://github.com/user/repo.git]

$ ansible-pull -U [repo_url] [playbook.yml]

$ ansible-pull -U [repo_url] -C [branch_name]

$ ansible-pull -U [repo_url] -i [localhost,]

$ ansible-pull -U [repo_url] -o --sleep [60]

ansible-pull -U repourl [-C branch] [-d dest] [playbook.yml_]

ansible-pull inverts the normal Ansible push model by having nodes pull configuration from a central repository. Nodes periodically fetch a git repository containing playbooks and run them locally.
This is useful for scaling to many nodes, bootstrap scenarios, or environments where nodes initiate their own configuration.

-U url, --url url

Git repository URL

Branch, tag, or commit to checkout

Local directory for repository

Inventory (often "localhost,")

Only run playbook if repo changed

Random sleep before running (for staggering)

Delete local repo before cloning

Force run even if checkout fails

Full clone instead of shallow

Accept SSH host key

/etc/ansible/ansible.cfg

System-wide Ansible configuration on the target node.

Per-user Ansible configuration overriding system defaults.

Project-level configuration in the current directory, highest priority.

Requires git and ansible on the target node. Credentials for private repos need configuration. Failure leaves node in potentially inconsistent state.

ansible-pull was introduced to support pull-based configuration management, addressing scalability concerns with the traditional push model.

ansible-playbook(1), ansible(1), git(1)