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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cacheable boolean добавлено в 2.4	Варианты: no ← yes	Этот boolean преобразует переменную в фактический «факт», который также будет добавлен в кэш фактов, если включен кэширование фактов. Обычно этот модуль создает «переменные уровня хоста» и имеет гораздо более высокий приоритет, этот параметр изменяет характер и приоритет (на 7 шагов) созданной переменной. https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html#variable-precedence-where-should-i-put-a-variable Это фактически создаёт 2 копии переменной: обычную переменную «set_fact» уровня хоста с высоким приоритетом и более низкую «ansible_fact», которая доступна для сохранения через плагин кэша фактов. Это создаёт потенциально запутанное взаимодействие с `meta: clear_facts`, так как он удалит «ansible_fact», но не переменную уровня хоста.
key_value - / обязательно		Модуль `set_fact` принимает пары ключ=значение в качестве переменных для установки в области выполнения playbook. Или же принимает сложные аргументы, используя инструкцию `args:`.

Примечания

Примечание

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

См. также

include_vars – Загрузка переменных из файлов динамически в задаче: Официальная документация по модулю include_vars.
Приоритет переменных: Где следует разместить переменную?: Дополнительная информация о приоритете переменных и о том, какой тип переменной побеждает другие.

Примеры

# 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: yes

# As of Ansible 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: yes
    other_fact: no

Статус

Этот модуль гарантированно не будет иметь обратной несовместимости в будущем. [stableinterface]
Этот модуль поддерживается командой разработчиков Ansible. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке Red Hat этого модуля можно найти в этой статье базы знаний 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.8/modules/set_fact_module.html