Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

Начало работы

Terraform доступен только в редакции zVirt Advanced

1. Схема

terraform {
  required_providers {
    zvirt = {
      source  = "terraform-registry.orionsoft.ru/orionsoft/zvirt"
      version = "указать версию"
    }
  }
}

provider "zvirt" {
  hostname     = "zvirt.example.local"
  username     = "terraform-user@internalsso"
  password     = "SuperSecretPassword"
  tls_insecure = true
}
Обязательные параметры (или аргументы):
  1. hostname (String) - FQDN Менеджера управления zVirt Engine.

    Например: zvirt.example.local

  2. username(String) - имя пользователя и пространство имён (реалм) в zVirt.

    Например: admin@zvirt@internalsso

  3. password(String,Sensitive) - пароль пользователя в zVirt.

Дополнительные параметры (или аргументы):
  1. tls_insecure (Boolean) - отключает проверку сертификата при подключении к zVirt.

  2. 2.0.0 tls_ca_bundle(String) - закодированный в Base64 пакет PEM, содержащий один или несколько сертификатов удостоверяющего центра (CA) для проверки TLS.

  3. 2.0.0 tls_ca_path(String) - путь к файлу формата PEM, содержащему один или несколько сертификатов удостоверяющего центра (CA) для проверки TLS.

2. Дополнительная подготовка

Для работы с провайдером рекомендуется использовать учетную запись с ролью SuperUser.

В случае необходимости использования учетной записи без роли SuperUser см. раздел Ролевая модель.

3. Установка и запуск провайдера

Поддерживаются установка на ОС Linux, OС Windows и macOS.

3.1. Онлайн установка

Порядок действий
  1. Создайте файл:

    1. для пользователей ОС Linux и macOS .terraformrc в корневой директории пользователя (~).

    2. для пользователей ОС Windows terraform.rc в директории /AppData/Roaming

  2. Содержание файла должно иметь следующий вид:

    provider_installation {
      network_mirror {
        url     = "https://USERNAME:PASSWORD@terraform-registry.orionsoft.ru/"
        include = ["terraform-registry.orionsoft.ru/orionsoft/zvirt"]
      }
    }
    Значениями USERNAME:PASSWORD выступают учетные данные для аутентификации в Terraform Registry.
  3. Перейдите в каталог с манифестом и в файле конфигурации (main.tf) укажите версию провайдера в блоке required_providers.

  4. Выполните команду terraform init в тестовом каталоге.

3.2. Локальная установка

Порядок действий
  1. Предварительно загрузите провайдер для требуемой версии ОС с официального реестра terraform-registry.orionsoft.ru.

  2. Создайте папку для размещения провайдера

    1. для пользователей ОС Linux и macOS в домашней директории пользователя (~).

      ~/.terraform.d/plugins/terraform-registry.orionsoft.ru/orionsoft/zvirt/${VERSION}/${OS}_${ARCH}

      где:

      • VERSION - версия провайдера Terraform.

      • OS - тип операционной системы.

      • ARCH - архитектура операционной системы.

        Пример
        ~/.terraform.d/plugins/terraform-registry.orionsoft.ru/orionsoft/zvirt/1.2.1/linux_amd64
    2. для пользователей ОС Windows в директории %APPDATA%.

      %APPDATA%/terraform.d/plugins/terraform-registry.orionsoft.ru/orionsoft/zvirt/${VERSION}/${OS}_${ARCH}
  3. В созданную директорию переместите и распакуйте архив с провайдером.

    Пример для ОС Linux
    unzip -d ~/.terraform.d/plugins/terraform-registry.orionsoft.ru/orionsoft/zvirt/1.2.1/linux_amd64/terraform-provider-zvirt_1.2.0_linux_amd64.zip
  4. Выполните инициализацию провайдера из локальной директории.

    terraform init

4. Ролевая модель

При обращении к провайдеру Terraform от имени пользователя набор необходимых разрешений зависит от используемых ресурсов.

Для работы со всеми источниками данных достаточно встроенной роли ReadOnlyAdmin, включающей разрешение Система > Настроить систему > Разрешения входа.

Ниже приведен список минимальных разрешений для ресурсов. Предполагается, что разрешение Система > Настроить систему > Разрешения входа уже назначено пользователю, поэтому оно не повторяется для каждого ресурса. Промежуточные пункты в иерархии показывают путь в меню настройки роли. Символом ✓ отмечены только те разрешения, для которых необходимо установить флажок.

