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

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

Синопсис

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

Параметры

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

Примечания

Примечание

meta фактически не является модулем или плагином action_plugin, поэтому его нельзя перезаписать.
clear_facts удалит постоянные факты из set_fact с использованием cacheable=True, но не текущую переменную хоста, созданную для текущего выполнения.
Этот модуль также поддерживается для целевых систем Windows.

См. также

assert – Проверяет истинность заданных выражений: Официальная документация по модулю assert.
fail – Отказ с пользовательским сообщением: Официальная документация по модулю fail.

Примеры

# Example showing flushing handlers on demand, not at end of play
- 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

# Example showing how to refresh inventory during play
- 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 instances exist in inventory
  meta: refresh_inventory

# Example showing how to clear all existing facts of targetted hosts
- name: Clear gathered facts from all currently targeted hosts
  meta: clear_facts

# Example showing how to continue using a failed target
- name: Bring host back to play after failure
  copy:
    src: file
    dest: /etc/file
  remote_user: imightnothavepermission

- meta: clear_host_errors

# Example showing how to reset an existing connection
- user:
    name: '{{ ansible_user }}'
    groups: input

- name: Reset ssh connection to allow user changes to affect 'current login user'
  meta: reset_connection

# Example showing how to end the play for specific targets
- name: End the play for hosts that run CentOS 6
  meta: end_host
  when:
  - ansible_distribution == 'CentOS'
  - ansible_distribution_major_version == '6'

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается командой разработчиков 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.8/modules/meta_module.html