76 lines
3.1 KiB
Python
76 lines
3.1 KiB
Python
# This is a virtual module that is entirely implemented server side
|
|
|
|
# Copyright: (c) 2012, Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['stableinterface'],
|
|
'supported_by': 'core'}
|
|
|
|
|
|
DOCUMENTATION = r'''
|
|
---
|
|
module: raw
|
|
short_description: Executes a low-down and dirty SSH command
|
|
version_added: historical
|
|
options:
|
|
free_form:
|
|
description:
|
|
- The raw module takes a free form command to run. There is no parameter actually named 'free form'; see the examples!
|
|
required: true
|
|
executable:
|
|
description:
|
|
- Change the shell used to execute the command. Should be an absolute path to the executable.
|
|
- When using privilege escalation (C(become)) a default shell will be assigned if one is not provided
|
|
as privilege escalation requires a shell.
|
|
version_added: "1.0"
|
|
description:
|
|
- Executes a low-down and dirty SSH command, not going through the module
|
|
subsystem.
|
|
- This is useful and should only be done in a few cases. A common
|
|
case is installing C(python) on a system without python installed by default.
|
|
Another is speaking to any devices such as
|
|
routers that do not have any Python installed. In any other case, using
|
|
the M(shell) or M(command) module is much more appropriate.
|
|
- Arguments given to C(raw) are run directly through the configured remote shell.
|
|
- Standard output, error output and return code are returned when
|
|
available.
|
|
- There is no change handler support for this module.
|
|
- This module does not require python on the remote system, much like
|
|
the M(script) module.
|
|
- This module is also supported for Windows targets.
|
|
notes:
|
|
- "If using raw from a playbook, you may need to disable fact gathering
|
|
using C(gather_facts: no) if you're using C(raw) to bootstrap python
|
|
onto the machine."
|
|
- If you want to execute a command securely and predictably, it may be
|
|
better to use the M(command) or M(shell) modules instead.
|
|
- The C(environment) keyword does not work with raw normally, it requires a shell
|
|
which means it only works if C(executable) is set or using the module
|
|
with privilege escalation (C(become)).
|
|
- This module is also supported for Windows targets.
|
|
author:
|
|
- Ansible Core Team
|
|
- Michael DeHaan
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Bootstrap a host without python2 installed
|
|
raw: dnf install -y python2 python2-dnf libselinux-python
|
|
|
|
- name: Run a command that uses non-posix shell-isms (in this example /bin/sh doesn't handle redirection and wildcards together but bash does)
|
|
raw: cat < /tmp/*txt
|
|
args:
|
|
executable: /bin/bash
|
|
|
|
- name: Safely use templated variables. Always use quote filter to avoid injection issues.
|
|
raw: "{{ package_mgr|quote }} {{ pkg_flags|quote }} install {{ python|quote }}"
|
|
|
|
- name: List user accounts on a Windows system
|
|
raw: Get-WmiObject -Class Win32_UserAccount
|
|
'''
|