Модуль hitachivantara.vspone_block.sds_block.hv_sds_block_cluster — управление кластерами VSP One SDS Block и Cloud system.

Примечание

Этот модуль входит в коллекцию hitachivantara.vspone_block (версия 4.8.1).

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

Для установки используйте: ansible-galaxy collection install hitachivantara.vspone_block. Для использования этого модуля необходимы дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hitachivantara.vspone_block.sds_block.hv_sds_block_cluster.

Новое в hitachivantara.vspone_block 4.1.0

Краткое описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

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

Этот модуль позволяет добавлять узел хранения в кластер и удалять узел хранения из кластера.
Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/sds_block_direct/sdsb_cluster.yml

Требования

На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Информация, необходимая для установления соединения с системой хранения данных.
address string / обязательный	IP-адрес или имя хоста системы хранения данных.
connection_type string	Тип соединения с системой хранения данных. Варианты: `"direct"` ← (по умолчанию)
password string / обязательный	Пароль для аутентификации. Это обязательное поле.
username string / обязательный	Имя пользователя для аутентификации. Это обязательное поле.
spec dictionary	Спецификация узла хранения, который необходимо добавить в кластер или удалить из него.
config_file_location string	Каталог, в который загружается файл конфигурации кластера. Это обязательное поле, если значение поля state равно `download_config_file`. Обязательно для задач «Загрузить файл конфигурации кластера» / «Создать файл конфигурации кластера и затем загрузить его» / «Создать файл конфигурации кластера для разных типов файлов экспорта (AddStorageNodes)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (AddDrives)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (только AWS)».
config_parameter_setting_mode boolean	Это поле действительно, если значение поля state равно `stop_storage_cluster`. Указывает, следует ли запускать кластер хранения в режиме настройки параметров конфигурации после завершения работы. Если указано true, кластер узлов хранения запустится в режиме настройки параметров конфигурации. Если для force указано true, указать true здесь нельзя. Указывайте `true` для этого параметра только по инструкции в документации или службы поддержки клиентов. Варианты: `false` ← (по умолчанию) `true`
configuration_file string	Файл определения конфигурации, который необходимо передать кластеру хранения. Если это поле указано, поле storage_nodes, если оно присутствует, игнорируется. Обязательно для задач «Добавить узел хранения в кластер с помощью файла конфигурации» / «Добавить узел хранения в кластер хранения в облаке AWS».
controller_id string	Идентификатор узла контроллера хранения, для которого параметр балансировки емкости будет изменен на значение, указанное атрибутом is_capacity_balancing_enabled. Обязательно для задачи «Изменить настройки балансировки емкости контроллера в кластере».
export_file_type string	Указывает тип файла конфигурации, который будет сформирован для загрузки. Это поле действительно, если значение поля state равно `download_config_file`. Обязательно для задач «Создать файл конфигурации кластера для разных типов файлов экспорта (AddStorageNodes)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (AddDrives)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (только AWS)». Варианты: `"normal"` ← (по умолчанию) `"add_storage_nodes"` `"add_drives"` `"replace_storage_node"`
force boolean	Это поле действительно, если значение поля state равно `stop_storage_cluster`. Указывает, следует ли принудительно выполнить операцию. Если указано true, операция выполняется принудительно. Указывайте `true` для этого параметра только по инструкции в документации или службы поддержки клиентов. Если для reboot или config_parameter_setting_mode указано true, здесь нельзя указывать true. Варианты: `false` ← (по умолчанию) `true`
is_capacity_balancing_enabled boolean	Включает или отключает балансировку емкости. Если указано true, балансировка емкости применяется. Если указано false, балансировка емкости не применяется. Если controller_id не указан, настройка применяется к кластеру, в противном случае — к узлу контроллера. Обязательно для задач «Изменить настройки балансировки емкости кластера» / «Изменить настройки балансировки емкости контроллера в кластере». Варианты: `false` `true`
machine_image_id string	Идентификатор образа машины, который будет использоваться при добавлении или замене узла хранения. Обязательно для задач «Добавить узел хранения в кластер хранения в облаке Azure» / «Создать файл конфигурации кластера для разных типов файлов экспорта (AddStorageNodes)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (только AWS)».
no_of_drives integer	Количество дисков, устанавливаемых на каждом узле хранения после добавления дисков. Указанное количество дисков применяется ко всем узлам хранения. Это обязательное поле, если значение export_file_type равно `add_drives`. Обязательно для задачи «Создать файл конфигурации кластера для разных типов файлов экспорта (AddDrives)».
node_id string	Идентификатор узла хранения, который будет удален или заменен. Это поле действительно, если значение поля state равно `remove_storage_node` и `replace_storage_node`. Обязательно для задачи «Удалить узел хранения из кластера по идентификатору узла хранения».
node_name string	Имя узла хранения, который будет удален. Это поле действительно, если значение поля state равно `remove_storage_node`. Обязательно для задачи «Удалить узел хранения из кластера по имени узла хранения».
reboot boolean	Это поле действительно, если значение поля state равно `stop_storage_cluster`. Указывает, следует ли перезапустить кластер хранения. Укажите false, чтобы остановить его, или true, чтобы перезапустить. Если для force указано true, указать true здесь нельзя. Варианты: `false` ← (по умолчанию) `true`
refresh boolean	Следует ли создавать файл конфигурации кластера. Это поле действительно, если значение поля state равно `download_config_file`. Обязательно для задач «Создать файл конфигурации кластера и затем загрузить его» / «Создать файл конфигурации кластера для разных типов файлов экспорта (AddStorageNodes)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (AddDrives)» / «Создать файл конфигурации кластера для разных типов файлов экспорта (только AWS)». Варианты: `false` ← (по умолчанию) `true`
setup_user_password string	Пароль пользователя настройки. Необязательный параметр для задач «Добавить узел хранения в кластер с помощью файла конфигурации» / «Добавить узел хранения в кластер с использованием переменных Ansible».
should_recover_single_node boolean	Следует ли восстанавливать отдельный узел. Это поле действительно, если значение поля state равно `download_config_file`, а export_file_type равно `replace_storage_node` для платформы GCP. Варианты: `false` `true`
storage_nodes list / элементы=dictionary	Список объектов узлов хранения.
compute_networks list / элементы=dictionary / обязательный	Информация об управляющей сети. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
compute_network_gateway string	Шлюз IPv4 по умолчанию для вычислительной сети. Если значение не указано, будет использоваться информация о шлюзе другого вычислительного узла кластера. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
compute_network_ip string / обязательный	IP-адрес (IPv4) узла хранения для вычислительной сети. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
compute_network_ipv6_gateway string	Шлюз IPv6 по умолчанию для вычислительной сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
compute_network_ipv6_globals list / элементы=string	Глобальные адреса IPv6 вычислительной сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
compute_network_ipv6_subnet_prefix string	Префикс подсети IPv6 вычислительной сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
compute_network_mtu_size integer	Размер MTU вычислительной сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». По умолчанию: `9000`
compute_network_subnet string	Подсеть IPv4 вычислительной сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». По умолчанию: `"255.255.255.0"`
compute_port_protocol string	Протокол вычислительного порта. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». Варианты: `"iSCSI"` ← (по умолчанию) `"NVMe/TCP"`
is_compute_network_ipv6_mode boolean	Использует ли вычислительная сеть режим IPv6. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». Варианты: `false` ← (по умолчанию) `true`
control_internode_network dictionary	Информация об управляющей и межузловой сетях.
control_internode_network_route_destinations list / элементы=string	Сети назначения, которые необходимо задать в таблице маршрутизации управляющего или межузлового порта. Можно указать до четырех сетевых адресов или IP-адресов. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». По умолчанию: `["default"]`
control_internode_network_route_gateways list / элементы=string	Шлюзы IPv4, которые необходимо задать в таблице маршрутизации управляющего или межузлового порта. Если значение не указано, будет использоваться информация о шлюзе другого узла кластера. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
control_internode_network_route_interfaces list / элементы=string	Имя интерфейса, которое необходимо задать в таблице маршрутизации управляющего или межузлового порта. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». По умолчанию: `["control"]`
control_network dictionary / обязательный	Информация об управляющей сети. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
control_network_ip string / обязательный	IP-адрес (IPv4) узла хранения для управляющей сети. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
control_network_mtu_size integer	Размер MTU управляющей сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». По умолчанию: `1500`
control_network_subnet string	Подсеть IPv4 управляющей сети. Необязательный параметр для задачи «Добавить узел хранения в кластер с использованием переменных Ansible». По умолчанию: `"255.255.255.0"`
fault_domain_name string / обязательный	Имя домена отказоустойчивости, к которому относится узел хранения. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
host_name string / обязательный	Имя узла хранения. Используется в качестве имени хоста узла хранения. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».
internode_network dictionary / обязательный	Информация об управляющей сети.
internode_network_ip string / обязательный	IP-адрес (IPv4) узла хранения для межузловой сети. Обязательно для задачи «Добавить узел хранения в кластер с использованием переменных Ansible».

