170 lines
12 KiB
YAML
170 lines
12 KiB
YAML
name: vc_vdc
|
||
service_id: 21
|
||
service_display_name: Виртуальный датацентр (vDC)
|
||
service_short_name: vc_vdc
|
||
service_man: '# Инструкция по развертыванию Виртуальный датацентр (vDC) через платформу<br/><br/>## 1. Общая информация<br/><br/>**Виртуальный датацентр (vDC)** — это логическая изолированная среда в VMware Cloud Director, предназначенная для размещения и управления виртуальными машинами, сетевой инфраструктурой и ресурсами хранения. Сервис обеспечивает выделение вычислительных ресурсов под конкретную организацию и предоставляет гибкие параметры масштабирования, контроля потребления и разделения ресурсов.<br/><br/>### Доступные операции<br/><br/>**create** — Создание виртуального датацентра (vDC) с заданными параметрами CPU, RAM, Storage и сетевой конфигурацией.<br/>**delete** — Удаление vDC. Требуется предварительный перевод vDC в состояние *suspend*. Полное удаление возможно через 14 дней.<br/>**modify** — Внесение изменений в параметры ресурсов (CPU/RAM/Storage), выделенных для vDC.<br/>**suspend** — Заморозка vDC. Новые ресурсы или изменения внутри vDC становятся невозможными, работа ВМ не останавливается.<br/>**resume** — Разморозка vDC. Восстановление возможности управления сущностями внутри vDC.<br/><br/>---<br/><br/>## 2. Параметры развертывания<br/><br/>Ниже перечислены входные параметры операции **create**.<br/><br/>### UUID Организации<br/>Уникальный идентификатор организации в Cloud Director. Перед созданием vDC требуется предварительное создание услугу `Организация в Cloud Director`.<br/><br/>### Provider VDC в Cloud Director<br/>Свойство ресурсной платформы, определяющее, какой пул физических ресурсов будет использоваться.<br/><br/>### Network Pool в Cloud Director<br/>Определяет возможности сетевой конфигурации, включая создание Edge Gateway и выход во внешние сети.<br/><br/>### Гарантированная доля ЯДЕР<br/>Гарантированный процент вычислительных ресурсов (CPU), закрепленный за vDC. Значение устанавливается разово при создании.<br/><br/>### Гарантированная доля ОЗУ<br/>Гарантированный процент оперативной памяти, закрепленный за vDC. Также задаётся один раз при создании.<br/><br/>### Сколько аллоцировать на VDC ЯДЕР<br/>Количество виртуальных ядер, выделяемых в рамках vDC.<br/><br/>### Сколько аллоцировать на VDC ОЗУ<br/>Количество оперативной памяти в GB, выделяемой для vDC.<br/><br/>### Конфигурация Storage<br/>Набор дисковых политик и их объёмов, выделяемых для vDC. Указывается имя политики и требуемый размер (GB).<br/><br/>---<br/><br/>## 3. Рекомендованные характеристики<br/><br/>### Тестовое окружение<br/><br/>- Количество ядер CPU: 10–20<br/>- Аллоцируемая RAM: 16–64 GB<br/>- Гарантированная доля CPU: 20%<br/>- Гарантированная доля RAM: 20%<br/>- Storage:<br/>- Политика `SATA`<br/>- Объём: 100–300 GB<br/><br/>### Промышленное окружение<br/><br/>- Количество ядер CPU: 16–128<br/>- Аллоцируемая RAM: 64–512 GB<br/>- Гарантированная доля CPU: 50%<br/>- Гарантированная доля RAM: 50%<br/>- Storage:<br/>- Политики уровня `SSD`<br/>- Объём: 1–10 TB, выбор несколько политик под разные нагрузки<br/><br/>---<br/><br/>## 4. Выходные параметры<br/><br/>Выходные параметры формируются операцией **create** (и используются другими операциями):<br/><br/>### Имя vDC<br/>Уникальный идентификатор созданного виртуального датацентра. Используется в дальнейших операциях (modify, suspend, delete).<br/><br/>### Параметры выделенных ресурсов<br/>Подтверждение итогового объёма CPU/RAM/Storage, выделенных vDC. Используются для учёта и контроля потребления.<br/><br/>---<br/><br/>## 5. Дополнительная информация<br/><br/>- Перед созданием vDC необходимо обеспечить наличие корректно созданной организации и доступных пула ресурсов ресурсной платформы.<br/>- Гарантированная доля CPU и RAM задаётся **однократно при создании vDC**. После развертывания изменить эти значения невозможно; для изменения необходимо пересоздать vDC.<br/>- Удаление vDC возможно только через **14 дней после перевода в состояние *suspend***. Удаление очищает все связанные сущности (ВМ, сети, каталоги), поэтому необходимо убедиться, что данные перенесены.<br/>- Платформа Cloud Director использует концепцию изолированных организационных ресурсов, поэтому корректная настройка Provider VDC и Network Pool является обязательной при создании vDC.<br/>- При изменении параметров (modify) изменяются только показатели CPU, RAM и Storage. Сетевые параметры и гарантированные доли остаются неизменными.<br/>'
|
||
lifecycle:
|
||
suspend_on_destroy_default: true
|
||
adopt_existing_on_create_default: false
|
||
outputs:
|
||
params:
|
||
- code: state_params
|
||
type: map
|
||
- code: state_out
|
||
type: map
|
||
- code: state_params_flat
|
||
type: map
|
||
- code: state_out_flat
|
||
type: map
|
||
- code: vault_secrets
|
||
type: map
|
||
sensitive: true
|
||
- code: vault_url
|
||
type: string
|
||
- code: vault_user_path
|
||
type: string
|
||
- code: vault_fields
|
||
type: list
|
||
operations:
|
||
- name: create
|
||
id: 9
|
||
kind: instance
|
||
action: create
|
||
params:
|
||
- id: 30
|
||
code: organizationUid
|
||
data_type: uuid
|
||
required: true
|
||
ref_svc_id: 19
|
||
man: Для создания VDC предварительно необходимо создать организацию через услугу `Организация в Cloud Director`
|
||
sort: 10
|
||
- id: 335
|
||
code: providerVdc
|
||
data_type: string
|
||
required: true
|
||
man: Приписка `2.8` - Скорость vCPU - 2800MHz<br/>И так далее...<br/>
|
||
sort: 30
|
||
depends_on: organizationUid,networkProvider
|
||
- id: 361
|
||
code: storageConfig
|
||
data_type: array-map-fixed
|
||
required: true
|
||
default: '[{}]'
|
||
man: Первая политика в списке указывается как "По умолчанию"
|
||
sort: 100
|
||
is_modifiable: true
|
||
sub_params:
|
||
- id: 41
|
||
code: name
|
||
data_type: string
|
||
required: true
|
||
default: ""
|
||
descr: getKeyListFromStruct(getResourceRealmConfig(getStringFromStruct(getInstanceState(params.organizationUid), "params.resourceRealm")), concat("vcd.hardware.providerVdcs['",params.providerVdc,"'].storage"))
|
||
is_modifiable: false
|
||
- id: 42
|
||
code: size
|
||
data_type: integer > 0
|
||
required: true
|
||
default: "2000"
|
||
is_modifiable: false
|
||
- id: 397
|
||
code: cpuGuaranteed
|
||
data_type: integer > 0
|
||
required: true
|
||
default: "20"
|
||
value_list:
|
||
- "20"
|
||
- "50"
|
||
- "80"
|
||
descr: '% резервирования'
|
||
man: Свойство нельзя изменить после создания
|
||
sort: 60
|
||
- id: 557
|
||
code: cpuAllocated
|
||
data_type: integer > 0
|
||
required: true
|
||
default: "80"
|
||
maxvalue: 1000
|
||
minvalue: 1
|
||
descr: шт
|
||
sort: 80
|
||
is_modifiable: true
|
||
- id: 558
|
||
code: memAllocated
|
||
data_type: integer > 0
|
||
required: true
|
||
default: "200"
|
||
maxvalue: 4096
|
||
minvalue: 1
|
||
descr: gb
|
||
sort: 90
|
||
is_modifiable: true
|
||
- id: 746
|
||
code: networkProvider
|
||
data_type: string
|
||
required: true
|
||
sort: 20
|
||
depends_on: organizationUid
|
||
- name: delete
|
||
id: 24
|
||
kind: instance
|
||
action: delete
|
||
man: 'Удалить возможно только через 14 дней после выполнения операции `suspend`<br/>**ОСТОРЖНО: Удаление приводит к полному удалению всех сущностей внутри этого VDC**<br/><br/>Если существуют инстансы Edge, vApp, Vm или Kubernetes-кластер Штурвал, которые были созданы, из ЛК удалены не будут. Необходимо обратиться к `технической поддержке` для удаления инстансов'
|
||
params: []
|
||
- name: modify
|
||
id: 112
|
||
kind: instance
|
||
action: modify
|
||
params:
|
||
- id: 560
|
||
code: cpuAllocated
|
||
data_type: integer > 0
|
||
required: true
|
||
maxvalue: 999
|
||
minvalue: 1
|
||
descr: шт
|
||
sort: 10
|
||
- id: 561
|
||
code: memAllocated
|
||
data_type: integer > 0
|
||
required: true
|
||
maxvalue: 1024
|
||
minvalue: 1
|
||
descr: gb
|
||
sort: 20
|
||
- id: 562
|
||
code: storageConfig
|
||
data_type: array-map-fixed
|
||
required: true
|
||
man: Первая политика в списке указывается как "По умолчанию"
|
||
sort: 30
|
||
sub_params:
|
||
- id: 43
|
||
code: name
|
||
data_type: string
|
||
required: true
|
||
default: ""
|
||
is_modifiable: false
|
||
- id: 44
|
||
code: size
|
||
data_type: integer > 0
|
||
required: true
|
||
default: ""
|
||
is_modifiable: false
|
||
- name: reconcile
|
||
id: 250
|
||
kind: action
|
||
action: reconcile
|
||
params: []
|
||
- name: resume
|
||
id: 172
|
||
kind: instance
|
||
action: resume
|
||
params: []
|
||
- name: suspend
|
||
id: 171
|
||
kind: instance
|
||
action: suspend
|
||
man: Операция **не останавливает ВМки** в облаке, но не даёт редактировать все сущности внутри VDC
|
||
params: []
|