wiki-terraform-provider-decort

52 KiB

Raw Blame History Unescape Escape

Resource функция decort_kvmvm служит для управления виртуальными машинами, создаваемыми в платформе DECORT на базе технологии виртуализации KVM.

Работа с custom_fields

CustomFields - это новый метод работы с XML ВМ, пришедший на замену ComputeCI ачиная с версии провайдера 4.3.0. Для описания конфигурации используется файл в формате JSON, например:

customfields.json:

{
  "title": "test",
  "name": "basename",
  "cpu": {
    "mode": "host-model"
  }
}

После этого, достаточно передать файл в качестве значения параметра:

custom_fields = file("customfields.json")

Возможные затруднения при импорте kvmvm с extra_disks

При импорте kvmvm c extra_disks, терраформ не может записать в стейт информацию об extra_disks по следующим причинам:

терраформ на стадии импорта не производит чтение конфигурации, кроме проверки необходимых (requirement) полей, из-за чего данные, хранящиеся в поле extra_disks, будут непрочитаны; Из-за этого, при первом запуске команды terraform apply, терраформ сообщит что удалит эти диски из disks, но, при этом, удалены они не будут, если указаны в блоке extra_disks.

Работа boot_disk

В стейт в поле boot_disk записывается первый найденный диск с типом "B", остальные диски с типом "B" обрабатываются и записываются в массив disks.

Убраны deprecated поля

network_id
network_type

Возможные затруднения при работе с блоком disks.

По умолчанию, sep_id и pool в платформе выбираются те же, на которых размещается загрузочный диск (создается вместе с виртуальной машиной). Из-за этого, могут возникать ошибки следующего характера:

Cannot add disk to Compute ID XXX: Pool xxxx does not support disk type X - данная ошибка означает то, что выбранный пул не поддерживает выбранные тип диска Пути решения:
Выполнить decort_disk_list_types_detailed. Результатом выполнения этой функции станет список доступных пулов хранилища вместе с их идентификаторами (sep_id).
Заполнить поля sep_id и pool подходящими полями для диска.
При удалении не последнего блока в списке, перед подтверждением Terraform не правильно отображает диск, который будет удаляться. На самом деле из состояние будет удален тот диск, который был убран из файла. Также будет нужен дополнительное выполнение terraform apply для того чтобы все блоки сейта терраформа встали на свои места и не отличались от настоящего состояния ресурса

Важно: при удалении в конфигурационном файле Terraform любого блока disks, на платформе будет удален последний. При необходимости удалить не последний блок, рекомендуем пользоваться web интерфейсом платформы. Поведение будет исправлено в следующих версиях.

Работа с cloud_init

Cloud Init позволяет запустить ВМ с предустановленными настройками пользователя, группами и доступами. Подробнее про настройку cloud_init можно прочесть по ссылке.

Пароли, указанные в cloud_init не сохраняются на платформе и не отображаются в API!

Для использования cloud_init конфигурации, следует:

Создать файл с расширением .tftpl в рабочей директории.
Описать в созданном файле конфигурацию cloud_init в формате JSON. Если ранее конфигурация cloud_init ранее была создана в формате YAML, можно воспользоваться любым онлайн конвертером, например: https://onlineyamltools.com/convert-yaml-to-json

initconfig.tftpl

{
  "users": [
    {
      "groups": "users, wheel",
      "name": "user",
      "plain_text_passwd": "examplePassword",
      "primary_group": "user",
      "ssh_authorized_keys": [
        "ssh-rsa EXAMPLE%id_rsa.pub"
      ],
      "sudo": "ALL=(ALL) NOPASSWD:ALL"
    }
  ]
}

Указать путь до файла initconfig.tftpl в качестве значения параметра cloud_init в ресурсе decort_kvmvm:

resource "decort_kvmvm" "compute1" {
   # ...

   cloud_init = file("initconfig.tftpl")

   # ...
}

Выполнить terraform apply

Конфигурация cloud_init применяется только при создании компьюта, во всех остальных случаях - игнорируется

Работа с полем weight в блоке network

