#86889·ansible

Deprecate ansible-pull CLI

Author: sivelCreated Apr 23, 2026Updated Sep 11, 2026
Labelshas_prfeature

Summary

We've discussed and agreed within the core team to deprecate the ansible-pull CLI.

This CLI attempts to meet everyones needs and workflows. In doing so it has become overly complicated and comes with more caveats than it should.

Ultimately, the tool is extremely unnecessary, and users would be far better served with a few line shell script, or playbook. At the lowest level, ansible-pull is just calling ansible with -m git and then calling ansible-playbook. It does so in over 400 lines, a lot of which is complex argument parsing, and argument mapping.

I've put together some examples that are still varying levels of complexity that users can crib off of, that meet their needs much more succinctly. These examples can currently be found at https://github.com/sivel/ansible-pull

As part of this deprecation work, we should invest some time into documentation to explain and maybe give examples of the alternative workflows to using ansible-pull.

Issue Type

Feature Idea

Component Name

lib/ansible/cli/pull.py

Additional Information

Code of Conduct

  • I agree to follow the Ansible Code of Conduct