debug – Вывод сообщений во время выполнения

Описание
Параметры
Примечания
См. также
Примеры
Статус

Описание

Этот модуль выводит сообщения во время выполнения и может быть полезен для отладки переменных или выражений без необходимости остановки выполнения книги сценариев.
Полезен для отладки вместе с директивой «when:».
Этот модуль также поддерживается для целевых платформ Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
msg строка	Значение по умолчанию: "Привет мир!"	Настраиваемое сообщение, которое будет выведено. Если опущено, выводится общее сообщение.
var строка		Имя переменной для отладки. Взаимоисключительно с параметром `msg`. Обратите внимание, что этот параметр уже выполняется в контексте Jinja2 и имеет неявное `{{ }}` обрамление, поэтому вы не должны использовать разделители Jinja2, если не ищете двойную интерполяцию.
verbosity целое число добавлен в версии 2.1	Значение по умолчанию: 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]

Поддержка 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.8/modules/debug_module.html