В версии 4.7.0 в блоке network добавлено опциональное поле weight, которое можно использовать, в случае, когда необходимо указать порядок подключения сетей, т.к. по умолчанию сети подключаются в случайном порядке. Сети с наименьшим весом будут подключены в первую очередь. Сети с неуказанным или нулевым значением будут подключены в последнюю очередь (иметь наименьший приоритет) В случае, если все сети не имеют параметра весов, подключение будет производится как и раньше. При выполнении update сортироваться будут только вновь подключаемые сети, порядок уже подключенных сетей остается без изменения. Так же следует обратить внимание, что если при update была отключена какая либо сеть, то вновь подключаемые сети с наименьшим весом сети займут ранее освобожденные интерфейсы, и только после будут добавляться в конец списка подключенных сетей. При изменении или удалении данного поля, в уже созданном ресурсе, сеть будет считаться вновь подключаемой и следовательно будет отключена от VM и подключена по новой, с учетом веса подключаемых сетей.

Аргументы

Resource функция decort_kvmvm принимает следующие аргументы:

Аргумент	Тип	Обязательный	Описание
driver	string	✔️	Аппаратная архитектура виртуальной машины. Может принимать одно из следующих значений: _ "KVM_X86" - stateful виртуальная машина KVM на аппаратной платформе x86. _ "SVA_KVM_X86" - stateless ВМ на аппаратной платформе x86.
name	string	✔️	Имя виртуальной машины. Обратите внимание, что имя должно быть уникальным в рамках ресурсной группы
rg_id	int	✔️	Идентификатор ресурсной группы, которой принадлежит данная виртуальная машина
ram	int	✔️	Объём оперативной памяти в МБ.
boot_disk_size	int	❌	Размер загрузочного диска виртуальной машины в ГБ
chipset	string	❌	Тип эмулируемой системы
custom_fields	string (json-encoded)	❌	Управление XML виртуальной машины
extra_disks	[]int	❌	Список идентификаторов дополнительных дисков, которые требуется подключить к данной виртуальной машине помимо загрузочного диска
image_id	int	❌	Идентификатор образа, на базе которого создаётся загрузочный диск виртуальной машины.
cloud_init	string	❌	Используется на этапе создания вм. Параметры для утилиты cloud_init, которая используется в платформе DECORT для первичного конфигурирования виртуальной машины после её создания. Файл в формате JSON.
network	[]Struct см. ниже	❌	Параметры сетевого подключения. Если нужно сконфигурировать несколько сетевых подключений, данный блок можно задавать многократно - по одному на каждое подключение
description	string	❌	Текстовое описание виртуальной машины
started	bool	❌	Флаг запуска машины, по-умолчанию - true. Если true - машина включена, если false - выключена
sep_id	int	❌	Идентификатор sep
pool	string	❌	Наименование пула для размещения
is	string	❌	Наименование системы
ipa_type	string	❌	Тип аутентификатора
permanently	bool	❌	Мгновенное удаление виртуальной машины, минуя корзину. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса
detach_disks	bool	❌	Отсоединение прикрепленных к виртуальной машине дисков перед ее удалением. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса
disks	[]Struct см. ниже	❌	Описание диска. Таких может быть любое кол-во, либо не быть вообще
enabled	bool	❌	Доступность вычислительной машины
affinity_label	string	❌	Метка для правил affinity
affinity_rules	[]Struct см. ниже	❌	Блок описания правил affinity. Блоков может быть несколько, один или отсутствовать
anti_affinity_rules	[]Struct см. ниже	❌	Блок описания правил anti-affinity. Блоков может быть несколько, один или отсутствовать
tags	[]Struct см. ниже	❌	Задание тэгов компьюта
port_forwarding	[]Struct см. ниже	❌	Настройка порт форвардинга для компьюта
user_access	[]Struct см. ниже	❌	Предоставление доступов к компьюту
snapshot	[]Struct см. ниже	❌	Создание мнапшотов
rollback	[]Struct см. ниже	❌	Rollback на определенный снапшот
cd	[]Struct см. ниже	❌	Добавление диска cd rom
pin_to_stack	bool	❌	Флаг, отвечающий за добавление кмпьюта в стэк
auto_start_w_node	bool	❌	Флаг, отвечающий за автостарт при рестарте ноды
pause	bool	❌	Флаг, отвкчающий за pause/resume компьюта
reset	bool	❌	Флаг, отвкчающий за reset компьюта
auto_start	bool	❌	Флаг, отвечающий за авто старт при редеплое компьюта
force_stop	bool	❌	Флаг, отвечающий за стоп при редеплое компьюта
force_resize	bool	❌	Флаг для изменения CPU и RAM в принудительном порядке
data_disks	string	❌	Указание того, что делать с дисками при редеплое. Возможные значения: "KEEP", "DETACH" и "DESTROY"
restore	bool	❌	Восстановить удаленный компьют из корзины
cpu_pin	bool	❌	Необходимость запускать ВМ на выделенных CPU ядрах
numa_affinity	string	❌	Необходимость выравнивать ВМ по NUMA. Возможные значения - "none, "strict", "loose"
hp_backed	bool	❌	Необходимость использовать для выделения RAM виртуальной машины Huge Pages ядрах
without_boot_disk	bool	❌	Флаг отсутствия загрузочного диска
snapshot_delete_async	bool	❌	Флаг для удаления снапшотов в асинхронном режиме
pci_devices	[]int	❌	Список PCI девайсов

