Spec-Zone.ru › Ansible

Ключевые слова плейбука

Это ключевые слова, доступные для общих объектов плейбука. Ключевые слова — один из нескольких источников настройки поведения 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API