raw - Выполняет низкоуровневую и грязную команду SSH
Описание
- Выполняет низкоуровневую и грязную команду SSH, не проходя через подсистему модуля. Это полезно и должно использоваться только в двух случаях. Первый случай — установка
python-simplejsonна более старых хостах (Python 2.4 и ранее), которым она необходима в качестве зависимости для запуска модулей, так как почти все основные модули требуют её. Другой случай — взаимодействие с устройствами, такими как маршрутизаторы, на которых не установлен 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.
Примеры
- name: Bootstrap a legacy python 2.4 host
raw: yum -y install python-simplejson
- 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_simplejson|quote}}"
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые изменения в интерфейс.
Поддержка
Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, пожалуйста, обратитесь к этой статье базы знаний
Автор
- Команда разработчиков Ansible
- Майкл ДеХан
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/raw_module.html