Описание блока disks

Аргумент	Тип	Обязательный	Описание
disk_name	string	✔️	Наименование диска
size	int	✔️	Размер диска, GB
disk_type	string	❌	Тип диска. Возможные значения: "D" - диск с данными, "B" - загрузочный диск
sep_id	int	❌	ID storage endpoint
pool	string	❌	Наименование пула для размещения диска
desc	string	❌	Описание диска
image_id	int	❌	ID образа
permanently	bool	❌	Флаг для удаления диска. Если выставлен в true - диск будет моментально удален с платформы, иначе будет добавлен в корзину и его можно будет восстановить. Значение поля считывается только при операции `terraform destroy`. По умолчанию - false

Описание блока network

Аргумент	Тип	Обязательный	Описание
net_type	string	✔️	тип сети, соответствующей данному подключению. "EXTNET" в случае прямого подключения во внешнюю сеть, "VINS" в случае подключения к Virtual Network Segment.
net_id	int	✔️	идентификатор соответствующего сетевого сегмента: внешней сети в случае `net_type = "EXTNET"`, ViNS в случае `net_type = "VINS"`, VFNIC в случае `net_type="VFNIC`, и DPDK в случае `net_type = "DPDK"`
ip_address	string	❌	IP адрес, выделенный данному подключению.
weight	int	❌	Вес сети, указывается при необходимости указания порядка подключения сетей. Первой подключается сеть с наименьшим весом. Сеть с нулевым или неуказанным весом имеет наименьший приоритет
mtu	int	❌	Максимальный объём данных, который может быть передан за одну итерацию. Применяется только для DPDK сетей. Может быть от 1 до 9216

Описание блока affinity_rules

Аргумент	Тип	Обязательный	Описание
topology	string	✔️	Тип правила. Возможные значения - node, compute
policy	string	✔️	Строгость правила. Возможные значения - RECOMMENDED (рекомендовано) и REQUIRED (обязательно)
mode	string	✔️	Режим проверки. Возможные значения - EQ (равно), NE (не равно), ANY - любое
key	string	✔️	Ключ правила
value	string	❌	Значение правила

Описание блока anti_affinity_rules

Аргумент	Тип	Обязательный	Описание
topology	string	✔️	Тип правила. Возможные значения - node, compute
policy	string	✔️	Строгость правила. Возможные значения - RECOMMENDED (рекомендовано) и REQUIRED (обязательно)
mode	string	✔️	Режим проверки. Возможные значения - EQ (равно), NE (не равно), ANY - любое
key	string	✔️	Ключ правила
value	string	❌	Значение правила

Описание блока tags

Аргумент	Тип	Обязательный	Описание
key	string	✔️	Ключ тэга
val	string	✔️	Значение тэга

Описание блока port_forwarding

Аргумент	Тип	Обязательный	Описание
public_port_start	int	✔️	Начало диапазона внешних портов для данного правила pfw
public_port_end	int	❌	Конец диапазона внешних портов для данного правила pfw
local_port	int	❌	Локальный порт для данного правила pfw
proto	string	✔️	Протокол создания правила pfw. Возможные значения: "tcp" или "udp"

Описание блока user_access

Аргумент	Тип	Обязательный	Описание
username	string	✔️	Юзер, которому необходимо выдать определенные права на компьют
access_type	string	✔️	Права, которые выдадутся юзеру на компьют. Возможные значения: "R", "RCX" или "ARCXDU"

Описание блока snapshot

Аргумент	Тип	Обязательный	Описание
label	string	✔️	Лейбл снапшота

Описание блока rollback

