ANSIBLE.SHELL(3)

NAME
shell - Execute commands in nodes.

DESCRIPTION

The shell module takes the command name followed by a list of arguments, space delimited. It is almost exactly like the command module but runs the command through a shell (/bin/sh) on the remote node.

OPTIONS

(free
    The command module takes a free form command to run

chdir
    cd into this directory before running the command(Added in Ansible version 0.6.)

creates
    a filename, when it already exists, this step will NOT be run

executable
    change the shell used to execute the command. Should be an absolute path to the executable.(Added in Ansible version 0.9.)

NOTES

If you want to execute a command securely and predictably, it may be better to use the command module instead. Best practices when writing playbooks will follow the trend of using command unless shell is explicitly required. When running ad-hoc commands, use your best judgement.

EXAMPLES

Execute the command in remote shell
shell: somescript.sh >> somelog.txt
None

AUTHOR
Michael DeHaan

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#shell