Spec-Zone.ru › Ansible 2.6

set_fact - Установка фактов хоста из задачи

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Статус
  • Техническое обслуживание
    • Поддержка
    • Автор

Краткое описание

  • Этот модуль позволяет устанавливать новые переменные. Переменные устанавливаются на каждом хосте аналогично фактам, найденным модулем setup.
  • Эти переменные будут доступны последующим задачам во время выполнения ansible-playbook, но не будут сохранены между выполнением, даже если вы используете кэш фактов.
  • В соответствии со стандартными правилами приоритета переменных Ansible, многие другие типы переменных имеют более высокий приоритет, поэтому это значение может быть переопределено. Для получения дополнительной информации см. Руководство по приоритету переменных.
  • Этот модуль также поддерживается для целевых платформ Windows.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cacheable
bool

(добавлен в версии 2.4)
    Варианты:
  • no ←
  • yes
Этот булевый параметр указывает, будет ли устанавливаемый факт добавлен в кэш фактов, если кэширование фактов включено.
key_value
обязательно
Модуль set_fact принимает пары ключ=значение в качестве переменных для установки в области действия playbook. Или, как альтернативу, принимает сложные аргументы, используя args: оператор.

Примечания

Примечание

  • Запись var=value может создавать только строки или булевы значения. Если вам нужно создавать списки/массивы или словари/хеши, используйте var: [val1, val2].
  • Этот модуль также поддерживается для целевых платформ Windows.
  • Поскольку ‘cacheable’ теперь является параметром модуля, ‘cacheable’ больше не является допустимым именем факта с версии 2.4.

Примеры

# Example setting host facts using key=value pairs, note that this always creates strings or booleans
- set_fact: one_fact="something" other_fact="{{ local_var }}"

# Example setting host facts using complex arguments
- set_fact:
     one_fact: something
     other_fact: "{{ local_var * 2 }}"
     another_fact: "{{ some_registered_var.results | map(attribute='ansible_facts.some_fact') | list }}"

# Example setting facts so that they will be persisted in the fact cache
- set_fact:
    one_fact: something
    other_fact: "{{ local_var * 2 }}"
    cacheable: true

# As of 1.8, Ansible will convert boolean strings ('true', 'false', 'yes', 'no')
# to proper boolean values when using the key=value syntax, however it is still
# recommended that booleans be set using the complex argument style:
- set_fact:
    one_fact: true
    other_fact: false

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики гарантируют отсутствие несовместимых изменений интерфейса.

Техническое обслуживание

Этот модуль помечен как core, что означает, что он поддерживается Командой разработки Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых Командой разработки Ansible, см. здесь.

Поддержка

Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, пожалуйста, обратитесь к этой статье базы знаний

Автор

  • Dag Wieers (@dagwieers)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/set_fact_module.html

Spec-Zone.ru

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