Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию netapp.storagegrid (версия 21.12.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 для выбора нужной конечной точки.
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

api_url

string / required

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

auth_token

string / required

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

binding_mode

string

added in netapp.storagegrid 21.9.0

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

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

Варианты:

  • "global" ← (default)
  • "ha-groups"
  • "node-interfaces"

ca_bundle

string

Промежуточный пакет сертификатов CA в конкатенированном PEM-кодировании.

Пропустите, если промежуточного CA нет.

default_service_type

string

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

Варианты:

  • "s3" ← (default)
  • "swift"

display_name

string

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

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

enable_ipv4

boolean

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

Варианты:

  • false
  • true ← (default)

enable_ipv6

boolean

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

Варианты:

  • false
  • true ← (default)

gateway_id

string

added in netapp.storagegrid 21.9.0

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

ha_groups

list / elements=string

added in netapp.storagegrid 21.9.0

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

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

node_interfaces

list / elements=dictionary

added in netapp.storagegrid 21.9.0

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

interface

string

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

node

string

Имя узла StorageGRID.

port

integer / required

TCP-порт для обслуживания трафика.

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

private_key

string

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

Требуется, если server_certificate не пусто.

secure

boolean

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

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

Варианты:

  • false
  • true ← (default)

server_certificate

string

Сертификат сервера X.509 в PEM-кодировании.

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

state

string

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

Варианты:

  • "present" ← (default)
  • "absent"

validate_certs

boolean

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

Варианты:

  • false
  • true ← (default)

Примечания

Примечание

  • Модули с префиксом 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

словарь

Возвращает информацию о конечной точке балансировщика нагрузки 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}

Авторы

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

Ссылки на сборку

  • Главная страница
  • Репозиторий (источники)

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

Spec-Zone.ru

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