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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: community.general.aerospike_migrations.

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

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

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

Параметры

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

Атрибуты

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

Примеры

# 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/aerospike_migrations_module.html