Доступно в редакциях:  Ultimate/EE, SE+

Входит в расширения: Интеграция с провайдерами для частной инфраструктуры

Стадия жизненного цикла модуля: General Availability

В модуле реализован 1 алерт.

Модуль не включен по умолчанию в каком-либо наборе модулей.

Как явно включить или отключить модуль...

Явно включить или выключить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse. В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль cloud-provider-zvirt, включите (или выключите) переключатель «Модуль включен». Сохраните изменения.

    Пример:

    Интерфейс включения и выключения модуля

  • С помощью Deckhouse CLI (d8).

    Используйте команду d8 system module enable для включения модуля, или d8 system module disable для выключения модуля (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Пример включения модуля cloud-provider-zvirt:

    d8 system module enable cloud-provider-zvirt
    
  • С помощью ModuleConfig cloud-provider-zvirt.

    Установите spec.enabled в true или false в ModuleConfig cloud-provider-zvirt (создайте его, при необходимости).

    Пример манифеста для включения модуля cloud-provider-zvirt:

    apiVersion: deckhouse.io/v1alpha1
    kind: ModuleConfig
    metadata:
      name: cloud-provider-zvirt
    spec:
      enabled: true
    

Как настроить модуль...

Настроить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse.

    В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль cloud-provider-zvirt, включите переключатель «Дополнительные настройки». Заполните необходимые поля формы на вкладке «Конфигурация», или укажите настройки модуля в формате YAML на вкладке «YAML», не включая секцию settings. Сохраните изменения.

    Пример:

    Интерфейс настройки модуля

    Вы также можете отредактировать объект ModuleConfig cloud-provider-zvirt на вкладке «YAML» в окне настроек модуля («Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль cloud-provider-zvirt), указав версию схемы в параметре spec.version и необходимые параметры модуля в секции spec.settings.

  • С помощью Deckhouse CLI (d8) (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Отредактируйте существующий ModuleConfig cloud-provider-zvirt (подробнее о настройке Deckhouse читайте в документации), выполнив следующую команду:

    d8 k edit mc cloud-provider-zvirt
    

    Внесите необходимые изменения в секцию spec.settings. При необходимости укажите версию схемы в параметре spec.version. Сохраните изменения.

    Вы также можете создать файл манифеста ModuleConfig cloud-provider-zvirt, используя пример ниже. Заполните секцию spec.settings необходимыми параметрами модуля. При необходимости укажите версию схемы в параметре spec.version.

    Примените манифест с помощью следующей команды (укажите имя файла манифеста):

    d8 k apply -f <FILENAME>
    

    Пример файла манифеста ModuleConfig cloud-provider-zvirt:

    apiVersion: deckhouse.io/v1alpha1
    kind: ModuleConfig
    metadata:
      name: cloud-provider-zvirt
    spec:
      version: 2
      enabled: true
      settings: # Параметры модуля из раздела "Параметры" ниже.
    

Конверсии

Модуль настраивается с помощью ресурса ModuleConfig, схема которого содержит номер версии. При применении в кластере старой версии схемы ModuleConfig выполняются автоматические преобразования. Чтобы обновить версию схемы ModuleConfig вручную, необходимо последовательно для каждой версии выполнить следующие действия :

  • Обновление из версии 1 в 2:

    Настройки сгруппированы по параметрам provider, nodes, storage и ccm.

    Конверсия подставляет временные значения в параметры server, clusterID и sshPublicKey. Замените их фактическими значениями.

    Логин и пароль для подключения к zVirt в настройках модуля не хранятся. Модуль читает их из секрета d8-credentials типа cloud-provider.deckhouse.io/credentials.

Параметры

Версия схемы: 2

  • settings
    объект
    • settings.ccm
      объект

      Настройки подсистемы Cloud Controller Manager (CCM).

      CCM актуализирует метаданные узлов кластера и удаляет из кластера узлы, виртуальных машин которых больше нет в zVirt.

      • settings.ccm.disabled
        булевый

        Отключает Cloud Controller Manager.

        При значении true модуль не развёртывает CCM.

        По умолчанию: false

      • settings.ccm.parameters
        объект

        Обязательный параметр

        Parameters of the CCM subsystem.

    • settings.nodes
      объект

      Обязательный параметр

      Настройки подсистемы узлов.

      Подсистема описывает, как узлы кластера создаются в zVirt, включая схему размещения, публичный SSH-ключ и статическую настройку сети.

      • settings.nodes.disabled
        булевый

        Отключает подсистему узлов.

        При значении true кластер не создаёт CloudEphemeral-узлы в zVirt.

        По умолчанию: false

      • settings.nodes.parameters
        объект

        Обязательный параметр

        Параметры подсистемы узлов.

        • settings.nodes.parameters.customNetworkConfigs
          объект

          Статическая настройка сети для узлов групп CloudPermanent.

          Ключом служит имя группы узлов (NodeGroup) с типом CloudPermanent, например master. Узлы группы, не указанной в параметре, получают сетевые настройки по DHCP.

          Адреса из списка networkInterfaceAddresses назначаются по порядковому номеру узла. Первый адрес получает узел с индексом 0, второй адрес получает узел с индексом 1 и так далее. Если адресов в списке меньше, чем реплик в группе узлов, остальные узлы получают адреса по DHCP.

          • settings.nodes.parameters.customNetworkConfigs.<KEY_NAME>
            объект

            <KEY_NAME> — имя параметра (ключ объекта).

            Статическая настройка сетевого интерфейса узлов.

            • settings.nodes.parameters.customNetworkConfigs.<KEY_NAME>.dnsServers
              массив строк

              Список DNS-серверов.

              Пример:

              dnsServers:
              - 8.8.8.8
              - 8.8.4.4
              
            • settings.nodes.parameters.customNetworkConfigs.<KEY_NAME>.networkInterfaceAddresses
              массив строк

              Обязательный параметр

              Список IP-адресов, которые назначаются интерфейсу, по одному адресу на узел.

              Пример:

              networkInterfaceAddresses:
              - 192.168.1.10
              - 192.168.1.11
              
            • settings.nodes.parameters.customNetworkConfigs.<KEY_NAME>.networkInterfaceGateway
              строка

              Обязательный параметр

              Шлюз по умолчанию.

              Пример:

              networkInterfaceGateway: 192.168.1.1
              
            • settings.nodes.parameters.customNetworkConfigs.<KEY_NAME>.networkInterfaceName
              строка

              Обязательный параметр

              Имя сетевого интерфейса, к которому применяется статическая настройка.

              Пример:

              networkInterfaceName: enp1s0
              
            • settings.nodes.parameters.customNetworkConfigs.<KEY_NAME>.networkInterfaceNetmask
              строка

              Обязательный параметр

              Маска подсети для интерфейса.

              Пример:

              networkInterfaceNetmask: 255.255.255.0
              
        • settings.nodes.parameters.layout
          строка

          Обязательный параметр

          Название схемы размещения.

          Доступные схемы размещения описаны в разделе «Схемы размещения».

          Допустимые значения: Standard

        • settings.nodes.parameters.sshPublicKey
          строка

          Обязательный параметр

          Публичный SSH-ключ для доступа к узлам.

    • settings.provider
      объект

      Обязательный параметр

      Настройки подключения к zVirt.

      • settings.provider.parameters
        объект

        Обязательный параметр

        Параметры подключения к API zVirt.

        Логин и пароль в настройках модуля не задаются. Модуль читает их из секрета d8-credentials типа cloud-provider.deckhouse.io/credentials в неймспейсе d8-cloud-provider-zvirt.

        • settings.provider.parameters.caBundle
          строка

          Закодированный в Base64 набор сертификатов CA в формате PEM для проверки сертификата API zVirt.

          Если параметр insecure имеет значение true, набор сертификатов не учитывается.

        • settings.provider.parameters.clusterID
          строка

          Обязательный параметр

          Идентификатор кластера zVirt, в котором создаются виртуальные машины.

          В кластере должны быть общие домены хранения и процессоры одного типа.

          Шаблон: ^[\da-fA-F]{8}\-[\da-fA-F]{4}\-[\da-fA-F]{4}\-[\da-fA-F]{4}\-[\da-fA-F]{12}$

          Пример:

          clusterID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
          
        • settings.provider.parameters.insecure
          булевый

          Отключает проверку сертификата API zVirt.

          Установите значение true, если zVirt использует самоподписанный сертификат.

          По умолчанию: false

        • settings.provider.parameters.server
          строка

          Обязательный параметр

          URL эндпоинта API zVirt.

          Укажите URL со схемой http или https.

    • settings.storage
      объект

      Настройки подсистемы хранения данных.

      Подсистема отвечает за CSI-драйвер и StorageClass для доменов хранения zVirt.

      • settings.storage.disabled
        булевый

        Отключает подсистему хранения данных.

        При значении true заказ дисков в кластере недоступен.

        По умолчанию: false

      • settings.storage.parameters
        объект

        Обязательный параметр

        Параметры подсистемы хранения данных.

        • settings.storage.parameters.excludedStorageClasses
          массив строк

          Список StorageClass, исключаемых из создания в кластере.

          Модуль создаёт StorageClass для каждого активного домена хранения zVirt. Каждый элемент списка задаёт регулярное выражение, которое сопоставляется с именем StorageClass целиком. Например, data исключает только StorageClass data, а data.* исключает все StorageClass, имя которых начинается с data.