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

Установка размера пакета с serial

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

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

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

В приведенном выше примере, если у нас было 6 хостов в группе «webservers», 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%"

Если количество хостов не делится равномерно на количество проходов, последний проход содержит остаток. В этом примере, если у вас было 20 хостов в группе webservers, первый пакет будет содержать 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 контролирует порядок выполнения хостов. Возможные значения для порядка:

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

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