meta – Выполнение Ansible ‘действий’

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

Описание

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

Параметры

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

Примечания

Примечание

meta фактически не является модулем или плагином действия, поэтому его нельзя перезаписать.
Этот модуль также поддерживается для целевых систем 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

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается командой разработчиков Ansible. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний 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.7/modules/meta_module.html