shell – Выполнение команд в узлах.
Краткое описание
- Модуль
shellпринимает имя команды, за которым следует список аргументов, разделенных пробелами. Он почти идентичен модулю command, но выполняет команду через оболочку (/bin/sh) на удалённом узле. - Для целей Windows используйте модуль win_shell.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| chdir - | Перейти в эту директорию перед запуском команды | |
| creates - | имя файла; если файл уже существует, этот шаг не выполняется. | |
| executable - | изменить оболочку для выполнения команды. Должен быть абсолютный путь к исполняемому файлу. | |
| free_form - / обязательно | Модуль shell принимает свободную форму команды для выполнения в виде строки. Нет параметра "free form". Смотрите примеры! | |
| removes - | имя файла; если файл не существует, этот шаг не выполняется. | |
| stdin - добавлен в 2.4 | Установить stdin команды напрямую на указанное значение. | |
| warn boolean добавлен в 1.8 |
| если предупреждения о командах включены в ansible.cfg, не выводить предупреждение об этой строке, если установлено no/false. |
Примечания
Примечание
- Для безопасного и предсказуемого выполнения команд лучше использовать модуль command. Рекомендуемые практики при написании playbooks будут следовать тенденции использования command, если модуль
shellне требуется явно. При выполнении ad-hoc команд используйте собственное суждение. - Режим проверки поддерживается при передаче
createsилиremoves. Если выполняется в режиме проверки и указано одно из этих значений, модуль проверит существование файла и сообщит правильный статус изменения. Если эти значения не указаны, задача будет пропущена. - Для очистки переменных, передаваемых модулю shell, используйте «{{ var | quote }}», а не «{{ var }}», чтобы убедиться, что они не содержат вредоносные символы, такие как точки с запятой.
- Альтернативой использованию встроенных скриптов оболочки с этим модулем является использование модуля script, возможно совместно с модулем template.
- Для перезагрузки систем используйте модули reboot или win_reboot.
См. также
См. также
- command – Выполнение команды на удалённом узле
- Официальная документация по модулю command.
- raw – Выполнение низкоуровневой и грязной SSH команды
- Официальная документация по модулю raw.
- script используйте модуль M(script) вместо.
- Официальная документация по модулю script используйте модуль M(script) вместо.
Примеры
- name: Execute the command in remote shell; stdout goes to the specified file on the remote.
shell: somescript.sh >> somelog.txt
- name: Change the working directory to somedir/ before executing the command.
shell: somescript.sh >> somelog.txt
args:
chdir: somedir/
# You can also use the 'args' form to provide the options.
- name: This command will change the working directory to somedir/ and will only run when somedir/somelog.txt doesn't exist.
shell: somescript.sh >> somelog.txt
args:
chdir: somedir/
creates: somelog.txt
- 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)
shell: cat < /tmp/*txt
args:
executable: /bin/bash
- name: Run a command using a templated variable (always use quote filter to avoid injection)
shell: cat {{ myfile|quote }}
# You can use shell to run other executables to perform actions inline
- name: Run expect to wait for a successful PXE boot via out-of-band CIMC
shell: |
set timeout 300
spawn ssh admin@{{ cimc_host }}
expect "password:"
send "{{ cimc_password }}\n"
expect "\n{{ cimc_name }}"
send "connect host\n"
expect "pxeboot.n12"
send "\n"
exit 0
args:
executable: /usr/bin/expect
delegate_to: localhost
# Disabling warnings
- name: Using curl to connect to a host via SOCKS proxy (unsupported in uri). Ordinarily this would throw a warning.
shell: curl --socks5 localhost:9000 http://www.ansible.com
args:
warn: False
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| cmd строка | всегда | Команда, выполненная задачей Пример: rabbitmqctl join_cluster rabbit@master |
| delta строка | всегда | Время выполнения команды Пример: 0:00:00.325771 |
| end строка | всегда | Время окончания выполнения команды Пример: 2016-02-25 09:18:26.755339 |
| msg boolean | всегда | изменено Пример: True |
| rc целое число | всегда | Код возврата команды (0 означает успех) |
| start строка | всегда | Время начала выполнения команды Пример: 2016-02-25 09:18:26.429568 |
| stderr строка | всегда | Стандартная ошибка команды Пример: ls: cannot access foo: No such file or directory |
| stdout строка | всегда | Стандартный вывод команды Пример: Clustering node rabbit@slave1 with rabbit@master ... |
| stdout_lines список | всегда | Стандартный вывод команды, разделенный на строки Пример: ["u'Clustering node rabbit@slave1 with rabbit@master ...'"] |
Статус
- Гарантируется, что изменения интерфейса в этом модуле не будут обратной совместимости. [stableinterface]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- Команда 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.7/modules/shell_module.html