Аргумент	Тип	Обязательный	Описание
label	string	✔️	Лейбл снапшота на который нужно сделать rollback

Описание блока cd

Аргумент	Тип	Обязательный	Описание
cdrom_id	int	✔️	Идентификатор образа cdrom диска

Возвращаемые значения

В случае успешного выполнения resource функция decort_kvmvm возвращает в указанную при вызове переменную следующие значения:

Параметр	Тип	Описание
account_id	int	Уникальный идентификатор подписчика-владельца ("account") данной виртуальной машины.
account_name	string	Имя подписчика, которому принадлежит данная виртуальная машина.
affinity_label	string	Метка для правил affinity
affinity_weight	int	weight аффинити
arch	string	Архитектура
auto_start_w_node	bool	Флаг, отвечающий за автостарт при рестарте ноды
boot_order	[]string	Boot order
boot_disk	[]Struct см. ниже	Полная информация о бутдиске
boot_disk_id	int	Идентификатор загрузочного диска виртуальной машины.
boot_disk_size	int	Размер загрузочного диска в ГБ.
driver	string	Аппаратная архитектура данной виртуальной машины.
disks	см. ниже	Описание диска. Таких может быть любое кол-во, либо не быть вообще
chipset	string	Тип эмулируемой системы
clone_reference	int	кол-во клонов
clones	[]int	id клонов
computeci_id	int	Id computeci
cd_image_id	int	ID cd image id
cpu_pin	bool	Необходимость запускать ВМ на выделенных CPU ядрах
cpu	int	Количество виртуальных CPU, выделенных данному серверу.
created_by	string	Кем создан ресурс
created_time	int	Время создания ресурса
custom_fields	string	Кастомные поля
deleted_by	string	Кем удален ресурс
deleted_time	int	Время удаления ресурса
description	string	Текстовое описание виртуальной машины.
detach_disks	bool	Отсоединение прикрепленных к виртуальной машине дисков перед ее удалением. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса
devices	string	Девайсы
enabled	bool	Доступность вычислительной машины
extra_disks	list of ints	Список идентификаторов дополнительных дисков, которые подключены к данной виртуальной машине помимо загрузочного диска. Если такие диски отсутствуют, то список будет пустым.
gid	int	GID
guid	int	GUID
hp_backed	bool	Необходимость использовать для выделения RAM виртуальной машины Huge Pages ядрах
compute_id	int	Идентификатор экземпляра compute, соответствующего данной виртуальной машине.
id	int	Уникальный идентификатор этой виртуальной машины в облачной платформе. Всегда совпадает с `compute_id`.
image_id	int	Идентификатор образа ОС, на базе которого создан загрузочный диск этой виртуальной машины.
interfaces	[]Struct см. ниже	Информация о интерфейсах компьюта
ipa_type	string	Тип аутентификатора
is	string	Наименование системы
lock_status	string	Статус доступности
manager_id	int	Manager id
manager_type	string	Type manager
migrationjob	int	Migrationjob
milestones	int	Вехи
name	string	Имя виртуального сервера. Возвращаемое значение `name` совпадает со значением соответствующего аргумента, переданного при вызове функции.
natable_vins_id	int	NAT vins id
natable_vins_ip	string	NAT vins ip
natable_vins_name	string	NAT vins name
natable_vins_network	string	NAT vins network
natable_vins_network_name	string	NAT vins network name
need_reboot	bool	Флаг, указывающий, что требуется перезагрузка
numa_affinity	string	Необходимость выравнивать ВМ по NUMA
numa_node_id	int	ID узла NUMA
network	[]Struct см. ниже	Параметры сетевого подключения
os_users	[]Struct см. ниже	Имена и пароли пользователей гостевой ОС, установленные платформой при создании виртуального сервера. Формат структуры: _ (string) `login` - учётная запись в гостевой ОС. _ (string) `password` - пароль к этой учётной записи.
permanently	bool	Мгновенное удаление виртуальной машины, минуя корзину. Параметр считывается только при использовании команды `terraform destroy`, то есть только при удалении ресурса
pinned	bool	добавлен ли компьют на стек
pool	string	Наименование пула для размещения
ram	int	Объём оперативной памяти в МБ, выделенной этой виртуальной машине.
reference_id	string	ID reference
registered	bool	Компьют зарегестрирован
res_name	string	Res name
reserved_node_cpus	[]int	Количество зарезервированных CPU в узле
reset	bool	Флаг отвкчающий за reset компьюта
rg_id	int	Идентификатор ресурсной группы, к которой принадлежит виртуальная машина.
rg_name	string	Имя ресурсной группы, к которой принадлежит виртуальная машина.
sep_id	int	Идентификатор sep
snap_sets	[]Struct см. ниже	Snap sets
started	bool	Опциональный параметр, флаг запуска машины, по-умолчанию - true. Если true - машина включена, если false - выключена.
stateless_sep_id	int	ID сепа
stateless_sep_type	string	Тип сепа
status	string	Cтатус
tech_status	string	Технический статус
updated_by	string	Кем обновлен ресурс
updated_time	int	Время обновления ресурса
user_managed	bool	User managed
cloud_init	string	Параметры cloud_init
pci_devices	[]int	Список PCI девайсов
vnc_password	string	vnc пароль
vgpus	[]int	Список vgpu
virtual_image_id	int	ID виртуального образа
virtual_image_name	string	Имя образа ОС, на базе которого создан загрузочный диск этой виртуальной машины.

