Ключевые слова плейбука
Это ключевые слова, доступные для общих объектов плейбука. Ключевые слова — один из нескольких источников настройки поведения Ansible. Подробные сведения об относительном приоритете каждого источника см. в разделе Управление поведением Ansible: правила приоритета.
Примечание
Обратите внимание:
- Здесь не указаны псевдонимы директив и директивы, значения которых можно изменять. Например, action в задаче можно заменить именем любого модуля Ansible.
- В настоящее время ключевые слова не содержат информацию
version_added - Некоторые ключевые слова задают значения по умолчанию для объектов внутри них, а не для самих объектов
Плей
- any_errors_fatal
-
Принудительно передавать все необработанные ошибки задач на любом узле всем узлам и завершать плей.
- become
-
Логическое значение, определяющее, используется ли повышение привилегий при выполнении задачи. Реализуется плагином become. См. раздел Плагины become.
- become_exe
-
Путь к исполняемому файлу, используемому для повышения привилегий. Реализуется плагином become. См. раздел Плагины become.
- become_flags
-
Строка с флагом или флагами, передаваемыми программе повышения привилегий, когда become имеет значение True.
- become_method
-
Метод повышения привилегий (например, sudo или su).
- become_user
-
Пользователь, от имени которого вы выполняете задачи после повышения привилегий. У удалённого пользователя или пользователя для входа должны быть разрешения на переключение на этого пользователя.
- check_mode
-
Логическое значение, определяющее, выполняется ли задача обычным образом или не вносит изменений в целевую систему и пытается сообщить, что было бы сделано (режим проверки/пробный запуск). См. раздел Проверка задач: режим проверки и режим различий.
- collections
-
Список пространств имён коллекций для поиска модулей, плагинов и ролей. См. раздел Использование коллекций в плейбуке
Примечание
Задачи внутри роли не наследуют значение
collectionsиз плейбука. Чтобы роль выполняла поиск по списку коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом узле. См. раздел Использование плагинов подключения.
- debugger
-
Включает отладку задач в зависимости от состояния результата задачи. См. раздел Отладка задач.
- diff
-
Включает или отключает возврат задачами информации о различиях.
- environment
-
Словарь, преобразуемый в переменные окружения, передаваемые задаче при выполнении. Его можно использовать ТОЛЬКО с модулями. Он не поддерживается плагинами других типов, самим Ansible или его конфигурацией: он лишь задаёт переменные для кода, отвечающего за выполнение задачи. Не рекомендуется передавать таким способом конфиденциальные данные.
- fact_path
-
Задаёт параметр fact path для плагина сбора фактов, управляемого параметром gather_facts.
- force_handlers
-
Принудительно выполняет уведомлённые обработчики на узлах, даже если во время выполнения плейбука на них произошёл сбой. Не сработает, если сбой произошёл в самом плейбуке.
- gather_facts
-
Логическое значение, определяющее, будет ли плейбук автоматически запускать задачу «setup» для сбора фактов об узлах.
- gather_subset
-
Позволяет передавать параметры подмножеств плагину сбора фактов, управляемому параметром gather_facts.
- gather_timeout
-
Позволяет задать время ожидания для плагина сбора фактов, управляемого параметром gather_facts.
- handlers
-
Раздел с задачами, рассматриваемыми как обработчики. Обычно они не выполняются, а запускаются только после уведомления по завершении каждого раздела задач. Поле
listenобработчика нельзя шаблонизировать. - hosts
-
Список групп, узлов или шаблон узлов, преобразуемый в список целевых узлов плейбука.
- ignore_errors
-
Логическое значение, позволяющее игнорировать сбои задач и продолжать выполнение плейбука. Не влияет на ошибки подключения.
- ignore_unreachable
-
Логическое значение, позволяющее игнорировать сбои задач, вызванные недоступностью узла, и продолжать выполнение плейбука. Не влияет на другие ошибки задач (см. ignore_errors), но полезно для групп нестабильных или временных узлов.
- max_fail_percentage
-
Можно использовать для прерывания выполнения, если сбой произошёл на заданном проценте узлов в текущей группе. Работает только со стратегиями linear и производными от linear.
- module_defaults
-
Задаёт значения параметров модулей по умолчанию.
- name
-
Идентификатор. Можно использовать в документации или в задачах и обработчиках.
- no_log
-
Логическое значение, управляющее раскрытием информации.
- order
-
Управляет сортировкой узлов при выполнении плейбука. Возможные значения: inventory (по умолчанию), sorted, reverse_sorted, reverse_inventory и shuffle.
- port
-
Используется для переопределения порта подключения по умолчанию.
- post_tasks
-
Список задач, выполняемых после раздела задач.
- pre_tasks
-
Список задач, выполняемых перед ролями.
- remote_user
-
Пользователь, используемый для входа на целевой узел через плагин подключения.
- roles
-
Список ролей, импортируемых в плейбук
- run_once
-
Логическое значение, отключающее цикл по узлам и принудительно запускающее задачу на первом доступном узле; затем все результаты и факты применяются ко всем активным узлам той же группы.
- serial
-
Позволяет явно задать, как Ansible разбивает выполнение текущего плейбука на целевых узлах на группы. См. раздел Настройка размера группы с помощью serial.
- strategy
-
Позволяет выбрать плагин стратегии для плейбука. См. раздел Плагины стратегий.
- tags
-
Теги, применяемые к задаче или включённым задачам. Позволяют выбирать подмножества задач из командной строки.
- tasks
-
Основной список задач для выполнения в плейбуке. Они выполняются после ролей и перед post_tasks.
- throttle
-
Ограничивает количество параллельно выполняемых задач на уровне задачи, блока и плейбука. Не зависит от параметров forks и serial, но не может превышать заданные ими ограничения. Например, если forks равен 10, а throttle — 15, параллельно будут обрабатываться не более 10 узлов.
- timeout
-
Ограничение времени выполнения действия задачи. Если оно превышено, Ansible прерывает процесс. Время ожидания не включает шаблонизацию и циклы.
- validate_argspec
-
НЕ ДОКУМЕНТИРОВАНО!!
- vars
-
Словарь/карта переменных
- vars_files
-
Список файлов с переменными, подключаемыми к плейбуку.
- vars_prompt
-
Список переменных, значения которых запрашиваются у пользователя.
Роль
- any_errors_fatal
-
Принудительно передавать все необработанные ошибки задач на любом узле всем узлам и завершать плей.
- become
-
Логическое значение, определяющее, используется ли повышение привилегий при выполнении задачи. Реализуется плагином become. См. раздел Плагины become.
- become_exe
-
Путь к исполняемому файлу, используемому для повышения привилегий. Реализуется плагином become. См. раздел Плагины become.
- become_flags
-
Строка с флагом или флагами, передаваемыми программе повышения привилегий, когда become имеет значение True.
- become_method
-
Метод повышения привилегий (например, sudo или su).
- become_user
-
Пользователь, от имени которого вы выполняете задачи после повышения привилегий. У удалённого пользователя или пользователя для входа должны быть разрешения на переключение на этого пользователя.
- check_mode
-
Логическое значение, определяющее, выполняется ли задача обычным образом или не вносит изменений в целевую систему и пытается сообщить, что было бы сделано (режим проверки/пробный запуск). См. раздел Проверка задач: режим проверки и режим различий.
- collections
-
Список пространств имён коллекций для поиска модулей, плагинов и ролей. См. раздел Использование коллекций в плейбуке
Примечание
Задачи внутри роли не наследуют значение
collectionsиз плейбука. Чтобы роль выполняла поиск по списку коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом узле. См. раздел Использование плагинов подключения.
- debugger
-
Включает отладку задач в зависимости от состояния результата задачи. См. раздел Отладка задач.
- delegate_facts
-
Логическое значение, позволяющее применять факты к делегированному узлу вместо inventory_hostname.
- delegate_to
-
Узел, на котором выполняется задача вместо целевого узла (inventory_hostname). Для задачи также будут использоваться переменные подключения делегированного узла.
- diff
-
Включает или отключает возврат задачами информации о различиях.
- environment
-
Словарь, преобразуемый в переменные окружения, передаваемые задаче при выполнении. Его можно использовать ТОЛЬКО с модулями. Он не поддерживается плагинами других типов, самим Ansible или его конфигурацией: он лишь задаёт переменные для кода, отвечающего за выполнение задачи. Не рекомендуется передавать таким способом конфиденциальные данные.
- ignore_errors
-
Логическое значение, позволяющее игнорировать сбои задач и продолжать выполнение плейбука. Не влияет на ошибки подключения.
- ignore_unreachable
-
Логическое значение, позволяющее игнорировать сбои задач, вызванные недоступностью узла, и продолжать выполнение плейбука. Не влияет на другие ошибки задач (см. ignore_errors), но полезно для групп нестабильных или временных узлов.
- module_defaults
-
Задаёт значения параметров модулей по умолчанию.
- name
-
Идентификатор. Можно использовать в документации или в задачах и обработчиках.
- no_log
-
Логическое значение, управляющее раскрытием информации.
- port
-
Используется для переопределения порта подключения по умолчанию.
- remote_user
-
Пользователь, используемый для входа на целевой узел через плагин подключения.
- run_once
-
Логическое значение, отключающее цикл по узлам и принудительно запускающее задачу на первом доступном узле; затем все результаты и факты применяются ко всем активным узлам той же группы.
- tags
-
Теги, применяемые к задаче или включённым задачам. Позволяют выбирать подмножества задач из командной строки.
- throttle
-
Ограничивает количество параллельно выполняемых задач на уровне задачи, блока и плейбука. Не зависит от параметров forks и serial, но не может превышать заданные ими ограничения. Например, если forks равен 10, а throttle — 15, параллельно будут обрабатываться не более 10 узлов.
- timeout
-
Ограничение времени выполнения действия задачи. Если оно превышено, Ansible прерывает процесс. Время ожидания не включает шаблонизацию и циклы.
- vars
-
Словарь/карта переменных
- when
-
Условное выражение, определяющее, будет ли выполнена итерация задачи.
Блок
- always
-
Список задач в блоке, которые выполняются независимо от того, произошла ли в блоке ошибка.
- any_errors_fatal
-
Принудительно передавать все необработанные ошибки задач на любом узле всем узлам и завершать плей.
- become
-
Логическое значение, определяющее, используется ли повышение привилегий при выполнении задачи. Реализуется плагином become. См. раздел Плагины become.
- become_exe
-
Путь к исполняемому файлу, используемому для повышения привилегий. Реализуется плагином become. См. раздел Плагины become.
- become_flags
-
Строка с флагом или флагами, передаваемыми программе повышения привилегий, когда become имеет значение True.
- become_method
-
Метод повышения привилегий (например, sudo или su).
- become_user
-
Пользователь, от имени которого вы выполняете задачи после повышения привилегий. У удалённого пользователя или пользователя для входа должны быть разрешения на переключение на этого пользователя.
- block
-
Список задач в блоке.
- check_mode
-
Логическое значение, определяющее, выполняется ли задача обычным образом или не вносит изменений в целевую систему и пытается сообщить, что было бы сделано (режим проверки/пробный запуск). См. раздел Проверка задач: режим проверки и режим различий.
- collections
-
Список пространств имён коллекций для поиска модулей, плагинов и ролей. См. раздел Использование коллекций в плейбуке
Примечание
Задачи внутри роли не наследуют значение
collectionsиз плейбука. Чтобы роль выполняла поиск по списку коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом узле. См. раздел Использование плагинов подключения.
- debugger
-
Включает отладку задач в зависимости от состояния результата задачи. См. раздел Отладка задач.
- delegate_facts
-
Логическое значение, позволяющее применять факты к делегированному узлу вместо inventory_hostname.
- delegate_to
-
Узел, на котором выполняется задача вместо целевого узла (inventory_hostname). Для задачи также будут использоваться переменные подключения делегированного узла.
- diff
-
Включает или отключает возврат задачами информации о различиях.
- environment
-
Словарь, преобразуемый в переменные окружения, передаваемые задаче при выполнении. Его можно использовать ТОЛЬКО с модулями. Он не поддерживается плагинами других типов, самим Ansible или его конфигурацией: он лишь задаёт переменные для кода, отвечающего за выполнение задачи. Не рекомендуется передавать таким способом конфиденциальные данные.
- ignore_errors
-
Логическое значение, позволяющее игнорировать сбои задач и продолжать выполнение плейбука. Не влияет на ошибки подключения.
- ignore_unreachable
-
Логическое значение, позволяющее игнорировать сбои задач, вызванные недоступностью узла, и продолжать выполнение плейбука. Не влияет на другие ошибки задач (см. ignore_errors), но полезно для групп нестабильных или временных узлов.
- module_defaults
-
Задаёт значения параметров модулей по умолчанию.
- name
-
Идентификатор. Можно использовать в документации или в задачах и обработчиках.
- no_log
-
Логическое значение, управляющее раскрытием информации.
- notify
-
Список обработчиков, которые нужно уведомить, когда задача возвращает статус «changed=True».
- port
-
Используется для переопределения порта подключения по умолчанию.
- remote_user
-
Пользователь, используемый для входа на целевой узел через плагин подключения.
- rescue
-
Список задач в блоке, выполняемых при ошибке задачи в основном списке блока.
- run_once
-
Логическое значение, отключающее цикл по узлам и принудительно запускающее задачу на первом доступном узле; затем все результаты и факты применяются ко всем активным узлам той же группы.
- tags
-
Теги, применяемые к задаче или включённым задачам. Позволяют выбирать подмножества задач из командной строки.
- throttle
-
Ограничивает количество параллельно выполняемых задач на уровне задачи, блока и плейбука. Не зависит от параметров forks и serial, но не может превышать заданные ими ограничения. Например, если forks равен 10, а throttle — 15, параллельно будут обрабатываться не более 10 узлов.
- timeout
-
Ограничение времени выполнения действия задачи. Если оно превышено, Ansible прерывает процесс. Время ожидания не включает шаблонизацию и циклы.
- vars
-
Словарь/карта переменных
- when
-
Условное выражение, определяющее, будет ли выполнена итерация задачи.
Задача
- action
-
«Действие», которое нужно выполнить для задачи; обычно оно соответствует модулю C или плагину action.
- any_errors_fatal
-
Принудительно передать необработанные ошибки задач на любом узле всем узлам и завершить play.
- args
-
Дополнительный способ добавить аргументы в задачу. Принимает словарь, в котором ключи соответствуют параметрам, а значения — их значениям.
- async
-
Асинхронное выполнение задачи, если C(action) поддерживает этот режим; значение задаёт максимальное время выполнения в секундах.
- become
-
Логическое значение, определяющее, используется ли повышение привилегий при выполнении задачи. Реализуется плагином become. См. Плагины become.
- become_exe
-
Путь к исполняемому файлу, используемому для повышения привилегий. Реализуется плагином become. См. Плагины become.
- become_flags
-
Строка с флагами, передаваемыми программе повышения привилегий, когда become имеет значение True.
- become_method
-
Метод повышения привилегий (например, sudo или su).
- become_user
-
Пользователь, от имени которого выполняется задача после повышения привилегий. У удалённого пользователя (пользователя для входа) должны быть права на переход к этому пользователю.
- changed_when
-
Условное выражение, переопределяющее обычный статус задачи «изменено».
- check_mode
-
Логическое значение, определяющее, выполняется ли задача обычным образом или не вносит изменения в целевой узел и пытается сообщить, что было бы сделано (режим проверки/пробный запуск). См. Проверка задач: режим проверки и режим различий.
- collections
-
Список пространств имён коллекций для поиска модулей, плагинов и ролей. См. Использование коллекций в playbook
Примечание
Задачи внутри роли не наследуют значение
collectionsиз play. Чтобы роль выполняла поиск в списке коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом узле. См. Использование плагинов подключения.
- debugger
-
Включает отладку задач в зависимости от состояния результата задачи. См. Отладка задач.
- delay
-
Количество секунд задержки между повторами. Этот параметр используется только вместе с until.
- delegate_facts
-
Логическое значение, позволяющее применять факты к делегированному узлу вместо inventory_hostname.
- delegate_to
-
Узел, на котором выполняется задача вместо целевого узла (inventory_hostname). Для задачи также будут использоваться переменные подключения делегированного узла.
- diff
-
Переключатель, определяющий, будут ли задачи возвращать информацию о «различиях».
- environment
-
Словарь, преобразуемый в переменные среды, которые передаются задаче при выполнении. Эту возможность МОЖНО использовать ТОЛЬКО с модулями. Она не поддерживается другими типами плагинов, самим Ansible или его конфигурацией и лишь задаёт переменные для кода, отвечающего за выполнение задачи. Не рекомендуется использовать этот способ для передачи конфиденциальных данных.
- failed_when
-
Условное выражение, переопределяющее обычный статус задачи «ошибка».
- ignore_errors
-
Логическое значение, позволяющее игнорировать ошибки задач и продолжать выполнение play. Не влияет на ошибки подключения.
- ignore_unreachable
-
Логическое значение, позволяющее игнорировать ошибки задач, вызванные недоступностью узла, и продолжать выполнение play. Не влияет на другие ошибки задач (см. ignore_errors), но полезно для групп нестабильных или временных узлов.
- local_action
-
То же, что и action, но также подразумевает
delegate_to: localhost - loop
-
Принимает список, по которому выполняется итерация задачи, сохраняя каждый элемент списка в переменную
item(настраивается через loop_control) - loop_control
-
Несколько ключей позволяют изменить или настроить поведение цикла в задаче. См. Добавление элементов управления в циклы.
- module_defaults
-
Задаёт значения параметров модулей по умолчанию.
- name
-
Идентификатор. Может использоваться в документации, задачах или обработчиках.
- no_log
-
Логическое значение, управляющее раскрытием информации.
- notify
-
Список обработчиков, которым отправляется уведомление, когда задача возвращает статус «changed=True».
- poll
-
Задаёт интервал опроса в секундах для асинхронных задач (по умолчанию 10 с).
- port
-
Используется для переопределения порта подключения по умолчанию.
- register
-
Имя переменной, в которой будут храниться статус задачи и данные, возвращённые модулем.
- remote_user
-
Пользователь, используемый для входа на целевой узел через плагин подключения.
- retries
-
Количество повторов до прекращения попыток в цикле until. Этот параметр используется только вместе с until.
- run_once
-
Логическое значение, отключающее цикл по узлам и заставляющее задачу попытаться выполниться на первом доступном узле, а затем применить все результаты и факты ко всем активным узлам в том же пакете.
- tags
-
Теги, применяемые к задаче или включённым задачам; позволяют выбирать подмножества задач из командной строки.
- throttle
-
Ограничивает число одновременных запусков задач на уровне задачи, блока и playbook. Этот параметр не зависит от значений forks и serial, но не может превышать установленные ими ограничения. Например, если forks равен 10, а throttle установлен в 15, параллельно будут обрабатываться не более 10 узлов.
- timeout
-
Ограничение времени выполнения действия задачи; если оно превышено, Ansible прервёт процесс. Тайм-аут не включает шаблонизацию и циклы.
- until
-
Это ключевое слово подразумевает «цикл retries», который выполняется, пока не будет выполнено указанное здесь условие или не будет достигнут предел retries.
- vars
-
Словарь/отображение переменных
- when
-
Условное выражение, определяющее, будет ли выполнена итерация задачи.
- with_<lookup_plugin>
-
То же, что и
loop, но автоматически добавляет результаты любого плагина поиска для формирования списка элементов.
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/reference_appendices/playbooks_keywords.html