Spec-Zone.ru › Ansible

Модуль netapp.storagegrid.na_sg_grid_gateway — управление конечными точками балансировщика нагрузки (шлюза) в StorageGRID.

Примечание

Этот модуль входит в коллекцию netapp.storagegrid (версия 21.16.0).

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

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

Чтобы использовать её в плейбуке, укажите: netapp.storagegrid.na_sg_grid_gateway.

Добавлено в netapp.storagegrid 21.7.0

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

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

  • Создание или обновление конечных точек балансировщика нагрузки в StorageGRID.
  • Модуль является идемпотентным, если параметр private_key не указан.
  • Модуль находит существующую конфигурацию по параметрам port и display_name.
  • Если существует несколько конечных точек балансировщика нагрузки с одинаковыми портом и отображаемым именем, используйте gateway_id, чтобы выбрать нужную конечную точку.

Параметры

Параметр

Комментарии

api_url

string / обязательный

URL REST API узла администрирования StorageGRID.

auth_token

string / обязательный

Токен авторизации для запроса API

binding_mode

string

добавлено в netapp.storagegrid 21.9.0

Режим привязки, ограничивающий доступность конечной точки балансировщика нагрузки.

Для режима привязки, отличного от global, требуется StorageGRID версии 11.5 или более поздней.

Варианты:

  • "global" ← (по умолчанию)
  • "ha-groups"
  • "node-interfaces"

ca_bundle

string

Связка промежуточных сертификатов CA в формате PEM, объединённых в один файл.

Не указывайте, если промежуточный сертификат CA отсутствует.

closed_on_untrusted_client_network

boolean

добавлено в netapp.storagegrid 21.16.0

Следует ли закрыть порт в недоверенной клиентской сети.

Варианты:

  • false
  • true

default_service_type

string

Тип службы, трафик которой будет передаваться через балансировщик нагрузки.

Варианты:

  • "s3" ← (по умолчанию)
  • "swift"
  • "management"

display_name

string

Отображаемое имя конфигурации.

Этот параметр можно изменить, если также указан gateway_id.

enable_grid_manager

boolean

добавлено в netapp.storagegrid 21.14.0

Следует ли использовать привязку порта для трафика Grid Manager.

Варианты:

  • false
  • true

enable_ipv4

boolean

Указывает, следует ли принимать соединения по IPv4.

Варианты:

  • false
  • true ← (по умолчанию)

enable_ipv6

boolean

Указывает, следует ли принимать соединения по IPv6.

Варианты:

  • false
  • true ← (по умолчанию)

enable_tenant_manager

boolean

добавлено в netapp.storagegrid 21.14.0

Следует ли использовать привязку порта для трафика Tenant Manager.

Варианты:

  • false
  • true

gateway_id

string

добавлено в netapp.storagegrid 21.9.0

Идентификатор конечной точки балансировщика нагрузки.

ha_groups

list / элементы=string

добавлено в netapp.storagegrid 21.9.0

Список групп высокой доступности StorageGRID, заданных по имени или UUID, к которым привязывается конечная точка балансировщика нагрузки.

Параметр игнорируется, если binding_mode=ha-groups не задан.

node_interfaces

list / элементы=dictionary

добавлено в netapp.storagegrid 21.9.0

Список интерфейсов узлов StorageGRID, к которым привязывается конечная точка балансировщика нагрузки.

interface

string

Интерфейс для привязки. eth0 соответствует сети Grid, eth1 — сети администрирования, а eth2 — клиентской сети.

node

string

Имя узла StorageGRID.

node_type

string

добавлено в netapp.storagegrid 21.14.0

Список типов узлов для привязки.

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

Тип adminNode включает основные и дополнительные узлы администрирования.

Варианты:

  • "adminNode"
  • "apiGatewayNode"

port

integer / обязательный

Порт TCP для обработки трафика.

Этот параметр нельзя изменить после создания конечной точки балансировщика нагрузки.

private_key

string

Закрытый ключ сертификата в формате PEM.

Обязателен, если server_certificate не пуст.

secure

boolean

Определяет, обрабатывает ли конечная точка балансировщика нагрузки трафик HTTP или HTTPS.

Этот параметр нельзя изменить после создания конечной точки балансировщика нагрузки.

Варианты:

  • false
  • true ← (по умолчанию)

server_certificate

string

Сертификат сервера X.509 в формате PEM.

Не указывайте, если используются сертификаты по умолчанию.

state

string

Следует ли настроить указанную конечную точку балансировщика нагрузки.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

validate_certs

boolean

Следует ли проверять сертификаты HTTPS?

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Модули с префиксом na_sg предназначены для управления NetApp StorageGRID.