Описание структуры interfaces

Параметр	Тип	Описание
bus_number	int	Номер шины
conn_id	int	ID connect
conn_type	string	Тип connect
def_gw	string	Шлюз по умолчанию
enabled	bool	Доступность подключения
flip_group_id	int	id flip group
guid	string	GUID
ip_address	string	IP адрес
listen_ssh	bool	открыт ли ssh connect
mac	string	MAC адрес устройства
mtu	string	Максимальный объём данных, который может быть передан за одну итерацию
name	string	Имя
net_id	int	ID сети
netmask	int	Маска сети
net_type	string	Тип сети
node_id	int	ID узла
pci_slot	int	Pci Slot
qos	[]Struct{}см. ниже	QOS
target	string	Цель сети
type	string	Тип
vnfs	[]int	VNFS
libvirt_settings	[]Struct{}см. ниже	Параметры libvirt virtio интерфейса

Описание структуры libvirt_settings

Параметр	Тип	Описание
guid	string	GUID
txmode	string	TX mode
ioeventfd	string	IO event
event_idx	string	Event ID
queues	int	Количество очередей
rx_queue_size	int	Длина очереди RX
tx_queue_size	int	Длина очереди TX

Описание структуры networks

Параметр	Тип	Описание
net_type	string	тип сети, соответствующей данному подключению. "EXTNET" в случае прямого подключения во внешнюю сеть, "VINS" в случае подключения к Virtual Network Segment.
net_id	int	идентификатор соответствующего сетевого сегмента: внешней сети в случае `net_type = "EXTNET"`, ViNS в случае `net_type = "VINS"`, VFNIC в случае `net_type="VFNIC`, и DPDK в случае `net_type = "DPDK"`
ip_address	string	IP адрес, выделенный данному подключению.
mac	string	MAC адрес, назначенный соответствующему сетевому интерфейсу виртуальной машины.
weight	int	Вес сети, указывается при необходимости указания порядка подключения сетей. Первой подключается сеть с наименьшим весом. Сеть с нулевым или неуказанным весом имеет наименьший приоритет
mtu	int	❌

Описание структуры qos

Параметр	Тип	Описание
e_rate	int	E rate
guid	string	ID ресурса
in_brust	int	In brust
in_rate	int	In rate

Описание структуры os users

Параметр	Тип	Описание
guid	string	GUID
login	string	Логин
password	string	Пароль
public_key	string	Публичный ssh ключ

Описание структуры snap sets

Параметр	Тип	Описание
disks	[]int	Список id дисков
guid	string	GUID
label	string	Лейбл
timestamp	int	Время

Описание структуры boot_disk

Параметр	Тип	Описание
desc	string	Описание диска
disk_id	int	ID диска
disk_name	string	Наименование диска
disk_type	string	Тип диска (B)
image_id	int	ID образа диска
pool	string	Наименование пула
sep_id	int	Storage Endpoint ID
shareable	bool	Доступность другим ресурсам
size	int	Размер диска
size_max	int	Максимальный размер диска
size_used	float	Используемый размер

Описание блока disks