internode_network_mtu_size integer	Размер MTU межузловой сети. Необязательный параметр для задачи добавления узла хранения в кластер с использованием переменных Ansible. По умолчанию: `9000`
internode_network_subnet string	Подсеть IPv4 межузловой сети. Необязательный параметр для задачи добавления узла хранения в кластер с использованием переменных Ansible. По умолчанию: `"255.255.255.0"`
is_cluster_master_role boolean	Является ли узел главным узлом кластера. Обязательный параметр для задачи добавления узла хранения в кластер с использованием переменных Ansible. Возможные значения: `false` ← (по умолчанию) `true`
number_of_fc_target_port integer	Количество целевых портов FC. Необязательный параметр для задачи добавления узла хранения в кластер с использованием переменных Ansible. По умолчанию: `0`
system_requirement_file string	Путь к файлу системных требований, описывающему требования, которые необходимо обновить. Это поле действительно и обязательно, если значение поля state — `system_requirement_file_present`.
template_s3_url string	URL (https) Amazon S3, где во время каждой операции обслуживания будет храниться файл конфигурации виртуальной машины. Этот параметр обязателен для облачной модели AWS, если значение поля state — `download_config_file` и refresh имеет значение true. Если параметр указан для других платформ, он игнорируется. Обязателен для задачи создания файла конфигурации кластера для различных типов файлов экспорта (только AWS).
vm_configuration_file_s3_uri string	URI (начинающийся с «s3») Amazon S3, где хранится файл конфигурации виртуальной машины VMConfigurationFile.yml. Если имя сегмента содержит точку (.), URI указать нельзя. Этот параметр обязателен для облачной модели AWS, если значение поля state — `add_storage_node`. Если параметр указан для других платформ, он игнорируется. Обязателен для задачи добавления узла хранения в кластер хранения в облаке AWS.
state string	Требуемое состояние кластера хранения. Возможные значения: `"present"` ← (по умолчанию) `"add_storage_node"` `"remove_storage_node"` `"download_config_file"` `"stop_removing_storage_node"` `"replace_storage_node"` `"system_requirement_file_present"` `"stop_storage_cluster"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Определяет, должен ли модуль выполняться в режиме проверки.

Примечания

Примечание

Действия по замене узла на платформе GCP 1) Перед заменой узел должен находиться в состоянии блокировки. 2) Создайте файл конфигурации с помощью модуля hv_sds_block_cluster, указав state со значением download_config_file, export_file_type со значением replace_storage_node и идентификатор существующего узла. 3) Запустите файл Terraform, созданный на предыдущем шаге, чтобы заменить узел (существующий узел будет удален из GCP). 4) Создайте файл конфигурации с помощью модуля hv_sds_block_cluster, указав state со значением download_config_file, export_file_type со значением replace_storage_node и recover_single_node со значением true. 5) Запустите файл Terraform, созданный на предыдущем шаге, чтобы добавить новый узел в GCP (новый узел будет добавлен в GCP). 6) Добавьте новый узел в кластер с помощью модуля hv_sds_block_cluster, указав state со значением replace_storage_node и node_id, равным идентификатору существующего узла.
Действия по замене узла на платформе AWS 1) Перед заменой узел должен находиться в состоянии блокировки. 2) Создайте файл конфигурации с помощью модуля hv_sds_block_cluster, указав state со значением download_config_file, export_file_type со значением replace_storage_node и идентификатор существующего узла. 3) Передайте файл конфигурации в расположение S3, указанное в vm_configuration_file_s3_uri. 4) Добавьте новый узел в кластер с помощью модуля hv_sds_block_cluster, указав state со значением replace_storage_node, node_id, равным идентификатору существующего узла, и machine_image_id, равным идентификатору AMI.
Действия по замене узла на платформе Azure 1) Перед заменой узел должен находиться в состоянии блокировки. 2) Добавьте новый узел в кластер с помощью модуля hv_sds_block_cluster, указав state со значением replace_storage_node, node_id, равным идентификатору существующего узла, и machine_image_id, равным идентификатору образа виртуальной машины.
Действия по замене узла на локальной платформе 1) Перед заменой узел должен находиться в состоянии блокировки. 2) Добавьте новый узел в кластер с помощью модуля hv_sds_block_cluster, указав state со значением replace_storage_node и node_id, равным идентификатору существующего узла.
Добавление узла хранения в кластер с помощью файла конфигурации
1. Файл конфигурации можно скачать, запустив плейбук Download cluster configuration file.
1. Эта задача поддерживается на Bare Metal, Microsoft Azure и Google Cloud, но не в AWS.
Добавление узла хранения в кластер с использованием переменных Ansible
1. Эта задача поддерживается на Bare Metal и Google Cloud, но не в AWS или Microsoft Azure.
Удаление узла хранения из кластера по идентификатору узла хранения
1. Эта задача поддерживается на Bare Metal, Google Cloud (только для узлов хранения, добавление которых завершилось ошибкой во время задачи Add Storage Nodes) и Microsoft Azure, но не в AWS.
Удаление узла хранения из кластера по имени узла хранения
1. Эта задача поддерживается на Bare Metal, Google Cloud (только для узлов хранения, добавление которых завершилось ошибкой во время задачи Add Storage Nodes) и Microsoft Azure, но не в AWS.
Загрузка файла конфигурации кластера
1. Поддерживается на Bare Metal, Google Cloud и Microsoft Azure. Не поддерживается в AWS.
Создание файла конфигурации кластера с последующей загрузкой
1. Поддерживается на Bare Metal, Google Cloud и Microsoft Azure. Не поддерживается в AWS.
Создание файла конфигурации кластера для различных типов файлов экспорта (AddStorageNodes)
1. Поддерживается на Bare Metal, Google Cloud и Microsoft Azure. Не поддерживается в AWS.
Создание файла конфигурации кластера для различных типов файлов экспорта (AddDrives)
1. Поддерживается на Bare Metal, Google Cloud и Microsoft Azure. Не поддерживается в AWS.
Создание файла конфигурации кластера для различных типов файлов экспорта (только AWS)
1. Эта задача предназначена только для AWS и требует дополнительного параметра template_s3_url.

Примеры

- name: Add storage node to the cluster with the configuration file
  hitachivantara.vspone_block.sds_block.hv_sds_block_cluster:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
      state: "add_storage_node"
      spec:
        configuration_file: "/tmp/download2/SystemConfigurationFile.csv"
        setup_user_password: "CHANGE_ME_SET_YOUR_PASSWORD"

- name: Add storage node to the cluster using ansible variables
  hitachivantara.vspone_block.sds_block.hv_sds_block_cluster:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
      state: "add_storage_node"
      spec:
        setup_user_password: "CHANGE_ME_SET_YOUR_PASSWORD"
        storage_nodes:
          - host_name: "SDSB-NODE6"
            fault_domain_name: "SC01-PD01-FD01"
            is_cluster_master_role: false
            control_network:
              control_network_ip: "10.76.34.106"
            internode_network:
              internode_network_ip: "192.168.210.106"
            control_internode_network:
              control_internode_network_route_destinations:
                - "default"
              control_internode_network_route_gateways:
                - "10.76.34.1"
              control_internode_network_route_interfaces:
                - "control"
            compute_networks:
              - compute_network_ip: "10.76.27.106"
                compute_network_gateway: "10.76.27.1"

- name: Remove storage node from the cluster by storage node ID
  hitachivantara.vspone_block.sds_block.hv_sds_block_cluster:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
      state: "remove_storage_node"
      spec:
        node_id: "8deb71e9-cdba-4002-94bc-c2f6f7a1bee7"

- name: Remove storage node from the cluster by storage node name
  hitachivantara.vspone_block.sds_block.hv_sds_block_cluster:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
      state: "remove_storage_node"
      spec:
        node_name: "vssbesxi1"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
storage_nodes dictionary	Сообщение об успешном выполнении или сбое задачи. Возвращается: всегда
clusters string	Сообщение об успешном выполнении или сбое задачи. Возвращается: при успешном выполнении Пример: `"Successfully downloaded SystemConfigurationFile.csv in the directory /tmp/1752598196036657707"`

Авторы

Hitachi Vantara LTD (@hitachi-vantara)

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

© 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/hitachivantara/vspone_block/sds_block.hv_sds_block_cluster_module.html