Примеры

- name: Create and Upload Certificate to a Gateway Endpoint with global binding
  netapp.storagegrid.na_sg_grid_gateway:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    displayName: "FabricPool Endpoint"
    port: 10443
    secure: true
    enable_ipv4: true
    enable_ipv6: true
    default_service_type: "s3"
    server_certificate: |
      -----BEGIN CERTIFICATE-----
      MIIC6DCCAdACCQC7l4WukhKD0zANBgkqhkiG9w0BAQsFADA2..swCQYDVQQGEwJB
      BAMMHnNnYW4wMS5kZXYubWljcm9icmV3Lm5ldGFwcC5hdTCC..IwDQYJKoZIhvcN
      AQEBBQADggEPADCCAQoCggEBAMvjm9I35lmKcC7ITVL8+QiZ..lvdkbfZCUQrfdy
      71inP+XmPjs0rnkhICA9ItODteRcVlO+t7nDTfm7HgG0mJFk..m0ffyEYrcx24qu
      S7gXYQjRsJmrep1awoaCa20BMGuqK2WKI3IvZ7YiT22qkBqK..+hIFffX6u3Jy+B
      77pR6YcATtpMHW/AaOx+OX9l80dIRsRZKMDxYQ==
      -----END CERTIFICATE-----
    private_key: |
      -----BEGIN PRIVATE KEY-----
      MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIB..DL45vSN+ZZinAu
      L25W0+cz1Oi69AKkI7d9nbFics2ay5+7o+4rKqf3en2R4MSx..vy+iDlOmATib5O
      x8TN5pJ9AgMBAAECggEADDLM8tHXXUoUFihzv+BUwff8p8Yc..cXFcSes+xTd5li
      po8lNsx/v2pQx4ByBkuaYLZGIEXOWS6gkp44xhIXgQKBgQD4..7862u5HLbmhrV3
      vs8nC69b3QKBgQDacCD8d8JpwPbg8t2VjXM3UvdmgAaLUfU7..DWV+W3jqzmDOoN
      zWVgPbPNj0UmzvLDbgxLoxe77wjn2BHsAJVAfJ9VeQKBgGqF..gYO+wHR8lJUoa5
      ZEe8Upy2oBtvND/0dnwO2ym2FGsBJN0Gr4NKdG5vkzLsthKk..Rm0ikwEUOUZQKE
      K8J5yEVeo9K2v3wggtq8fYn6
      -----END PRIVATE KEY-----
    validate_certs: false

- name: Create a HTTP Gateway Endpoint with HA Group Binding
  netapp.storagegrid.na_sg_grid_gateway:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    displayName: "App Endpoint 1"
    port: 10501
    secure: false
    enable_ipv4: true
    enable_ipv6: true
    default_service_type: "s3"
    binding_mode: ha-groups
    ha_groups: site1_ha_group
    validate_certs: false

- name: Create a HTTP Gateway Endpoint with Node Interface Binding
  netapp.storagegrid.na_sg_grid_gateway:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    displayName: "App Endpoint 2"
    port: 10502
    secure: false
    enable_ipv4: true
    enable_ipv6: true
    default_service_type: "s3"
    binding_mode: node-interfaces
    node_interfaecs:
      - node: SITE1_ADM1
        interface: eth2
      - node: SITE2_ADM1
        interface: eth2
    validate_certs: false

- name: Delete Gateway Endpoint
  netapp.storagegrid.na_sg_grid_gateway:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    displayName: "App Endpoint 2"
    port: 10502
    default_service_type: "s3"
    validate_certs: false

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

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

Ключ

Описание

resp

dictionary

Возвращает информацию о конечной точке балансировщика нагрузки StorageGRID.

Возвращается: при успешном выполнении

Пример: {"accountId": "0", "certSource": "plaintext", "defaultServiceType": "s3", "displayName": "ansibletest-secure", "enableIPv4": true, "enableIPv6": true, "id": "ffffffff-ffff-ffff-ffff-ffffffffffff", "plaintextCertData": {"caBundleEncoded": "-----BEGIN CERTIFICATE-----MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELM...-----END CERTIFICATE-----", "metadata": {"...": null}, "serverCertificateEncoded": "-----BEGIN CERTIFICATE-----MIIC6DCCAdACCQC7l4WukhKD0zANBgkqhkiG9w0BAQsFADA2MQswCQYDVQQGE...-----END CERTIFICATE-----"}, "port": 10443, "secure": true}

Авторы

  • Команда NetApp Ansible (@jkandati)

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

  • Домашняя страница
  • Репозиторий (исходный код)

© 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/netapp/storagegrid/na_sg_grid_gateway_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API