ANSIBLE.SHELL(3)                ANSIBLE MODULES               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; stdout goes to the specified
       # file on the remote
       - shell: somescript.sh >> somelog.txt



AUTHOR
       Michael DeHaan

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



1.4.5                             2014-02-12                  ANSIBLE.SHELL(3)