Аргумент	Тип	Описание
disk_id	int	ID диска
disk_name	string	Наименование диска
size	int	Размер диска, GB
disk_type	string	Тип диска. Возможные значения: "D" - диск с данными, "B" - загрузочный диск
sep_id	int	ID storage endpoint
shareable	bool	Флаг, отвечающий за доступность диска дургим ресурсам
size_max	int	Размер диска
size_used	float	Размер занимаемого на диске места
pool	string	Наименование пула для размещения диска
desc	string	Описание диска
image_id	int	ID образа

Пример использования

В нижеприведённом примере с помощью resource функции decort_kvmvm создаётся виртуальная машина (экземпляр compute в терминологии платформы DECORT) следующими характеристиками:

Имя виртуальной машины - "tf-managed-vm"
Характеристики виртуальной машины - 1 CPU, 1024Мб RAM, размер загрузочного диска 10Гб
К виртуальной машине будет подключён один дополнительный диск с идентификатором 56789
Идентификатор ресурсной группы, в которой создаётся виртуальная машина - поступает из переменной decort_resgroup.my_rg.id
Идентификатор образа ОС, который будет установлен на загрузочный диск - поступает из переменной data.decort_image.os_image.id
Виртуальная машина будет иметь одно сетевое подключение - во внешнюю сеть с идентификатором 12, IP адрес этого подключения платформа установит автоматически
Для виртуальной машины будет создан и автоматически подключен диск с именем "test_disk" и размером в 10 GB. Созданный диск будет иметь тип "D", размещен в pool "test_pool", в хранилище с идентификатором 3. Данный диск будет создан с системным образом, который имеет идентификатор 3456.

