Spec-Zone.ru › Ansible

Ключевые слова 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

Spec-Zone.ru

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