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 + поддержание соединения).

Примеры

- 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

Примечания

Примечание

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

Статус

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

Информация о техническом обслуживании

Для получения дополнительной информации о поддержке этого модуля Red Hat, пожалуйста, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Информацию о сообществе и участии в разработке, Тестирование 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.4/meta_module.html