Начало работы
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.0.0
tls_ca_bundle(String) - закодированный в Base64 пакет PEM, содержащий один или несколько сертификатов удостоверяющего центра (CA) для проверки TLS. -
2.0.0
tls_ca_path(String) - путь к файлу формата PEM, содержащему один или несколько сертификатов удостоверяющего центра (CA) для проверки TLS.
2. Дополнительная подготовка
Для работы с провайдером рекомендуется использовать учетную запись с ролью SuperUser.
В случае необходимости использования учетной записи без роли SuperUser см. раздел Ролевая модель.
3. Установка и запуск провайдера
| Поддерживаются установка на ОС Linux, OС Windows и macOS. |
3.1. Онлайн установка
-
Создайте файл:
-
для пользователей ОС Linux и macOS .terraformrc в корневой директории пользователя (~).
-
для пользователей ОС 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.
-
Создайте папку для размещения провайдера
-
для пользователей ОС 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
-
-
для пользователей ОС Windows в директории %APPDATA%.
%APPDATA%/terraform.d/plugins/terraform-registry.orionsoft.ru/orionsoft/zvirt/${VERSION}/${OS}_${ARCH}
-
-
В созданную директорию переместите и распакуйте архив с провайдером.
Пример для ОС Linuxunzip -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 от имени пользователя набор необходимых разрешений зависит от используемых ресурсов.
Для работы со всеми источниками данных достаточно встроенной роли 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-
Пул ВМ
-
✓Операции резервирования
-
-
ВМ
-
Операции резервирования
-
✓Создать -
✓Удалить
-
-
-
Шаблон
-
Операции резервирования
-
✓Копировать
-
-
-