2012-07-14 17:59:12 +02:00
|
|
|
# this is a virtual module that is entirely implemented server side
|
2012-09-17 15:11:04 +02:00
|
|
|
|
|
|
|
|
DOCUMENTATION = '''
|
|
|
|
|
---
|
|
|
|
|
module: raw
|
|
|
|
|
short_description: Executes a low-down and dirty SSH command, not going through the module subsystem.
|
|
|
|
|
description: >
|
|
|
|
|
Executes a low-down and dirty SSH command, not going through the module
|
|
|
|
|
subsystem. This is useful and should only be done in two cases. The first
|
|
|
|
|
case is installing python-simplejson on older (python 2.4 and before)
|
|
|
|
|
hosts that need it as a dependency to run modules, since nearly all core
|
|
|
|
|
modules require it. 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 and only output
|
|
|
|
|
is returned. There is no error detection or change handler support for
|
|
|
|
|
this module
|
|
|
|
|
examples:
|
|
|
|
|
- code: ansible newhost.example.com -m raw -a "yum -y install python-simplejson"
|
|
|
|
|
description: Example from /usr/bin/ansible to bootstrap a legacy python 2.4 host
|
|
|
|
|
'''
|
