Модуль community.general.aerospike_migrations — проверка или ожидание миграций между узлами

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.aerospike_migrations.

Краткое описание
Параметры
Атрибуты
Примеры

Краткое описание

Модуль можно использовать для проверки наличия миграций в кластере. Это упрощает последовательное обновление узлов Aerospike.
Если ожидание завершения миграций не требуется, просто выполняйте опрос до тех пор, пока порт 3000 не станет доступен или asinfo -v status не вернёт состояние ok.

Параметры

Параметр	Комментарии
connect_timeout целое число	Сколько времени пытаться установить соединение, прежде чем прекратить попытки (миллисекунды). По умолчанию: `1000`
consecutive_good_checks целое число	Сколько раз кластер должен подряд сообщить об отсутствии миграций, прежде чем вернуть Ansible состояние OK? По умолчанию: `3`
fail_on_cluster_change логический	Завершить работу с ошибкой, если ключ кластера изменится. Если кто-то другой изменяет кластер, может потребоваться завершить работу с ошибкой. Варианты: `false` `true` ← (по умолчанию)
host строка	Узел, используемый в качестве начального для информационного соединения. По умолчанию: `"localhost"`
local_only логический / обязательный	Нужно ли перед завершением проверять наличие миграций только на локальном узле или дождаться завершения миграций на всех узлах кластера? Варианты: `false` `true`
migrate_rx_key строка	Ключ метрики, используемый для определения наличия оставшихся миграций rx. Его можно изменить для обеспечения обратной совместимости. По умолчанию: `"migrate_rx_partitions_remaining"`
migrate_tx_key строка	Ключ метрики, используемый для определения наличия оставшихся миграций tx. Его можно изменить для обеспечения обратной совместимости. По умолчанию: `"migrate_tx_partitions_remaining"`
min_cluster_size целое число	Проверка завершается неудачей, пока не будет достигнут заданный размер кластера или пока не закончатся попытки. По умолчанию: `1`
port целое число	Порт для подключения к Aerospike (порт службы). По умолчанию: `3000`
sleep_between_checks целое число	Пауза между проверками (секунды). По умолчанию: `60`
target_cluster_size целое число	Если версия всех сборок Aerospike в кластере выше 4.3, используется информационная команда `cluster-stable`. В этой команде можно указать целевой размер кластера, но это необязательно. Если вы не хотите использовать этот параметр, можно по-прежнему полагаться на `min_cluster_size`. Если этот параметр указан для кластера, в котором хотя бы один узел имеет версию ниже 4.3, он игнорируется, пока минимальная версия не достигнет 4.3.
tries_limit целое число	Сколько раз выполнять опрос, прежде чем прекратить попытки и завершить работу с ошибкой? По умолчанию: `300`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме `check_mode` и возвращать прогнозируемый статус изменения, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о том, что, возможно, требуется изменить в `check_mode`).

Примеры

# check for migrations on local node
- name: Wait for migrations on local node before proceeding
  community.general.aerospike_migrations:
    host: "localhost"
    connect_timeout: 2000
    consecutive_good_checks: 5
    sleep_between_checks: 15
    tries_limit: 600
    local_only: false

# example playbook:
- name: Upgrade aerospike
  hosts: all
  become: true
  serial: 1
  tasks:
    - name: Install dependencies
      ansible.builtin.apt:
        name:
          - python
          - python-pip
          - python-setuptools
        state: latest
    - name: Setup aerospike
      ansible.builtin.pip:
        name: aerospike
# check for migrations every (sleep_between_checks)
# If at least (consecutive_good_checks) checks come back OK in a row, then return OK.
# Will exit if any exception, which can be caused by bad nodes,
# nodes not returning data, or other reasons.
# Maximum runtime before giving up in this case will be:
# Tries Limit * Sleep Between Checks * delay * retries
    - name: Wait for aerospike migrations
      community.general.aerospike_migrations:
        local_only: true
        sleep_between_checks: 1
        tries_limit: 5
        consecutive_good_checks: 3
        fail_on_cluster_change: true
        min_cluster_size: 3
        target_cluster_size: 4
      register: migrations_check
      until: migrations_check is succeeded
      changed_when: false
      delay: 60
      retries: 120
    - name: Another thing
      ansible.builtin.shell: |
        echo foo
    - name: Reboot
      ansible.builtin.reboot:

Авторы

Albert Autin (@Alb0t)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/aerospike_migrations_module.html