Список минимальных прав для ресурсов:
  • zvirt_address_pool

    • SDN

      • Управление SDN

        • ✓ Управление инфраструктурой SDN

  • zvirt_affinity_group

    • Кластер

      • Настройки кластера

        • ✓ Управление группами сходства

  • zvirt_affinity_label

    • Система

      • Настроить систему

        • ✓ Метки управления разрешениями

    • Кластер

      • Настройки кластера

        • ✓ Управление группами сходства

  • zvirt_direct_lun_fc

    • Диск

      • ✓ Создать

      • ✓ Изменить свойства

      • ✓ Удалить

  • zvirt_direct_lun_iscsi

    • Диск

      • ✓ Создать

      • ✓ Изменить свойства

      • ✓ Удалить

  • zvirt_disk

    • ВМ

      • Операции резервирования

        • ✓ Изменить снимки - требуется при перемещении диска, подключенного к работающей ВМ.

    • Диск

      • ✓ Создать

      • ✓ Изменить свойства

      • ✓ Удалить

      • ✓ Изменить хранилище

  • zvirt_disk_attachment

    • ВМ

      • Операции резервирования

        • ✓ Изменить хранилище

    • Диск

      • Операции резервирования

        • ✓ Прикрепить

        • ✓ Изменить свойства

  • zvirt_disk_copy

    • ВМ

      • Операции резервирования

        • ✓ Изменить снимки - требуется при перемещении диска, подключенного к работающей ВМ.

    • Диск

      • ✓ Создать

      • ✓ Изменить свойства

      • ✓ Удалить

      • ✓ Изменить хранилище

  • zvirt_external_network

    • SDN

      • Управление SDN

        • ✓ Управление инфраструктурой SDN

    • Сеть

      • ✓ Настроить сеть

      • Настроить vNIC-профиль

        • ✓ Создать

      • ✓ Удалить

  • zvirt_logical_network

    • SDN

      • Управление SDN

        • ✓ Управление инфраструктурой SDN

    • Сеть

      • ✓ Настроить сеть

      • Настроить vNIC-профиль

        • ✓ Создать

        • ✓ Удалить

  • zvirt_router

    • SDN

      • ✓ Управление SDN

    • Сеть

      • Настроить сеть

        • ✓ Создать

        • ✓ Изменить свойства

        • ✓ Удалить

  • zvirt_router_interface

    • SDN

      • ✓ Управление SDN

  • zvirt_router_nat

    • SDN

    • Управление SDN

      • ✓ Конфигурация маршрутизаторов

  • zvirt_router_route

    • SDN

      • Управление SDN

        • ✓ Конфигурация маршрутизаторов

  • zvirt_security_group

    • SDN

      • Управление микросегментацией SDN

        • ✓ Управление микросегментацией

  • zvirt_security_rule

    • SDN

      • Управление микросегментацией SDN

        • ✓ Управление микросегментацией

  • zvirt_subnet

    • SDN

      • Управление SDN

      • ✓ Управление инфраструктурой SDN

    • Сеть

      • ✓ Настроить сеть

      • Настроить vNIC-профиль

        • ✓ Создать

        • ✓ Удалить

  • zvirt_vm

    • Сеть

      • Настроить vNIC с ВМ

        • ✓ Связать профиль vNIC с ВМ

    • Кластер

      • Настройка кластера

        • ✓ Управление группами сходства

    • ВМ

      • Операции резервирования

        • ✓ Изменить свойства

        • ✓ Создать

        • ✓ Удалить

        • ✓ Изменить хранилище

        • ✓ Изменить снимки

    • Диск

      • Операции резервирования

        • ✓ Создать

        • ✓ Изменить хранилище

        • ✓ Прикрепить

    • Операции SDN

      • Управление SDN

        • ✓ Управление инфраструктурой SDN

      • Управление микросегментацией SDN

        • ✓ Конфигурация микросегментации

    • Папки ВМ

      • ✓ Управлять содержимым

  • zvirt_vm_folder

    • Папки ВМ

      • ✓ Управлять папками ВМ

  • zvirt_vm_pool

    • Пул ВМ

      • ✓ Операции резервирования

    • ВМ

      • Операции резервирования

        • ✓ Создать

        • ✓ Удалить

    • Шаблон

      • Операции резервирования

        • ✓ Копировать