Updated 07.01.01 Resource функция decort_kvmvm управление виртуальными машинами на базе KVM (markdown)

stSolo
2022-12-08 17:37:32 +03:00
parent 5c5abf9f8a
commit 9ceb8ec8ab

@@ -1,5 +1,11 @@
_Resource_ функция **decort_kvmvm** служит для управления виртуальными машинами, создаваемыми в платформе DECORT на базе технологии виртуализации KVM. _Resource_ функция **decort_kvmvm** служит для управления виртуальными машинами, создаваемыми в платформе DECORT на базе технологии виртуализации KVM.
## Изменения в 3.2.2
Добавлена обработка статусов виртуальной машины.
Если статус __DELETED__, то при попытке изменения конфигурационного файла, машина будет автоматически восстановлена.
Если статус __DESTROYED__, то при попытке изменения конфигурационного файла, машина будет автоматически пересоздана.
Начиная с версии 3.2.2, в ресурсе kvmvm появляется опциональное поле `enabled`, которое принимает в себя булево значение. Поле отвечает за ручную регуляцию статуса доступности вычислительной машины, автоматическая регуляция так же имеется - восстановленная и вновь созданная виртуальная машине переводится в режим `enabled = true`.
## Изменения в 3.2.1 ## Изменения в 3.2.1
Начиная с версии 3.2.1, в ресурсе kvmvm имеется возможность задать конфигурацию сети, с которой будет происходить создание. Такой сетью является первый блок __network__ в конфигурационном файле, описывающем ресурс виртуальной машины. Все остальные блоки, если они были добавлены при создании ресурса, являются сетями, которые будут подключены с помощью вызова метода cloudapi/netAttach. Начиная с версии 3.2.1, в ресурсе kvmvm имеется возможность задать конфигурацию сети, с которой будет происходить создание. Такой сетью является первый блок __network__ в конфигурационном файле, описывающем ресурс виртуальной машины. Все остальные блоки, если они были добавлены при создании ресурса, являются сетями, которые будут подключены с помощью вызова метода cloudapi/netAttach.
Если блоков __network__ не было задано при создании ресурса, то будет использован `net_type = NONE` Если блоков __network__ не было задано при создании ресурса, то будет использован `net_type = NONE`
@@ -42,6 +48,7 @@ _Resource_ функция **decort_kvmvm** принимает следующие
| permanently | bool | :x: | Мгновенное удаление виртуальной машины, минуя корзину. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса | | permanently | bool | :x: | Мгновенное удаление виртуальной машины, минуя корзину. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса |
| detach_disks | bool | :x: | Отсоединение прикрепленных к виртуальной машине дисков перед ее удалением. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса | | detach_disks | bool | :x: | Отсоединение прикрепленных к виртуальной машине дисков перед ее удалением. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса |
| disks | см. ниже | :x: | Описание диска. Таких может быть любое кол-во, либо не быть вообще | | disks | см. ниже | :x: | Описание диска. Таких может быть любое кол-во, либо не быть вообще |
| enabled | bool | :x: | Доступность вычислительной машины |
### Описание блока disks ### Описание блока disks
| Аргумент | Тип | Обязательный | Описание | | Аргумент | Тип | Обязательный | Описание |
@@ -86,6 +93,7 @@ _Resource_ функция **decort_kvmvm** принимает следующие
| permanently | bool | Мгновенное удаление виртуальной машины, минуя корзину. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса | | permanently | bool | Мгновенное удаление виртуальной машины, минуя корзину. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса |
| detach_disks | bool | Отсоединение прикрепленных к виртуальной машине дисков перед ее удалением. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса | | detach_disks | bool | Отсоединение прикрепленных к виртуальной машине дисков перед ее удалением. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса |
| disks | см. ниже | Описание диска. Таких может быть любое кол-во, либо не быть вообще | | disks | см. ниже | Описание диска. Таких может быть любое кол-во, либо не быть вообще |
| enabled | bool | Доступность вычислительной машины |
### Описание блока disks ### Описание блока disks
| Аргумент | Тип | Описание | | Аргумент | Тип | Описание |
@@ -98,7 +106,6 @@ _Resource_ функция **decort_kvmvm** принимает следующие
| pool | string | Наименование пула для размещения диска | | pool | string | Наименование пула для размещения диска |
| desc | string | Описание диска | | desc | string | Описание диска |
| image_id | int | ID образа | | image_id | int | ID образа |
| permanently | bool | Флаг для удаления диска. Если выставлен в true - диск будет моментально удален с платформы, иначе будет добавлен в корзину и его можно будет восстановить. Значение поля считывается только при операции `terraform destroy`. По умолчанию - false |
## Пример использования ## Пример использования
В нижеприведённом примере с помощью _resource_ функции **decort_kvmvm** создаётся виртуальная машина (экземпляр _compute_ в терминологии платформы DECORT) следующими характеристиками: В нижеприведённом примере с помощью _resource_ функции **decort_kvmvm** создаётся виртуальная машина (экземпляр _compute_ в терминологии платформы DECORT) следующими характеристиками:
@@ -136,6 +143,7 @@ resource "decort_kvmvm" "my_new_vm" {
#started = true #started = true
#enabled = true
} }
``` ```