Ключевые слова Playbook
Это ключевые слова, доступные для общих объектов playbook. Ключевые слова являются одним из нескольких источников для настройки поведения Ansible. Подробности о приоритете каждого источника см. в разделе Управление поведением Ansible: правила приоритета.
Примечание
Обратите внимание:
- Алиасы директив здесь не отражены, как и изменяемые. Например, действие в задаче может быть заменено именем любого модуля 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
-
Список пространств имен коллекций для поиска модулей, плагинов и ролей. См. Использование коллекций в playbook
Примечание
Задачи внутри роли не наследуют значение
collectionsиз плей. Чтобы роль искала список коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом объекте. См. Использование плагинов подключения.
- debugger
-
Включить отладку задач на основе состояния результата задачи. См. Отладка задач.
- diff
-
Переключатель, определяющий, возвращает ли задача информацию ‘diff’.
- environment
-
Словарь, который преобразуется в переменные среды для предоставления задаче при выполнении. Это МОЖЕТ быть использовано только с модулями. Это не поддерживается для других типов плагинов, Ansible или его конфигурации; оно просто устанавливает переменные для кода, ответственного за выполнение задачи. Не рекомендуется использовать для передачи конфиденциальных данных.
- 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-derived.
- 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 прервёт и завершит задачу неудачно.
- 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
-
Булево значение, определяющее, выполняется ли задача в режиме проверки. См. Проверка задач: режим check и режим diff.
- collections
-
Список пространств имён коллекций для поиска модулей, плагинов и ролей. См. Использование коллекций в плейбуке
Примечание
Задачи внутри роли не наследуют значение
collectionsиз плейбука. Чтобы роль искала список коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом узле. См. Использование плагинов подключения.
- debugger
-
Включить отладку задач на основе состояния результата задачи. См. Отладка задач.
- delegate_facts
-
Булево значение, позволяющее применять факты к делегированному хосту вместо inventory_hostname.
- delegate_to
-
Узел для выполнения задачи вместо целевого (inventory_hostname). Переменные подключения с делегированного узла также будут использоваться для задачи.
- diff
-
Переключатель для включения или выключения возврата информации ‘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
-
Логическое значение, определяющее, выполняется ли задача в режиме «проверки». Смотрите Проверка задач: режим check и diff.
- collections
-
Список пространств имён коллекций для поиска модулей, плагинов и ролей. Смотрите Использование коллекций в книге задач
Примечание
Задачи в роли не наследуют значение
collectionsиз книги задач. Чтобы роль искала список коллекций, используйте ключевое словоcollectionsвmeta/main.ymlв рамках роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом хосте. Смотрите Использование плагинов подключения.
- debugger
-
Включить отладку задач на основе состояния результата задачи. Смотрите Отладка задач.
- delegate_facts
-
Логическое значение, которое позволяет применять факты к делегированному хосту вместо inventory_hostname.
- delegate_to
-
Хост для выполнения задачи вместо целевого (inventory_hostname). Переменные подключения с делегированного хоста также будут использованы для задачи.
- diff
-
Переключатель, определяющий, будет ли возвращаться информация «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(модуль) или плагин действий.
- any_errors_fatal
-
Принудительно распространяет любые необработанные ошибки задачи на все хосты и завершает выполнение книги.
- args
-
Вторичный способ добавления аргументов в задачу. Принимает словарь, в котором ключи соответствуют параметрам, а значения — их значениям.
- async
-
Выполнить задачу асинхронно, если C(действие) это поддерживает; значение — максимальное время выполнения в секундах.
- become
-
Логический параметр, определяющий, используется ли повышение привилегий при выполнении задачи. Реализуется плагином повышения привилегий. См. Плагины повышения привилегий.
- become_exe
-
Путь к исполняемому файлу, используемому для повышения привилегий. Реализуется плагином повышения привилегий. См. Плагины повышения привилегий.
- become_flags
-
Строка флага(ов), передаваемого программе повышения привилегий, когда become имеет значение True.
- become_method
-
Метод повышения привилегий, который следует использовать (например, sudo или su).
- become_user
-
Пользователь, которому предоставляются повышенные привилегии. У удаленного/входного пользователя должны быть разрешения на повышение привилегий для этого пользователя.
- changed_when
-
Условное выражение, которое переопределяет обычное значение «changed» для задачи.
- check_mode
-
Логический параметр, определяющий, выполняется ли задача в режиме проверки. См. Проверка задач: режим проверки и режим разницы.
- collections
-
Список пространств имен коллекций для поиска модулей, плагинов и ролей. См. Использование коллекций в книге задач
Примечание
Задачи внутри роли не наследуют значение
collectionsиз книги. Чтобы роль искала список коллекций, используйте ключевое словоcollectionsвmeta/main.ymlвнутри роли. - connection
-
Позволяет изменить плагин подключения, используемый для выполнения задач на целевом узле. См. Использование плагинов подключения.
- debugger
-
Включить отладку задач на основе состояния результата задачи. См. Отладка задач.
- delay
-
Количество секунд задержки между повторами. Этот параметр используется только в сочетании с until.
- delegate_facts
-
Логический параметр, позволяющий применять факты к делегированному узлу вместо inventory_hostname.
- delegate_to
-
Узел для выполнения задачи вместо целевого (inventory_hostname). Переменные подключения с делегированного узла также будут использоваться для задачи.
- diff
-
Переключатель, позволяющий задачам возвращать информацию «diff» или нет.
- environment
-
Словарь, преобразуемый в переменные среды для предоставления задаче при выполнении. Может использоваться ТОЛЬКО с модулями. Не поддерживается для других типов плагинов, Ansible или его конфигурации; он просто устанавливает переменные для кода, ответственного за выполнение задачи. Не рекомендуется использовать для передачи конфиденциальных данных.
- failed_when
-
Условное выражение, которое переопределяет обычное значение «failed» для задачи.
- ignore_errors
-
Логический параметр, позволяющий игнорировать ошибки задачи и продолжать выполнение книги. Он не влияет на ошибки подключения.
- ignore_unreachable
-
Логический параметр, позволяющий игнорировать ошибки задачи из-за недоступного узла и продолжить выполнение книги. Это не влияет на другие ошибки задач (см. ignore_errors), но полезно для групп изменчивых/временных узлов.
- local_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
-
Ограничение количества одновременных запусков задач на уровне задачи, блока и книги задач. Это независимо от параметров forks и serial, но не может быть установлено выше этих пределов. Например, если forks установлен в 10, а throttle — в 15, максимум на 10 узлах будет производиться операция параллельно.
- timeout
-
Ограничение времени выполнения задачи, если превышен предел, Ansible прервет выполнение и завершит задачу с ошибкой.
- until
-
Это ключевое слово подразумевает цикл ‘retries`, который будет продолжаться до тех пор, пока указанное здесь условие не будет выполнено, или пока не будет достигнут предел retries.
- vars
-
Словарь/карта переменных
- when
-
Условное выражение, определяющее, будет ли выполнена итерация задачи.
- with_<lookup_plugin>
-
То же самое, что и
loop, но магически добавляет вывод любого плагина поиска для генерации списка элементов.
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/reference_appendices/playbooks_keywords.html