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

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля raw, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же самое имя модуля.

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

Описание

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

Примечание

Этот модуль имеет соответствующий плагин действий.

Параметры

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

Примечания

Примечание

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

См. также

ansible.builtin.command: Официальная документация модуля ansible.builtin.command.
ansible.builtin.shell: Официальная документация модуля ansible.builtin.shell.
ansible.windows.win_command: Официальная документация модуля ansible.windows.win_command.
ansible.windows.win_shell: Официальная документация модуля ansible.windows.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

Авторы

Команда Ansible Core
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.10/collections/ansible/builtin/raw_module.html