4.9.0

samples/cloudbroker/kvmvm/resource_kvmvm/main.tf

@@ -6,7 +6,7 @@
 2. Редактировать compute
 3. Удалять compute
 */
-#Расскомментируйте этот код,
+#Раскомментируйте этот код,
 #и внесите необходимые правки в версию и путь,
 #чтобы работать с установленным вручную (не через hashicorp provider registry) провайдером
 /*
@@ -22,9 +22,9 @@ terraform {
 
 
 provider "decort" {
-  authenticator = "decs3o"
+  authenticator        = "decs3o"
   #controller_url = <DECORT_CONTROLLER_URL>
-  controller_url = "https://ds1.digitalenergy.online"
+  controller_url       = "https://ds1.digitalenergy.online"
   #oauth2_url = <DECORT_SSO_URL>
   oauth2_url           = "https://sso.digitalenergy.online"
   allow_unverified_ssl = true
@@ -33,108 +33,127 @@ provider "decort" {
 resource "decort_cb_kvmvm" "comp" {
   #имя compute
   #обязательный параметр
-  #мб изменен
   #тип - строка
+  #используется при создании и обновлении
   name = "test-tf-compute-update-new"
 
-  #id resource group
+  #id ресурсной группы
   #обязательный параметр
   #тип - целое число
+  #используется при создании
   rg_id = 1111
 
   #тип драйвера для compute
   #обязательный параметр
   #тип - строка
   #возможные значения: "SVA_KVM_X86", "KVM_X86"
+  #используется при создании
   driver = "KVM_X86"
 
   #число cpu
   #обязательный параметр
   #тип - целое число
+  #используется при создании и обновлении
   cpu = 1
 
   #кол-во оперативной памяти, МБ
   #обязательный параметр
   #тип - целое число
+  #используется при создании и обновлении
   ram = 2048
 
   #тип эмулируемой системы
   #опциональный параметр
   #тип - строка
   #возможные значения: "i440fx", "Q35"
+  #используется при создании и обновлении
   #chipset = "i440fx"
 
   #id образа диска для создания compute
   #опциональный параметр
   #тип - целое число
+  #используется при создании и обновлении
   #image_id = 111
 
-  #если значение равно True, параметры image_id, boot_disk_size, sep_id, pool игнорируются, и компьютер создается без загрузочного диска в остановленном состоянии
+  #создать вм без загрузочного диска
+  #если значение равно True, параметры image_id, boot_disk_size, sep_id, pool игнорируются
+  #компьютер создается без загрузочного диска в остановленном состоянии
   #опциональный параметр
   #тип - булев
+  #используется при создании
   #without_boot_disk = true
 
   #размер загрузочного диска
   #опциональный параметр
   #тип - целое число
+  #используется при создании и обновлении
   #boot_disk_size = 20
 
-  #ID сепа для boot диска
+  #id сепа для boot диска
   #опциональный параметр
   #тип - целое число
+  #используется при создании
   #sep_id = 1
 
   #название пула
   #опциональный параметр
   #тип - строка
+  #используется при создании
   #pool = "data02"
 
   #конфигурация cloud init
   #опциональный параметр
   #тип - файл в формате JSON
+  #используется при создании
   #cloud_init = file("initconfig.tftpl")
 
   #описание compute
   #опциональный параметр
   #тип - строка
+  #используется при создании и обновлении
   #description = "test update description in tf words update"
 
   #stack id
   #опциональный параметр
   #тип - целое число
+  #используется при создании
   #stack_id = 1
 
   #id образа CD-ROM для загрузки
-  #используется при изменении ресурса, при повторном старте вм 
   #опциональный параметр
   #тип - целое число
+  #используется при обновлении, при повторном старте вм
   #alt_boot_id = 1
 
   #необходимость выравнивать ВМ по NUMA
   #опциональный параметр
   #тип - строка
   #возможные значения - "none, "strict", "loose"
-  #значение по умолчанию - "none"
+  #по умолчанию - "none"
+  #используется при создании и обновлении
   #numa_affinity = "loose"
 
   #необходимость запускать ВМ на выделенных CPU ядрах
   #опциональный параметр
   #тип - булев
-  #значение по умолчанию - false
+  #по умолчанию - false
+  #используется при создании и обновлении
   #cpu_pin = true
 
   #необходимость использовать для выделения RAM виртуальной машины Huge Pages
   #опциональный параметр
   #тип - булев
-  #значение по умолчанию - false
+  #по умолчанию - false
+  #используется при создании и обновлении
   #hp_backed = true
 
-  #создание и добавление диска дял compute
+  #создание и добавление диска для compute
   #опциональный параметр
   #тип - список дисков
+  #используется при создании и обновлении
   #disks {
     #имя диска
-    #Обязательный для диска параметр
+    #обязательный для диска параметр
     #тип - строка
     #disk_name = "disk_name"
 
@@ -156,7 +175,7 @@ resource "decort_cb_kvmvm" "comp" {
     #опциональный параметр
     #тип - строка
     #pool = "data01"
-  
+
     #список node
     #опциональный параметр
     #тип - массив целых чисел
@@ -167,11 +186,11 @@ resource "decort_cb_kvmvm" "comp" {
     #тип - строка
     #desc = ""
 
-    #ID образа
+    #id образа
     #опциональный параметр
     #image_id = 378
 
-    #флаг для удаления диска
+    #флаг для удаления диска, без возможности восстановления
     #опциональный параметр
     #тип - булев
     #permanently = false
@@ -181,6 +200,7 @@ resource "decort_cb_kvmvm" "comp" {
   #опциональный параметр
   #может быть один, несколько или ни одного блока
   #тип - блок
+  #используется при создании и обновлении
     #affinity_rules {
     #тип правила
     #возможные значения - compute или node
@@ -192,30 +212,31 @@ resource "decort_cb_kvmvm" "comp" {
     #возможные значения - RECOMMENDED и REQUIRED
     #обязательный параметр
     #тип - строка
-    #policy   = "RECOMMENDED"
+    #policy = "RECOMMENDED"
 
-    #режим проверки 
+    #режим проверки
     #возможные значения - ANY, EQ, NE
     #обязательный параметр
     #тип - строка
-    #mode     = "ANY"
+    #mode = "ANY"
 
     #ключ правила
     #обязательный параметр
     #тип - строка
-    #key      = "testkey"
+    #key = "testkey"
 
     #ключ правила
-    #необязательный параметр
+    #опциональный параметр
     #тип - строка
-    #value    = "testvalue"
-    #}
+    #value = "testvalue"
+  #}
 
   #правила anti-affinity
   #опциональный параметр
   #может быть один, несколько или ни одного блока
   #тип - блок
-    #anti_affinity_rules {
+  #используется при создании и обновлении
+  #anti_affinity_rules {
     #тип правила
     #возможные значения - compute или node
     #обязательный параметр
@@ -226,259 +247,282 @@ resource "decort_cb_kvmvm" "comp" {
     #возможные значения - RECOMMENDED и REQUIRED
     #обязательный параметр
     #тип - строка
-    #policy   = "RECOMMENDED"
+    #policy = "RECOMMENDED"
 
-    #режим проверки 
+    #режим проверки
     #возможные значения - ANY, EQ, NE
     #обязательный параметр
     #тип - строка
-    #mode     = "ANY"
+    #mode = "ANY"
 
     #ключ правила
     #обязательный параметр
     #тип - строка
-    #key      = "testkey"
+    #key = "testkey"
 
     #ключ правила
-    #необязательный параметр
+    #опциональный параметр
     #тип - строка
-    #value    = "testvalue"
-    #}
+    #value = "testvalue"
+  #}
 
   #установка метки для вм
   #опциональный параметр
   #тип - строка
+  #используется при создании и обновлении
   #affinity_label = "test4"
 
-
   #наименование системы
   #опциональный параметр
-  #используется при создании вм
   #по умолчанию - не задан
   #тип - строка
-  #is=""
+  #используется при создании
+  #is = ""
 
   #назначение вм
   #опциональный параметр
-  #используется при создании вм
   #по умолчанию - не задан
   #тип - строка
+  #используется при создании
   #ipa_type = ""
 
-  #ID экстра дисков
+  #id экстра дисков
   #опциональный параметр
   #тип - список чисел
+  #используется при создании и обновлении
   #extra_disks = [1234, 4322, 1344]
-    
+
   #управление XML виртуальной машины
   #опциональный параметр
   #тип - строка (json-encoded)
+  #используется при создании и обновлении
   #custom_fields = "{`key`:`value`}"
 
-  #присоединения сетей и удаление сетей в компьюте
+  #присоединение сетей и удаление сетей в компьюте
   #опциональный параметр
   #тип - блок
-    #network {
-      #тип сети
-      #обязательный параметр
-      #возможные значения - "VINS", "EXTNET", "VFNIC", "DPDK" (при выборе типа DPDK, необходимо указать hp_backed = true)
-      #тип - строка
-      #net_type = "VINS"
+  #используется при создании и обновлении
+  #network {
+    #тип сети
+    #обязательный параметр
+    #возможные значения - "VINS", "EXTNET", "VFNIC", "DPDK" (при выборе типа DPDK, необходимо указать hp_backed = true)
+    #тип - строка
+    #net_type = "VINS"
 
-      #ID сети
-      #обязательный параметр
-      #тип - целое число
-      #net_id = 1234
+    #id сети
+    #обязательный параметр
+    #тип - целое число
+    #net_id = 1234
 
-      #IP адрес входящий в сеть
-      #опциональный параметр
-      #тип - строка
-      #ip_address = "127.0.0.1"
+    #ip адрес входящий в сеть
+    #опциональный параметр
+    #тип - строка
+    #ip_address = "127.0.0.1"
 
-      #вес сети, указывается при необходимости указания порядка подключения сетей
-      #первой подключается сеть с наименьшим весом
-      #сеть с нулевым или неуказанным весом имеет наименьший приоритет
-      #опциональный параметр
-      #тип - целое число
-      #weight = 15
+    #mac-адрес интерфейса компьюта
+    #опциональный параметр
+    #тип - строка
+    #mac = "52:54:01:12:34:60"
 
-      #максимальный объём данных, который может быть передан за одну итерацию
-      #используется только с сетями типа "DPDK"
-      #возможные значения - 1-9216
-      #опциональный параметр
-      #тип - целое число
-      #mtu = 1500
-    #}
+    #вес сети, указывается при необходимости указания порядка подключения сетей
+    #первой подключается сеть с наименьшим весом
+    #сеть с нулевым или неуказанным весом имеет наименьший приоритет
+    #опциональный параметр
+    #тип - целое число
+    #weight = 15
+
+    #максимальный объём данных, который может быть передан за одну итерацию
+    #используется только с сетями типа "DPDK"
+    #возможные значения - 1-9216
+    #опциональный параметр
+    #тип - целое число
+    #mtu = 1500
+  #}
 
   #добавление и удаление тэгов
   #опциональный параметр
   #тип - блок
-    #tags {
-      #ключ для тэга
-      #обязательный параметр
-      #тип - строка
-      #key = "key"
+  #используется при создании и обновлении
+  #tags {
+    #ключ для тэга
+    #обязательный параметр
+    #тип - строка
+    #key = "key"
 
-      #значения тэга
-      #обязательный параметр
-      #тип - строка
-      #value = "value"
-    #}
+    #значения тэга
+    #обязательный параметр
+    #тип - строка
+    #value = "value"
+  #}
 
   #добавление и удаление port forwarding
   #опциональный параметр
   #тип - блок
-    #port_forwarding {
-      #номер внешнего начального порта для правила
-      #обязательный параметр
-      #тип - целое число
-      #public_port_start = 2023
+  #используется при создании и обновлении
+  #port_forwarding {
+    #номер внешнего начального порта для правила
+    #обязательный параметр
+    #тип - целое число
+    #public_port_start = 2023
 
-      #номер внешнего последнего порта для правила
-      #опциональный параметр
-      #тип - целое число
-      #по умолчанию - -1
-      #public_port_end = 2023
+    #номер внешнего последнего порта для правила
+    #опциональный параметр
+    #тип - целое число
+    #по умолчанию - -1
+    #public_port_end = 2023
 
-      #номер внутреннего базового порта
-      #обязательный параметр
-      #тип - целое число
-      #local_port = 80
+    #номер внутреннего базового порта
+    #обязательный параметр
+    #тип - целое число
+    #local_port = 80
 
-      #сетевой протокол
-      #обязательный параметр
-      #тип - строка
-      #proto = "tcp"
-    #}
+    #сетевой протокол
+    #обязательный параметр
+    #тип - строка
+    #proto = "tcp"
+  #}
 
   #предоставить/забрать пользователю доступ к компьюту
   #опциональный параметр
   #тип - блок
-    #user_access {
-      #имя юзера, которому предоставляем доступ
-      #обязательный параметр
-      #тип - строка
-      #username = "some@decs3o"
+  #используется при создании и обновлении
+  #user_access {
+    #имя юзера, которому предоставляем доступ
+    #обязательный параметр
+    #тип - строка
+    #username = "some@decs3o"
 
-      #права: 'R' - только на чтение, 'RCX' - чтение/запись, 'ARCXDU' - админ
-      #обязательный параметр
-      #тип - строка
-      #access_type = "ARCXDU"
-    #}
+    #права: 'R' - только на чтение, 'RCX' - чтение/запись, 'ARCXDU' - админ
+    #обязательный параметр
+    #тип - строка
+    #access_type = "ARCXDU"
+  #}
 
   #создать/удалить снапшот компьюта
   #опциональный параметр
   #тип - блок
-    #snapshot {
-      #лейбл снапшота
-      #обязательный параметр
-      #тип - строка
-      #label = "label1"
-    #}
+  #используется при создании и обновлении
+  #snapshot {
+    #лейбл снапшота
+    #обязательный параметр
+    #тип - строка
+    #label = "label1"
+  #}
 
   #флаг для удаления снапшотов в асинхронном режиме
   #опциональный параметр
-  #дефолтное значение - false
   #тип - булев
+  #по умолчанию - false
+  #используется при обновлении
   #snapshot_delete_async = true
 
   #rollback на нужный снапшот
   #опциональный параметр
   #не имеет смысла при отсутсвии снапшотов
   #тип - блок
-    #rollback {
-      #лейбл снапшота
-      #обязательный параметр
-      #тип - строка
-      #label = "label1"
-    #}
+  #используется при обновлении
+  #rollback {
+    #лейбл снапшота
+    #обязательный параметр
+    #тип - строка
+    #label = "label1"
+  #}
 
   #вставить/удалить СD rom
   #опциональный параметр
   #максимальное кол-во - 1
   #тип - блок
-    #cd {
-      #ID образа диска CD rom
-      #обязательный параметр
-      #тип - целое число
-      #cdrom_id = 344
-    #}
+  #используется при создании и обновлении
+  #cd {
+    #id образа диска CD rom
+    #обязательный параметр
+    #тип - целое число
+    #cdrom_id = 344
+  #}
 
   #добавить компьют на стэк
   #опциональный параметр
   #тип - булев
+  #используется при создании и обновлении
   #pin_to_stack = true
 
   #список ядер для использования в механизме vcpupinning. Количество указанных ядер должно быть равно количеству виртуальных процессоров ВМ
   #игнорируется если cpu_pin=false или pin_to_stack=false
   #опциональный параметр
   #тип - массив целых чисел
+  #используется при создании и обновлении
   #preferred_cpu = [1234, 456]
 
   #флаг для старта компьюта при рестарте ноды
   #опциональный параметр
   #тип - булев
+  #используется при создании и обновлении
   #auto_start_w_node = true
 
-  #флаг для принужительного добавления компьюта на стэк
+  #флаг для принудительного добавления компьюта на стэк
   #опциональный параметр
   #тип - булев
+  #используется при создании и обновлении
   #force_pin = true
 
   #список PCI девайсов
   #опциональный параметр
   #тип - массив целых чисел
+  #используется при создании и обновлении
   #pci_devices = [1,2]
 
   #флаг доступности компьюта для проведения с ним операций
   #опциональный параметр
   #тип - булев
+  #используется при создании и обновлении
   #enabled = true
 
   #pause/resume компьюта
   #опциональный параметр
   #тип - булев
+  #используется при создании и обновлении
   #pause = true
 
   #сделать компьют заново
   #опциональный параметр
   #тип - булев
+  #используется при обновлении
   #reset = true
 
   #восстановить удаленный компьют из корзины
   #опциональный параметр
   #тип - булев
+  #используется при обновлении
   #restore = true
 
   #флаг для редеплоя компьюта
   #опциональный параметр
   #тип - булев
+  #используется при обновлении
   #force_stop = true
 
-  #флаг для предоставления дисков из node
-  #опциональный параметр
-  #тип - булев
-  #по умолчанию - true
-  #depresent = true
-
   #флаг для ресайза компьюта
   #опциональный параметр
   #тип - булев
+  #используется при обновлении
   #force_resize = true
 
   #запуск/стоп компьюта
   #опциональный параметр
   #тип - булев
+  #используется при создании и обновлении
   #started = true
 
   #detach диска при удалении компьюта
   #опциональный параметр
   #тип - булев
+  #используется при удалении
   #detach_disks = true
 
-  #флаг для удаления компьюта
+  #флаг для удаления компьюта, без возможности восстановления
   #опциональный параметр
   #тип - булев
+  #используется при удалении
   #permanently = false
 
   #конфигурация параметров libvirt virtio интерфейса
@@ -486,51 +530,79 @@ resource "decort_cb_kvmvm" "comp" {
   #добавление блока возможно только при выключенной виртуальной машине,
   #удаление блока удалит настройки только локально, состояние на платформе не изменится
   #тип - блок
+  #используется при создании и обновлении
   #libvirt_settings {
-      #тип сети
-      #обязательный параметр
-      #возможные значения - "VINS", "VFNIC", "DPDK"
-      #тип - строка
-      #net_type = "VINS"
+    #тип сети
+    #обязательный параметр
+    #возможные значения - "VINS", "VFNIC", "DPDK"
+    #тип - строка
+    #net_type = "VINS"
 
-      #ID сети
-      #обязательный параметр
-      #тип - целое число
-      #net_id = 1234
+    #id сети
+    #обязательный параметр
+    #тип - целое число
+    #net_id = 1234
 
-      #tx mode
-      #опциональный параметр
-      #возможные значения - 'iothread', 'timer' или 'selected by hypervisor'
-      #тип - строка
-      #txmode = "iothread"
+    #tx mode
+    #опциональный параметр
+    #возможные значения - 'iothread', 'timer' или 'selected by hypervisor'
+    #тип - строка
+    #txmode = "iothread"
 
-      #IO event
-      #опциональный параметр
-      #возможные значения - 'on', 'off' or 'selected by hypervisor'
-      #тип - строка
-      #ioeventfd = "on"
+    #io event
+    #опциональный параметр
+    #возможные значения - 'on', 'off' or 'selected by hypervisor'
+    #тип - строка
+    #ioeventfd = "on"
 
-      #event ID
-      #опциональный параметр
-      #возможные значения - 'on', 'off' or 'selected by hypervisor'
-      #тип - строка
-      #event_idx = "off"
+    #event ID
+    #опциональный параметр
+    #возможные значения - 'on', 'off' or 'selected by hypervisor'
+    #тип - строка
+    #event_idx = "off"
 
-      #количество очередей
-      #опциональный параметр
-      #тип - целое число
-      #queues = "4"
+    #количество очередей
+    #опциональный параметр
+    #тип - целое число
+    #queues = "4"
 
-      #длина очереди RX
-      #опциональный параметр
-      #тип - целое число
-      #rx_queue_size = "1024"
+    #длина очереди RX
+    #опциональный параметр
+    #тип - целое число
+    #rx_queue_size = "1024"
 
-      #длина очереди TX
-      #опциональный параметр
-      #тип - целое число
-      #tx_queue_size = "1024"
-    #}
+    #длина очереди TX
+    #опциональный параметр
+    #тип - целое число
+    #tx_queue_size = "1024"
+  #}
+
+  #тип ВМ
+  #возможные значения - linux, windows, unknown
+  #опциональный параметр
+  #тип - строка
+  #используется при создании и обновлении
+  #loader_type = "unknown"
+
+  #тип загрузки образа
+  #возможные значения - bios, uefi
+  #опциональный параметр
+  #тип - строка
+  #используется при создании и обновлении
+  #boot_type = "bios"
+
+  #изменение размера ВМ
+  #опциональный параметр
+  #тип - булев
+  #используется при создании и обновлении
+  #hot_resize = false
+
+  #наименование сетевого интерфейса
+  #возможные значения - eth, ens
+  #опциональный параметр
+  #тип - строка
+  #используется при создании и обновлении
+  #network_interface_naming = "ens"
 }
 
 output "test" {