Плагины кэширования

Включение плагинов кэширования фактов

Кэширование фактов всегда включено. Однако одновременно может быть активен только один плагин кэширования фактов. Выбрать плагин для кэширования фактов можно в конфигурации Ansible, задав переменную среды:

export ANSIBLE_CACHE_PLUGIN=jsonfile

или в файле ansible.cfg:

[defaults]
fact_caching=redis

Если плагин кэширования входит в коллекцию, укажите его полное имя:

[defaults]
fact_caching = namespace.collection_name.cache_plugin_name

Чтобы включить собственный плагин кэширования, сохраните его в одном из каталогов, настроенных в ansible.cfg, или в коллекции, а затем укажите его полное имя (FQCN).

Также необходимо настроить другие параметры, специфичные для каждого плагина. Подробнее см. документацию соответствующего плагина или конфигурацию Ansible.

Включение плагинов кэширования инвентаризации

По умолчанию кэширование инвентаризации отключено. Чтобы кэшировать данные инвентаризации, необходимо включить кэширование инвентаризации, а затем выбрать нужный плагин кэширования. Кэширование поддерживают не все плагины инвентаризации, поэтому ознакомьтесь с документацией используемых плагинов инвентаризации. Включить кэширование инвентаризации можно с помощью переменной среды:

export ANSIBLE_INVENTORY_CACHE=True

или в файле ansible.cfg:

[inventory]
cache=True

или в файле конфигурации, если плагин инвентаризации принимает источник конфигурации YAML:

# dev.aws_ec2.yaml
plugin: aws_ec2
cache: True

Одновременно может быть активен только один плагин кэширования инвентаризации. Его можно указать с помощью переменной среды:

export ANSIBLE_INVENTORY_CACHE_PLUGIN=jsonfile

или в файле ansible.cfg:

[inventory]
cache_plugin=jsonfile

или в файле конфигурации, если плагин инвентаризации принимает источник конфигурации YAML:

# dev.aws_ec2.yaml
plugin: aws_ec2
cache_plugin: jsonfile

Чтобы кэшировать инвентаризацию с помощью собственного плагина из пути поиска плагинов, следуйте руководству разработчика по плагинам кэширования.

Чтобы кэшировать инвентаризацию с помощью плагина кэширования из коллекции, укажите его полное имя (FQCN):

[inventory]
cache_plugin=collection_namespace.collection_name.cache_plugin

Если включить кэширование для плагинов инвентаризации, не выбрав отдельный плагин кэширования инвентаризации, Ansible будет кэшировать инвентаризацию с помощью настроенного плагина кэширования фактов. Подробнее см. документацию соответствующего плагина инвентаризации или конфигурацию Ansible.

Использование плагинов кэширования

После включения плагины кэширования используются автоматически.

Список плагинов

Чтобы просмотреть список доступных плагинов, используйте ansible-doc -t cache -l. Чтобы ознакомиться с документацией и примерами для конкретного плагина, используйте ansible-doc -t cache <plugin name>.