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

Примечание

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

Новое в версии 0.8: of ansible.builtin

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

Описание

Этот модуль выводит сообщения во время выполнения и может быть полезен для отладки переменных или выражений без необходимости остановки выполнения книги задач.
Полезен для отладки вместе с директивой «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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/debug_module.html