resource "decort_kvmvm" "comp" {
  #имя compute
  #может быть изменен
  #обязательный параметр
  #тип - строка
  name = "test-tf-compute-update-new"

  #id resource group
  #обязательный параметр
  #тип - целое число
  rg_id = 1111

  #тип драйвера для compute
  #обязательный параметр
  #тип - строка
  #возможные значения: "SVA_KVM_X86", "KVM_X86"
  driver = "KVM_X86"

  #число cpu
  #обязательный параметр
  #тип - целое число
  cpu = 1

  #кол-во оперативной памяти, МБ
  #обязательный параметр
  #тип - целое число
  ram = 2048

  #тип эмулируемой системы
  #опциональный параметр
  #тип - строка
  #возможные значения: "i440fx", "Q35"
  chipset = "i440fx"

  #размер загрузочного диска
  #опциональный параметр
  #тип - целое число
  boot_disk_size = 20

  #id сепа для boot диска
  #опциональный параметр
  #тип - целое число
  sep_id = 1

  #название пула
  #опциональный параметр
  #тип - строка
  pool = "data02"

  #конфигурация cloud init
  #опциональный параметр
  #тип - файл в формате JSON
  cloud_init = file("initconfig.tftpl")

  #описание compute
  #опциональный параметр
  #тип - строка
  description = "test update description in tf words update"

  #id образа диска для создания compute
  #опциональный параметр
  #тип - целое число
  image_id = 111

  #создание без загрузочного диска в остановленном состоянии
  #опциональный параметр
  #если значение равно True, параметры image_id, boot_disk_size, sep_id, pool игнорируются
  #тип - булев
  without_boot_disk = true

  #необходимость выравнивать ВМ по NUMA
  #опциональный параметр
  #возможные значения - "none, "strict", "loose"
  #значение по умолчанию - "none"
  #тип - строка
  numa_affinity = "loose"

  #необходимость запускать ВМ на выделенных CPU ядрах
  #опциональный параметр
  #значение по умолчанию - false
  #тип - булев
  cpu_pin = true

  #необходимость использовать для выделения RAM виртуальной машины Huge Pages
  #опциональный параметр
  #значение по умолчанию - false
  #тип - булев
  hp_backed = true

  #список PCI девайсов
  #опциональный параметр
  #тип - массив целых чисел
  pci_devices = [1,2]

  #создание и добавление диска дял compute
  #опциональный параметр
  #тип - список дисков
  disks {
    #Имя диска
    #Обязательный для диска параметр
    #тип - строка
    disk_name = "disk_name"

    #Размер диска
    #Обязательный для диска параметр
    #тип - целоетчисло
    size = 5

    #тип диска
    #опциональный параметр
    #тип - строка
    disk_type = "D"

    #id стораджа
    #опциональный параметр
    #тип - целое число
    sep_id = 1

    #название пула
    #опциональный параметр
    #тип - строка
    pool = "data01"

    #описание диска
    #опциональный параметр
    #тип - строка
    desc = ""

    #id образа
    #опциональный параметр
    #тип - целое число
    image_id = 378

    #флаг для удаления диска
    #опциональный параметр
    #тип - булев
    permanently = false
  }

  #правила affinity
  #опциональный параметр
  #может быть один, несколько или ни одного блока
  #тип - блок правил
  affinity_rules {
    #тип правила
    #обязательный параметр
    #возможные значения - compute или node
    #тип - строка
    topology = "compute"

    #строгость правила
    #обязательный параметр
    #возможные значения - RECOMMENDED и REQUIRED
    #тип - строка
    policy = "RECOMMENDED"

    #режим проверки 
    #обязательный параметр
    #возможные значения - ANY, EQ, NE
    #тип - строка
    mode = "ANY"

    #ключ правила
    #обязательный параметр
    #тип - строка
    key = "testkey"

    #ключ правила
    #необязательный параметр
    #тип - строка
    value = "testvalue"
  }

  #правила anti-affinity
  #опциональный параметр
  #может быть один, несколько или ни одного блока
  # тип - список правил
  anti_affinity_rules {
    #тип правила
    #обязательный параметр
    #возможные значения - compute или node
    #тип - строка
    topology = "compute"

    #строгость правила
    #обязательный параметр
    #возможные значения - RECOMMENDED и REQUIRED
    #тип - строка
    policy = "RECOMMENDED"

    #режим проверки 
    #обязательный параметр
    #возможные значения - ANY, EQ, NE
    #тип - строка
    mode = "ANY"

    #ключ правила
    #обязательный параметр
    #тип - строка
    key = "testkey"

    #ключ правила
    #необязательный параметр
    #тип -строка
    value = "testvalue"
  }

  #установка метки для вм
  #опциональный параметр
  #тип - строка
  affinity_label = "test4"


  #наименование системы
  #опциональный параметр
  #используется при создании вм
  #по умолчанию - не задан
  #тип - строка
  is = ""

  #назначение вм
  #опциональный параметр
  #используется при создании вм
  #по умолчанию - не задан
  #тип - строка
  ipa_type = ""

  #id экстра дисков
  #опциональный параметр
  #тип - список целых чисел
  extra_disks = [1234, 4322, 1344]

  #присоединения сетей и удаление сетей в компьюте
  #опциональный параметр
  #тип - блок сетей
  network {
    #тип сети
    #обязательный параметр
    #тип - строка
    #возможные значения - "VINS", "EXTNET", "VFNIC", "DPDK" (при выборе типа DPDK, необходимо указать hp_backed = true)
    net_type = "VINS"

    #id сети
    #обязательный параметр
    #тип - целое число
    net_id = 1234

    #ip адрес входящий в сеть
    #опциональный параметр
    #тип - строка
    ip_address = "127.0.0.1"

    #вес сети, указывается при необходимости указания порядка подключения сетей
    #первой подключается сеть с наименьшим весом
    #сеть с нулевым или неуказанным весом имеет наименьший приоритет
    #опциональный параметр
    #тип - целое число
    weight = 15

    #максимальный объём данных, который может быть передан за одну итерацию
    #используется только с сетями типа "DPDK"
    #возможные значения - 1-9216
    #опциональный параметр
    #тип - целое число
    mtu = 1500
  }

  #добавление и удаление тэгов
  #опциональный параметр
  #тип - блок тэгов
  tags {
    #Ключ для тэга
    #Обязательный параметр
    #тип - строка
    key = "key"

    #значения тэга
    #обязательный параметр
    #тип - строка
    value = "value"
  }

  #добавление и удаление port forwarding
  #опциональный параметр
  #тип - блок переадресации портов
  port_forwarding {
    #номер внешнего начального порта для правила
    #Обязательный параметр
    #тип - целое число
    public_port_start = 2023

    #номер внешнего последнего порта для правила
    #опциональный параметр
    #тип - целое число
    #по умолчанию - -1
    public_port_end = 2023

    #номер внутреннего базового порта
    #обязательный параметр
    #тип - целое число
    local_port = 80

    #сетевой протокол
    #Обязательный параметр
    #тип - строка
    proto = "tcp"
  }

  #предоставить/забрать пользователю доступ к компьюту
  #опциональный параметр
  #тип - блок прав пользователя
  user_access {
    #имя юзера, которому предоставляем доступ
    #обязательный параметр
    #тип - строка
    username = "kasim_baybikov_1@decs3o"

    #права: 'R' - только на чтение, 'RCX' - чтение/запись, 'ARCXDU' - админ
    #обязательный параметр
    #тип - строка
    access_type = "ARCXDU"
  }

  #создать/удалить снапшот компьюта
  #опциональный параметр
  #тип - блок снапшотов
  snapshot {
    #лейбл снапшота
    #обязательный параметр
    #тип - строка
    label = "label1"
  }

  #флаг для удаления снапшотов в асинхронном режиме
  #опциональный параметр
  #дефолтное значение - false
  #тип - булев
  snapshot_delete_async = true

  #rollback на нужный снапшот
  #опциональный параметр
  #Не имеет смысла при отсутсвии снапшотов
  #тип - блок rollback
  rollback {
    #Лейбл снапшота
    #Обязательный параметр
    #тип - строка
    label = "label1"
  }

  #вставить/удалить СD rom
  #опциональный параметр
  #максимальное кол-во - 1
  #тип - блок cd
  cd {
    #id образа диска CD rom
    #обязательный параметр
    #тип - целое число
    cdrom_id = 344
  }

  #добавить компьют на стэк
  #опциональный параметр
  #тип - булев
  pin_to_stack = true

  #флаг для старта компьюта при рестарте ноды
  #опциональный параметр
  #тип - булев
  auto_start_w_node = true

  #флаг доступности компьюта для проведения с ним операций
  #опциональный параметр
  #тип - булев
  enabled = true

  #pause/resume компьюта
  #опциональный параметр
  #тип - булев
  pause = true

  #сделать компьют заново
  #опциональный параметр
  #тип - булев
  reset = true

  #восстановить компьют из корзины
  #опциональный параметр
  #тип - булев
  restore = true

  #флаг для редеплоя компьюта
  #опциональный параметр
  #тип - булев
  auto_start = true

  #флаг для редеплоя компьюта
  #опциональный параметр
  #тип - булев
  force_stop = true

  #флаг для ресайза компьюта
  #опциональный параметр
  #тип - булев
  force_resize = true

  #поле для редеплоя компьюта
  #опциональный параметр
  #тип - строка
  data_disks = "KEEP"

  #запуск/стоп компьюта
  #опциональный параметр
  #тип - булев
  started = true

  #detach диска при удалении компьюта
  #опциональный параметр
  #тип - булев
  detach_disks = true

  #флаг для удаления компьюта
  #опциональный параметр
  #тип - булев
  permanently = false
}

