Improve doc about ANSIBLE_ARGS usage in molecule cli #1078
Description
Issue Type
- Feature request
Molecule and Ansible details
➜ ~ ansible --version
ansible 2.4.2.0
config file = /etc/ansible/ansible.cfg
configured module search path = [u'/home/remy/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
ansible python module location = /usr/local/lib/python2.7/dist-packages/ansible
executable location = /usr/local/bin/ansible
python version = 2.7.12 (default, Nov 20 2017, 18:23:56) [GCC 5.4.0 20160609]
➜ ~ molecule --version
molecule, version 2.5.0
- Molecule installation method: pip
- Ansible installation method: pip
Desired Behaviour
I just wanted to converge on a specific platforms. Reading the inline help gives
➜ ~ molecule converge --help
Usage: molecule converge [OPTIONS] [ANSIBLE_ARGS]...
Use the provisioner to configure instances (dependency, create, prepare
converge).
Options:
-s, --scenario-name TEXT Name of the scenario to target. (default)
--help Show this message and exit.
How to use ANSIBLE_ARGS is unclear, you need a double dash to separate options from args there
➜ rgarrigue.docker git:(master) molecule converge --limit molecule-docker-centos7
Error: no such option: --limit
➜ rgarrigue.docker git:(master) molecule converge -- -l molecule-docker-centos7
--> Test matrix
└── default
├── dependency
├── create
├── prepare
└── converge
I figured it out knowing about this kind of stuff, but fixing the doc would be nice :-)