Spec-Zone.ru › Ansible 2.5

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

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Статус
    • Поддержка
    • Автор

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cacheable
(добавлен в 2.4)
Значение по умолчанию:
no
Этот логический параметр указывает, будет ли устанавливаемый факт добавлен в кэш фактов, если кэширование фактов включено.
key_value
обязательно
Значение по умолчанию:
None
Модуль set_fact принимает пары ключ=значение в качестве переменных для установки в рамках задачи. Также он может принимать сложные аргументы, используя оператор 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, что означает, что разработчики этого модуля гарантируют, что не будет внесено обратной совместимости.

Поддержка

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

Автор

  • 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.5/modules/set_fact_module.html

Spec-Zone.ru

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