meta — Выполнение Ansible «действий»

Описание
Параметры
Примечания
Примеры
Статус
- Поддержка
- Автор

Описание

Задачи мета — это особый вид задач, которые могут влиять на внутреннее выполнение или состояние Ansible. До Ansible 2.0 единственным доступным мета-параметром был flush_handlers. Начиная с версии 2.2, доступно пять мета-задач. Мета-задачи могут использоваться в любом месте вашего плейбука.
Этот модуль также поддерживается для целевых систем Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
free_form обязательно	Варианты: noop flush_handlers refresh_inventory clear_facts clear_host_errors end_play reset_connection	Этот модуль принимает команду в свободном формате, как строку. Нет фактического параметра «свободная форма». Обратитесь к примерам! `flush_handlers` заставляет Ansible выполнить все задачи обработчиков, о которых ему было сообщено. Ansible вставляет эти задачи внутри в определенные моменты для явного запуска обработчиков (после задач pre/post, после выполнения последнего ролевого модуля и в секции основных задач ваших плейбуков). `refresh_inventory` (добавлен в 2.0) принудительно перезагружает инвентаризацию, что в случае динамической инвентаризации означает повторное выполнение сценариев. Это полезно, когда создаются дополнительные хосты, и пользователи хотят использовать их вместо модуля `add_host`. `noop` (добавлен в 2.0) фактически ничего не делает. В основном используется внутри и не рекомендуется для общего использования. `clear_facts` (добавлен в 2.1) очищает собранные факты для хостов, указанных в списке хостов плейбука, включая кэш фактов. `clear_host_errors` (добавлен в 2.1) очищает состояние сбоя (если есть) для хостов, указанных в списке хостов плейбука. `end_play` (добавлен в 2.2) завершает плейбук без сбоя хоста(ов). Обратите внимание, что это влияет на все хосты. `reset_connection` (добавлен в 2.3) прерывает постоянное подключение (например, ssh + сохранение соединения).

Примечания

Примечание

meta не является по-настоящему модулем или плагином action, поэтому его нельзя перезаписать.
Этот модуль также поддерживается для целевых систем Windows.

Примеры

- template:
    src: new.j2
    dest: /etc/config.txt
  notify: myhandler
- name: force all notified handlers to run at this point, not waiting for normal sync points
  meta: flush_handlers

- name: reload inventory, useful with dynamic inventories when play makes changes to the existing hosts
  cloud_guest:            # this is fake module
    name: newhost
    state: present
- name: Refresh inventory to ensure new instaces exist in inventory
  meta: refresh_inventory

- name: Clear gathered facts from all currently targeted hosts
  meta: clear_facts

- name: bring host back to play after failure
  copy:
    src: file
    dest: /etc/file
  remote_user: imightnothavepermission

- meta: clear_host_errors

- user: name={{ansible_user}} groups=input
- name: reset ssh connection to allow user changes to affect 'current login user'
  meta: reset_connection

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.

Поддержка

Для получения дополнительной информации о поддержке этого модуля Red Hat, пожалуйста, обратитесь к этой статье базы знаний

Автор

Команда разработчиков Ansible

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/meta_module.html