Управление выполнением плейбуков: стратегии и не только

Настройка размера пакета с помощью serial

По умолчанию Ansible выполняет задачи параллельно на всех хостах, соответствующих шаблону, заданному в поле hosts: каждого плейбука. Если вы хотите управлять только несколькими компьютерами одновременно, например во время последовательного обновления, с помощью ключевого слова serial можно указать, сколько хостов Ansible должен обрабатывать за один раз:

---
- name: test play
  hosts: webservers
  serial: 3
  gather_facts: False

  tasks:
    - name: first task
      command: hostname
    - name: second task
      command: hostname

В приведённом выше примере, если в группе ‘webservers’ было бы 6 хостов, Ansible полностью выполнил бы плейбук (обе задачи) на 3 хостах, прежде чем перейти к следующим 3 хостам:

PLAY [webservers] ***********************************************************************

TASK [first task] ***********************************************************************
changed: [web1]
changed: [web3]
changed: [web2]

TASK [second task] **********************************************************************
changed: [web1]
changed: [web2]
changed: [web3]

PLAY [webservers] ***********************************************************************

TASK [first task] ***********************************************************************
changed: [web4]
changed: [web5]
changed: [web6]

TASK [second task] **********************************************************************
changed: [web4]
changed: [web5]
changed: [web6]

PLAY RECAP ******************************************************************************
web1                       : ok=2    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
web2                       : ok=2    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
web3                       : ok=2    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
web4                       : ok=2    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
web5                       : ok=2    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
web6                       : ok=2    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

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

---
- name: test play
  hosts: webservers
  serial: "30%"

Если количество хостов не делится нацело на количество проходов, в последнем проходе обрабатываются оставшиеся хосты. В этом примере, если бы в группе webservers было 20 хостов, первый пакет содержал бы 6 хостов, второй — 6, третий — 6, а последний — 2 хоста.

Размеры пакетов также можно задать списком. Например:

---
- name: test play
  hosts: webservers
  serial:
    - 1
    - 5
    - 10

В приведённом выше примере первый пакет содержал бы один хост, следующий — 5 хостов, а каждый последующий пакет (если останутся хосты) — 10 хостов или все оставшиеся хосты, если их меньше 10.

Можно перечислить несколько размеров пакетов в процентах:

---
- name: test play
  hosts: webservers
  serial:
    - "10%"
    - "20%"
    - "100%"

Также можно комбинировать значения:

---
- name: test play
  hosts: webservers
  serial:
    - 1
    - 5
    - "20%"

Ограничение выполнения с помощью throttle

Ключевое слово throttle ограничивает количество рабочих процессов для конкретной задачи. Его можно задать на уровне блока или задачи. Используйте throttle для ограничения задач, которые могут сильно нагружать процессор или взаимодействуют с API, ограничивающим частоту запросов:

tasks:
- command: /path/to/cpu_intensive_command
  throttle: 1

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

Упорядочение выполнения на основе инвентаря

Ключевое слово order задаёт порядок выполнения задач на хостах. Возможные значения параметра order:

inventory:

(по умолчанию) Порядок, заданный инвентарём для выбранного набора (см. примечание ниже)

reverse_inventory:

То же, что и выше, но список возвращается в обратном порядке

sorted:

Сортировка по имени в алфавитном порядке

reverse_sorted:

Сортировка по имени в обратном алфавитном порядке

shuffle:

Случайный порядок при каждом запуске

Выполнение на одном компьютере с помощью run_once

Чтобы задача выполнялась только на первом хосте в пакете, задайте для неё значение run_once, равное true:

---
# ...

  tasks:

    # ...

    - command: /opt/application/upgrade_db.py
      run_once: true

    # ...

Ansible выполняет эту задачу на первом хосте в текущем пакете и применяет все результаты и факты ко всем хостам того же пакета. Этот подход похож на добавление к задаче условия вида:

- command: /opt/application/upgrade_db.py
  when: inventory_hostname == webservers[0]

Однако при использовании run_once результаты применяются ко всем хостам. Чтобы выполнить задачу на определённом хосте, а не на первом хосте в пакете, делегируйте задачу:

- command: /opt/application/upgrade_db.py
  run_once: true
  delegate_to: web01.example.org

Как и при любом делегировании, действие выполняется на делегированном хосте, но сведения в задаче по-прежнему относятся к исходному хосту.