meta - Выполнение Ansible ‘действий’
Описание
- Задачи мета – это особый тип задач, которые могут влиять на внутреннее выполнение или состояние Ansible. До Ansible 2.0 единственным доступным вариантом мета была
flush_handlers. Начиная с версии 2.2, доступно пять задач мета. Задачи мета могут использоваться в любом месте внутри вашего плейбука. - Этот модуль также поддерживается для целевых систем Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| free_form обязательно |
| Этот модуль принимает команду в свободном формате в виде строки. Нет фактического параметра "свободная форма". Обратите внимание на примеры! 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не является модулем и не является плагином action_plugin, поэтому его нельзя перезаписать. - Этот модуль также поддерживается для целевых систем 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. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых командой Ansible Core, см. здесь.
Поддержка
Для получения дополнительной информации о поддержке этого модуля Red Hat, пожалуйста, обратитесь к этой статье базы знаний
Автор
- Команда Ansible Core
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/meta_module.html
