ansible.builtin.pipe – чтение вывода из команды
Примечание
Этот модуль является частью ansible-base и включен во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля pipe, даже не указывая collections: ключевое слово. Несмотря на это, мы рекомендуем использовать FQCN для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 0.9: модуля ansible.builtin
Обзор
- Выполнение команды и возврат вывода.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _terms строка / обязательный | команда(ы) для выполнения. |
Примечания
Примечание
- Как и все lookup, этот модуль выполняется на контроллере Ansible и не затрагивается другими ключевыми словами, такими как become, поэтому, если вам нужны разные разрешения, вы должны изменить команду или запустить Ansible как другого пользователя.
- В качестве альтернативы вы можете использовать задачу shell/command, которая выполняется на localhost и регистрирует результат.
- Lookup pipe внутри вызывает Popen с shell=True (это необходимо и преднамеренно). Этот тип вызова считается проблемой безопасности, если не уделено достаточное внимание очистке любого пользовательского ввода или ввода переменных. Сильно рекомендуется передавать пользовательский ввод или переменные через фильтр quote перед использованием с lookup pipe. См. раздел примеров для этого. Подробнее об этом можно прочитать в документации Bandit B602
Примеры
- name: raw result of running date command"
debug:
msg: "{{ lookup('pipe', 'date') }}"
- name: Always use quote filter to make sure your variables are safe to use with shell
debug:
msg: "{{ lookup('pipe', 'getent passwd ' + myuser | quote ) }}"
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого lookup:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _string список / элементы=строка | успех | stdout от команды |
Авторы
- Daniel Hokka Zakrisson (!UNKNOWN) <daniel@hozac.com>
© 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/pipe_lookup.html
