Spec-Zone.ru › Ansible 2.7

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
    Варианты:
  • no
  • yes ←
если предупреждения о командах включены в 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API