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

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
}

Обязательные параметры (или аргументы):

hostname (String) - FQDN Менеджера управления zVirt Engine.

Например: zvirt.example.local
username(String) - имя пользователя и пространство имён (реалм) в zVirt.

Например: admin@zvirt@internalsso
password(String,Sensitive) - пароль пользователя в zVirt.

Дополнительные параметры (или аргументы):

tls_insecure (Boolean) - отключает проверку сертификата при подключении к zVirt.

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

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

Дополнительная информация см.Ролевая модель

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

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

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

Порядок действий

Создайте файл:
1. для пользователей ОС Linux и macOS .terraformrc в корневой директории пользователя (~).
2. для пользователей ОС Windows terraform.rc в директории /AppData/Roaming
Содержание файла должно иметь следующий вид:
```
provider_installation {
  network_mirror {
    url     = "https://USERNAME:PASSWORD@terraform-registry.orionsoft.ru/"
    include = ["terraform-registry.orionsoft.ru/orionsoft/zvirt"]
  }
}
```
Значениями USERNAME:PASSWORD выступают учетные данные для аутентификации в Terraform Registry.
Перейдите в каталог с манифестом и в файле конфигурации (main.tf) укажите версию провайдера в блоке required_providers.
Выполните команду terraform init в тестовом каталоге.

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

Порядок действий

Предварительно загрузите провайдер для требуемой версии ОС с официального реестра terraform-registry.orionsoft.ru.
Создайте папку для размещения провайдера
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}
В созданную директорию переместите и распакуйте архив с провайдером.
Пример для ОС 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
```
Выполните инициализацию провайдера из локальной директории.
```
terraform init
```

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

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

Ниже список минимальных прав для ресурсов:

zvirt_disk
- Система
  - Настроить систему
  - Разрешения входа
- Диск
  - Операции резервирования
    
    Создать
    
    Удалить
    
    Прикрепить
    
    Изменить свойства
zvirt_vm
- Система
  - Настроить систему
  - Разрешения входа
- Сеть
  - Настроить vNIC-профиль
  - Связать профиль vNIC с ВМ
- Шаблон
  - Операции резервирования
  - Копировать
- ВМ
  - Основные операции
    
    Перезагрузить ВМ
    
    Остановить ВМ
    
    Выключить ВМ
    
    Запустить ВМ
  - Операции резервирования
    
    Изменить свойства
    
    Создать
    
    Удалить
    
    Изменить хранилище
- Диск
  - Операции резервирования
  - Удалить
  - Прикрепить
  - Изменить свойства
zvirt_network
- Система
  - Настроить систему
  - Разрешения входа
- Сеть
  - Настроить сеть
  - Создать
  - Изменить свойства
  - Удалить
  - Связать сеть с кластером
  - Настроить vNIC-профиль
  - Создать
  - Изменить свойства
  - Удалить
- Операции SDN
  - Управление SDN
  - Управление инфраструктурой SDN
zvirt_external_network
- Система
  - Настроить систему
  - Разрешения входа
- Сеть
  - Настроить сеть
  - Создать
  - Изменить свойства
  - Удалить
  - Связать сеть с кластером
- Настроить vNIC-профиль
  - Создать
  - Изменить свойства
  - Удалить
- Операции SDN
  - Управление SDN
  - Управление инфраструктурой SDN
zvirt_network
- Система
  - Настроить систему
  - Разрешения входа
- Сеть
  - Настроить сеть
  - Создать
  - Изменить свойства
  - Удалить
  - Связать сеть с кластером
  - Настроить vNIC-профиль
  - Создать
  - Изменить свойства
  - Удалить
- Операции SDN
  - Управление SDN
  - Управление инфраструктурой SDN
zvirt_subnet
- Система
  - Настроить систему
  - Разрешения входа
- Сеть
  - Настроить сеть
  - Создать
  - Изменить свойства
  - Удалить
  - Связать сеть с кластером
- Настроить vNIC-профиль
  - Создать
  - Изменить свойства
  - Удалить
- Операции SDN
  - Управление SDN
  - Управление инфраструктурой SDN
zvirt_router
- Система
  - Настроить систему
  - Разрешения входа
- Сеть
  - Настроить сеть
  - Создать
  - Изменить свойства
  - Удалить
  - Связать сеть с кластером
- Настроить vNIC-профиль
  - Создать
  - Изменить свойства
  - Удалить
- Операции SDN
  - Управление SDN
  - Управление инфраструктурой SDN
  - Конфигурация маршрутизаторов