internet/community.general
3
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-05-07 13:52:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Break the modules docs into separate files.

Browse Source
This commit is contained in:
Tim Bielawa
2012-08-13 15:39:00 -04:00
parent 1f3e22687e
commit f28ea0cda1
32 changed files with 957 additions and 969 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
rst/modules/command.rst Normal file
View File

@@ -0,0 +1,39 @@
.. _command:
command
```````
The command module takes the command name followed by a list of
arguments, space delimited.
+--------------------+----------+---------+----------------------------------------------------------------------------+
| parameter | required | default | comments |
+====================+==========+=========+============================================================================+
| (free form) | N/A | N/A | the command module takes a free form command to run |
+--------------------+----------+---------+----------------------------------------------------------------------------+
| creates | no | | a filename, when it already exists, this step will NOT be run |
+--------------------+----------+---------+----------------------------------------------------------------------------+
| chdir | no | | cd into this directory before running the command (0.6 and later) |
+--------------------+----------+---------+----------------------------------------------------------------------------+
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. As such, all
paths to commands must be fully qualified.
.. 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.
Example action from Ansible :doc:`playbooks`::
command /sbin/shutdown -t now
creates 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, you can do the following::
command /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database
The `creates=` and `chdir` options will not be passed to the actual executable.