command - Executes a command on a remote node

Author:Michael DeHaan

Synopsis

The command module takes the command name followed by a list of space-delimited arguments. The given command will be executed on all selected nodes. It will not be processed through the shell, so variables like $HOME and operations like "<", ">", "|", and "&" will not work (use the shell module if you need these features).

Options

parameter required default choices comments
chdir no
    cd into this directory before running the command (added in Ansible 0.6)
    creates no
      a filename, when it already exists, this step will not be run.
      executable no
        change the shell used to execute the command. Should be an absolute path to the executable. (added in Ansible 0.9)
        free_form yes
          the command module takes a free form command to run
          removes no
            a filename, when it does not exist, this step will not be run. (added in Ansible 0.8)

            Examples


            # Example from Ansible Playbooks
            - command: /sbin/shutdown -t now
            
            # Run the command if the specified file does not exist
            - command: /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database
            

            Note

            If you want to run a command through the shell (say you are using <, >, |, etc), you actually want the shell module instead. The command module is much more secure as it’s not affected by the user’s environment.

            Note

            creates, removes, and chdir can be specified after the command. For instance, if you only want to run a command if a certain file does not exist, use this.

            Table Of Contents

            Previous topic

            Commands Modules

            Next topic

            raw - Executes a low-down and dirty SSH command