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

Примечание

Этот модуль входит в состав ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля debug, даже не указывая ключевое слово collections:. Несмотря на это, рекомендуется использовать полное имя класса (FQCN) для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Добавлен в версии 0.8: модуля ansible.builtin

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

Описание

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

Примечание

У этого модуля есть соответствующий плагин действия.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
msg строка	Значение по умолчанию: "Привет мир!"	Настраиваемое сообщение, которое выводится на экран. Если опущено, выводится сообщение по умолчанию.
var строка		Имя переменной для отладки. Взаимоисключающий параметр с `msg`. Обратите внимание, что этот параметр уже выполняется в контексте Jinja2 и имеет неявное `{{ }}` обертывание, поэтому вам не следует использовать разделители Jinja2, если вы не ищете двойную интерполяцию.
verbosity целое число добавлен в версии 2.1 ansible.builtin	Значение по умолчанию: 0	Число, контролирующее выполнение отладки. Если вы установите значение 3, отладка будет выполняться только при использовании -vvv или выше.

Примечания

Примечание

Этот модуль также поддерживается для целей Windows.

См. также

ansible.builtin.assert: Официальная документация модуля ansible.builtin.assert.
ansible.builtin.fail: Официальная документация модуля ansible.builtin.fail.

Примеры

- name: Print the gateway for each host when defined
  ansible.builtin.debug:
    msg: System {{ inventory_hostname }} has gateway {{ ansible_default_ipv4.gateway }}
  when: ansible_default_ipv4.gateway is defined

- name: Get uptime information
  ansible.builtin.shell: /usr/bin/uptime
  register: result

- name: Print return information from the previous task
  ansible.builtin.debug:
    var: result
    verbosity: 2

- name: Display all variables/facts known for a host
  ansible.builtin.debug:
    var: hostvars[inventory_hostname]
    verbosity: 4

- name: Prints two lines of messages, but only if there is an environment value set
  ansible.builtin.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."

Авторы

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.10/collections/ansible/builtin/debug_module.html