python
on a system without python installed by default. Another is speaking to any devices such as routers that do not have any Python installed. In any other case, using the shell or command module is much more appropriate. Arguments given to raw
are run directly through the configured remote shell. Standard output, error output and return code are returned when available. There is no change handler support for this module.Parameter | Choices/Defaults | Comments |
---|---|---|
executable | change the shell used to execute the command. Should be an absolute path to the executable. when using privilege escalation ( become ), a default shell will be assigned if one is not provided as privilege escalation requires a shell. | |
free_form required | the raw module takes a free form command to run. There is no parameter actually named 'free form'; see the examples! |
Note
gather_facts: no
if you’re using raw
to bootstrap python onto the machine.environment
keyword does not work with raw normally, it requires a shell which means it only works if executable
is set or using the module with privilege escalation (become
).- name: Bootstrap a host without python2 installed raw: dnf install -y python2 python2-dnf libselinux-python - name: Run a command that uses non-posix shell-isms (in this example /bin/sh doesn't handle redirection and wildcards together but bash does) raw: cat < /tmp/*txt args: executable: /bin/bash - name: safely use templated variables. Always use quote filter to avoid injection issues. raw: "{{package_mgr|quote}} {{pkg_flags|quote}} install {{python|quote}}"
This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.
This module is flagged as core which means that it is maintained by the Ansible Core Team. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Core Team, see here.
For more information about Red Hat’s support of this module, please refer to this Knowledge Base article
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/raw_module.html