raw – Выполняет низкоуровневую и грязную команду

Описание
Параметры
Примечания
См. также
Примеры
Статус

Описание

Выполняет низкоуровневую и грязную команду SSH, не проходя через подсистему модулей.
Это полезно и должно использоваться только в нескольких случаях. Частым случаем является установка python на системе без предварительно установленного Python. Другим случаем является взаимодействие с устройствами, такими как маршрутизаторы, на которых не установлен Python. В остальных случаях использование модуля shell или command гораздо более уместно.
Аргументы, переданные в raw, выполняются непосредственно через настроенную удалённую оболочку.
Стандартный вывод, вывод ошибок и код возврата возвращаются, если доступны.
Поддержка обработки событий изменений для этого модуля отсутствует.
Этот модуль не требует Python на удалённой системе, подобно модулю script.
Этот модуль также поддерживается для целевых систем Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
executable -		Изменяет оболочку, используемую для выполнения команды. Должен быть абсолютный путь к исполняемому файлу. При использовании повышения привилегий (`become`) будет назначена оболочка по умолчанию, если она не указана, так как повышение привилегий требует оболочки.
free_form - / обязательно		Модуль raw принимает команду в произвольной форме для выполнения. Нет параметра с именем «свободная форма»; см. примеры!

Примечания

Примечание

Если вы используете raw из книги задач, вам может потребоваться отключить сбор фактов, используя gather_facts: no, если вы используете raw для установки Python на машину.
Если вы хотите выполнить команду безопасно и предсказуемо, лучше использовать модули command или shell.
Ключевое слово environment обычно не работает с raw, оно требует оболочки, что означает, что оно работает только если executable задан или используется модуль с повышением привилегий (become).
Этот модуль также поддерживается для целевых систем Windows.

См. также

command – Выполнение команд на целевых системах: Официальная документация по модулю command.
shell – Выполнение команд оболочки на целевых системах: Официальная документация по модулю shell.
win_command – Выполнение команды на удалённом узле Windows: Официальная документация по модулю win_command.
win_shell – Выполнение команд оболочки на целевых хостах: Официальная документация по модулю win_shell.

Примеры

- 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

Статус

Для этого модуля гарантируется отсутствие обратных несовместимых изменений интерфейса в будущем. [stableinterface]
Этот модуль поддерживается командой разработчиков Ansible. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Команда разработчиков Ansible
Michael DeHaan

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/raw_module.html