debug – Вывод сообщений во время выполнения
Описание
- Этот модуль выводит сообщения во время выполнения и может быть полезен для отладки переменных или выражений без необходимости приостановки выполнения playbook.
- Полезен для отладки вместе с директивой ‘when:’.
- Этот модуль также поддерживается для целевых платформ Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| msg строка | Значение по умолчанию: "Привет мир!" | Настраиваемое сообщение, которое будет выведено. Если опущено, выводится общее сообщение. |
| var строка | Имя переменной для отладки. Взаимоисключающий с параметром msg. Обратите внимание, что этот параметр уже работает в контексте Jinja2 и имеет неявное обертывание {{ }}, поэтому вам не следует использовать разделители Jinja2, если вы не ищете двойную интерполяцию. | |
| verbosity целое число | Значение по умолчанию: 0 | Число, определяющее, когда запускается отладка. Если установлено в 3, отладка будет запускаться только при использовании -vvv или выше. |
Примечания
Примечание
- Этот модуль также поддерживается для целевых платформ Windows.
См. также
См. также
- assert – Утверждает, что заданные выражения истинны
- Официальная документация модуля assert.
- fail – Ошибка с пользовательским сообщением
- Официальная документация модуля fail.
Примеры
# Example that prints the loopback address and gateway for each host
- debug:
msg: System {{ inventory_hostname }} has uuid {{ ansible_product_uuid }}
- debug:
msg: System {{ inventory_hostname }} has gateway {{ ansible_default_ipv4.gateway }}
when: ansible_default_ipv4.gateway is defined
# Example that prints return information from the previous task
- shell: /usr/bin/uptime
register: result
- debug:
var: result
verbosity: 2
- name: Display all variables/facts known for a host
debug:
var: hostvars[inventory_hostname]
verbosity: 4
# Example that prints two lines of messages, but only if there is an environment value set
- debug:
msg:
- "Provisioning based on YOUR_KEY which is: {{ lookup('env', 'YOUR_KEY') }}"
- "These servers were built using the password of '{{ password_used }}'. Please retain this for later use."
Статус
- Этот модуль гарантирует обратную совместимость при будущих изменениях интерфейса. [stableinterface]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- Dag Wieers (@dagwieers)
- 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.9/modules/debug_module.html