__ __ __ __ _____ _ _ _____ _ _ _ | \/ | \ \ / / | __ \ (_) | | / ____| | | | | | \ / |_ __\ V / | |__) | __ ___ ____ _| |_ ___ | (___ | |__ ___| | | | |\/| | '__|> < | ___/ '__| \ \ / / _` | __/ _ \ \___ \| '_ \ / _ \ | | | | | | |_ / . \ | | | | | |\ V / (_| | || __/ ____) | | | | __/ | | |_| |_|_(_)_/ \_\ |_| |_| |_| \_/ \__,_|\__\___| |_____/|_| |_|\___V 2.1 if you need WebShell for Seo everyday contact me on Telegram Telegram Address : @jackleetFor_More_Tools:
a
�)g�2 � @ s� d dl mZmZmZ eZdZdZdZd dl Z d dl
Z
d dl Z d dl Z d dl
mZ d dlmZmZmZ d dlmZ d d
� Zed kr�e� dS ) � )�absolute_import�division�print_functionaC
---
module: command
short_description: Execute commands on targets
version_added: historical
description:
- The C(command) module takes the command name followed by a list of space-delimited arguments.
- The given command will be executed on all selected nodes.
- The command(s) will not be
processed through the shell, so variables like C($HOSTNAME) and operations
like C("*"), C("<"), C(">"), C("|"), C(";") and C("&") will not work.
Use the M(ansible.builtin.shell) module if you need these features.
- To create C(command) tasks that are easier to read than the ones using space-delimited
arguments, pass parameters using the C(args) L(task keyword,https://docs.ansible.com/ansible/latest/reference_appendices/playbooks_keywords.html#task)
or use C(cmd) parameter.
- Either a free form command or C(cmd) parameter is required, see the examples.
- For Windows targets, use the M(ansible.windows.win_command) module instead.
extends_documentation_fragment:
- action_common_attributes
- action_common_attributes.raw
attributes:
check_mode:
details: while the command itself is arbitrary and cannot be subject to the check mode semantics it adds C(creates)/C(removes) options as a workaround
support: partial
diff_mode:
support: none
platform:
support: full
platforms: posix
raw:
support: full
options:
free_form:
description:
- The command module takes a free form string as a command to run.
- There is no actual parameter named 'free form'.
cmd:
type: str
description:
- The command to run.
argv:
type: list
elements: str
description:
- Passes the command as a list rather than a string.
- Use C(argv) to avoid quoting values that would otherwise be interpreted incorrectly (for example "user name").
- Only the string (free form) or the list (argv) form can be provided, not both. One or the other must be provided.
version_added: "2.6"
creates:
type: path
description:
- A filename or (since 2.0) glob pattern. If a matching file already exists, this step B(will not) be run.
- This is checked before I(removes) is checked.
removes:
type: path
description:
- A filename or (since 2.0) glob pattern. If a matching file exists, this step B(will) be run.
- This is checked after I(creates) is checked.
version_added: "0.8"
chdir:
type: path
description:
- Change into this directory before running the command.
version_added: "0.6"
stdin:
description:
- Set the stdin of the command directly to the specified value.
type: str
version_added: "2.4"
stdin_add_newline:
type: bool
default: yes
description:
- If set to C(true), append a newline to stdin data.
version_added: "2.8"
strip_empty_ends:
description:
- Strip empty lines from the end of stdout/stderr in result.
version_added: "2.8"
type: bool
default: yes
notes:
- If you want to run a command through the shell (say you are using C(<), C(>), C(|), and so on),
you actually want the M(ansible.builtin.shell) module instead.
Parsing shell metacharacters can lead to unexpected commands being executed if quoting is not done correctly so it is more secure to
use the C(command) module when possible.
- C(creates), C(removes), and C(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.
- Check mode is supported when passing C(creates) or C(removes). If running in check mode and either of these are specified, the module will
check for the existence of the file and report the correct changed status. If these are not supplied, the task will be skipped.
- The C(executable) parameter is removed since version 2.4. If you have a need for this parameter, use the M(ansible.builtin.shell) module instead.
- For Windows targets, use the M(ansible.windows.win_command) module instead.
- For rebooting systems, use the M(ansible.builtin.reboot) or M(ansible.windows.win_reboot) module.
seealso:
- module: ansible.builtin.raw
- module: ansible.builtin.script
- module: ansible.builtin.shell
- module: ansible.windows.win_command
author:
- Ansible Core Team
- Michael DeHaan
a�
- name: Return motd to registered var
ansible.builtin.command: cat /etc/motd
register: mymotd
# free-form (string) arguments, all arguments on one line
- name: Run command if /path/to/database does not exist (without 'args')
ansible.builtin.command: /usr/bin/make_database.sh db_user db_name creates=/path/to/database
# free-form (string) arguments, some arguments on separate lines with the 'args' keyword
# 'args' is a task keyword, passed at the same level as the module
- name: Run command if /path/to/database does not exist (with 'args' keyword)
ansible.builtin.command: /usr/bin/make_database.sh db_user db_name
args:
creates: /path/to/database
# 'cmd' is module parameter
- name: Run command if /path/to/database does not exist (with 'cmd' parameter)
ansible.builtin.command:
cmd: /usr/bin/make_database.sh db_user db_name
creates: /path/to/database
- name: Change the working directory to somedir/ and run the command as db_owner if /path/to/database does not exist
ansible.builtin.command: /usr/bin/make_database.sh db_user db_name
become: yes
become_user: db_owner
args:
chdir: somedir/
creates: /path/to/database
# argv (list) arguments, each argument on a separate line, 'args' keyword not necessary
# 'argv' is a parameter, indented one level from the module
- name: Use 'argv' to send a command as a list - leave 'command' empty
ansible.builtin.command:
argv:
- /usr/bin/make_database.sh
- Username with whitespace
- dbname with whitespace
creates: /path/to/database
- name: Safely use templated variable to run command. Always use the quote filter to avoid injection issues
ansible.builtin.command: cat {{ myfile|quote }}
register: myoutput
u
msg:
description: changed
returned: always
type: bool
sample: True
start:
description: The command execution start time.
returned: always
type: str
sample: '2017-09-29 22:03:48.083128'
end:
description: The command execution end time.
returned: always
type: str
sample: '2017-09-29 22:03:48.084657'
delta:
description: The command execution delta time.
returned: always
type: str
sample: '0:00:00.001529'
stdout:
description: The command standard output.
returned: always
type: str
sample: 'Clustering node rabbit@slave1 with rabbit@master …'
stderr:
description: The command standard error.
returned: always
type: str
sample: 'ls cannot access foo: No such file or directory'
cmd:
description: The command executed by the task.
returned: always
type: list
sample:
- echo
- hello
rc:
description: The command return code (0 means success).
returned: always
type: int
sample: 0
stdout_lines:
description: The command standard output split in lines.
returned: always
type: list
sample: [u'Clustering node rabbit@slave1 with rabbit@master …']
stderr_lines:
description: The command standard error split in lines.
returned: always
type: list
sample: [u'ls cannot access foo: No such file or directory', u'ls …']
N)�
AnsibleModule)� to_native�to_bytes�to_text)� is_iterablec C s� t tt� tddd�tddd�tdd�t� tdd�tdd�tdd �tdd
d�tdd
d�d �
d
d �} | jd
}| jd }| jd }| jd }| jd }| jd }| jd }| jd }| jd } | jd }
dddd d d d d dd� } |s�|r�| �d| � d }|�r
|�� dk�r0|�s0d| d< d | d < | jf i | �� |�r\|�r\d| d< d | d < | jf i | �� |�sr|�rrt�|�}|�pz|}t|dd ��r�d d!� |D �}|| d"< |�r t |d#d$�}zt
� |� W nJ t t
f�y
} z,d%t| � | d < | jf i | �� W Y d } ~ n
d } ~ 0 0 | j�rd&}
nd'}
|�rTt�|��rTd(|
|f | d < d)| | d*< d+| d< | d �s�|�r�t�|��s�d,|
|f | d < d-| | d*< d+| d< | d �r�| jf i | �� d
| d.< | j�stj�� | d/< | j|||d || d0�\| d< | d*< | d1< tj�� | d2< n4d+| d< d3| d < |d u �r:|d u �r:d
| d4< d| d.< | d/ d u�r�| d2 d u�r�t| d2 | d/ �| d5< t| d2 �| d2< t| d/ �| d/< |
�r�t| d* ��d6�| d*< t| d1 ��d6�| d1< | d d+k�r�d7| d < | jf i | �� | jf i | �� d S )8N�boolF)�type�default�list�str)r �elements�path)r )�requiredT)
� _raw_params� _uses_shell�argv�chdir�
executable�creates�removes�stdin�stdin_add_newline�strip_empty_ends)Z
argument_specZsupports_check_moder r r r r r r r r r � ) �changed�stdout�stderr�rc�cmd�start�end�delta�msgzoAs of Ansible 2.4, the parameter 'executable' is no longer supported with the 'command' module. Not using '%s'.� r zno command givenr% z+only command or argv can be given, not both)Zinclude_stringsc S s g | ]}t |d dd��qS )�surrogate_or_strictZ
simplerepr)�errorsZ nonstring)r )�.0�arg� r+ �;/usr/lib/python3.9/site-packages/ansible/modules/command.py�
<listcomp> � zmain.<locals>.<listcomp>r! r' )r( z/Unable to change directory before execution: %sZWouldZDidz$%s not run command since '%s' existszskipped, since %s existsr r z,%s not run command since '%s' does not existz skipped, since %s does not existr r" )r Zuse_unsafe_shell�encoding�dataZ binary_datar r# z+Command would have run if not in check modeZskippedr$ z
znon-zero return code)r �dict�params�warn�stripZ fail_json�shlex�splitr r �osr �IOError�OSErrorr Z
check_mode�globZ exit_json�datetimeZnowZ run_command�rstrip)�module�shellr r �argsr r r r r r4 �r�eZshouldar+ r+ r, �main� s�
�
�
&
� rB �__main__)Z
__future__r r r r Z
__metaclass__Z
DOCUMENTATIONZEXAMPLESZRETURNr; r: r7 r5 Zansible.module_utils.basicr Zansible.module_utils._textr r r Z'ansible.module_utils.common.collectionsr rB �__name__r+ r+ r+ r, �<module> s g-7