Умолчания модулей

Если вы обнаруживаете себя многократно вызывающим один и тот же модуль с одними и теми же аргументами, может быть полезно определить значения по умолчанию для этого конкретного модуля, используя атрибут module_defaults.

Вот базовый пример:

- hosts: localhost
  module_defaults:
    file:
      owner: root
      group: root
      mode: 0755
  tasks:
    - file:
        state: touch
        path: /tmp/file1
    - file:
        state: touch
        path: /tmp/file2
    - file:
        state: touch
        path: /tmp/file3

Атрибут module_defaults можно использовать на уровнях игры, блока и задачи. Любые аргументы модуля, явно указанные в задаче, переопределят любые установленные значения по умолчанию для этого аргумента модуля:

- block:
    - debug:
        msg: "a different message"
  module_defaults:
    debug:
      msg: "a default message"

Также можно удалить ранее установленные значения по умолчанию для модуля, указав пустой словарь:

- file:
    state: touch
    path: /tmp/file1
  module_defaults:
    file: {}

Вот несколько более реалистичных вариантов использования этой функции.

Взаимодействие с API, требующим аутентификации:

- hosts: localhost
  module_defaults:
    uri:
      force_basic_auth: true
      user: some_user
      password: some_password
  tasks:
    - uri:
        url: http://some.api.host/v1/whatever1
    - uri:
        url: http://some.api.host/v1/whatever2
    - uri:
        url: http://some.api.host/v1/whatever3

Установка значения по умолчанию для региона AWS для конкретных модулей, связанных с EC2:

- hosts: localhost
  vars:
    my_region: us-west-2
  module_defaults:
    ec2:
      region: '{{ my_region }}'
    ec2_instance_facts:
      region: '{{ my_region }}'
    ec2_vpc_net_facts:
      region: '{{ my_region }}'

Группы умолчаний модулей

Ansible 2.7 добавляет функцию предварительного статуса для группирования модулей, которые используют общие наборы параметров. Это упрощает создание playbooks, интенсивно использующих модули на основе API, такие как модули облачных сервисов.

Используйте группы с module_defaults, предваряя имя группы с group/ - например, group/aws.

В playbook вы можете установить значения по умолчанию для целых групп модулей, например, установить общий регион AWS.

# example_play.yml
- hosts: localhost
  module_defaults:
    group/aws:
      region: us-west-2
  tasks:
  - aws_s3_bucket_facts:
  # now the region is shared between both facts modules
  - ec2_ami_facts:
      filters:
        name: 'RHEL*7.5*'