initconfig.tftpl

{
  "users": [
    {
      "groups": "users, wheel",
      "name": "user",
      "plain_text_passwd": "examplePassword",
      "primary_group": "user",
      "ssh_authorized_keys": [
        "ssh-rsa EXAMPLE%id_rsa.pub"
      ],
      "sudo": "ALL=(ALL) NOPASSWD:ALL"
    }
  ]
}

Данный пример подразумевает, что ранее по тексту tf-файла :

выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий раздел).
создан ресурс типа decortresgroup (см. _resource функцию decort_resgroup) и результат записан в переменную decort_resgroup.my_rg
считана информация об образе ОС(см. data функцию decort_image) и результат записан в переменную decort_resgroup.os_image

После успешного завершения такого вызова resource функции decort_kvmvm в переменной decort_kvmvm.comp будут сохранены возвращаемые значения. В частности, для получения идентификатора виртуальной машины следует использовать конструкцию decort_kvmvm.comp.id.

52 KiB Raw Blame History Unescape Escape

Работа с custom_fields

Возможные затруднения при импорте kvmvm с extra_disks

Работа boot_disk

Убраны deprecated поля

Возможные затруднения при работе с блоком disks.

Работа с cloud_init

initconfig.tftpl

Работа с полем weight в блоке network

Аргументы

Описание блока disks

Описание блока network

Описание блока affinity_rules

Описание блока anti_affinity_rules

Описание блока tags

Описание блока port_forwarding

Описание блока user_access

Описание блока snapshot

Описание блока rollback

Описание блока cd

Возвращаемые значения

Описание структуры interfaces

Описание структуры libvirt_settings

Описание структуры networks

Описание структуры qos

Описание структуры os users

Описание структуры snap sets

Описание структуры boot_disk

Описание блока disks

Пример использования

initconfig.tftpl

52 KiB

Raw Blame History Unescape Escape