ansible.builtin.pipe – чтение вывода из команды
Примечание
Этот модуль является частью ansible-base и включен во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля pipe, даже не указывая collections: ключевое слово. Несмотря на это, мы рекомендуем использовать FQCN для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новый в версии 0.9: из ansible.builtin
Обзор
- Выполнить команду и вернуть вывод.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _terms строка / обязательно | команда(ы) для выполнения. |
Примечания
Примечание
- Как и все lookups, это выполняется на контроллере Ansible и не затрагивается другими ключевыми словами, такими как become, поэтому если вам нужны разные разрешения, вы должны изменить команду или запустить Ansible как другого пользователя.
- В качестве альтернативы вы можете использовать задачу shell/command, которая выполняется на localhost и регистрирует результат.
- Pipe lookup внутри вызывает Popen с shell=True (это необходимо и преднамеренно). Этот тип вызова считается проблемой безопасности, если не предприняты соответствующие меры для очистки любого вводимого пользователем или переменного ввода. Настоятельно рекомендуется передавать ввод пользователя или переменные через фильтр цитирования перед использованием с pipe lookup. См. раздел примеров для этого. Узнайте больше об этом в документации 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/pipe_lookup.html
