List of required VCD resources

Список необходимых ресурсов VCD

Organization, VirtualDataCenter, StoragePolicy, SizingPolicy, EdgeRouter, and Catalog must be provided by your VMware Cloud Director service provider. Also, in the tenant, you will need to grant the following rights to able to modify the VM parameters (refer to the instruction):

Organization, VirtualDataCenter, StoragePolicy, SizingPolicy, EdgeRouter и Catalog должны быть предоставлены вашим поставщиком услуг VMware Cloud Director. Также в тенанте нужно выдать следующие права на изменение параметров ВМ (используйте инструкцию):

Network (internal network) can be configured by your VMware Cloud Director service provider, or you can configure it yourself. Next, we consider setting up the internal network yourself.

Network (внутренняя сеть) может быть настроена вашим поставщиком услуг VMware Cloud Director, либо вы можете настроить ее самостоятельно. Далее рассматривается настройка внутренней сети самостоятельно.

Adding a network

Добавление сети

Go to the Networking tab and click on the NEW button:

Перейдите во вкладку Networking и нажмите на кнопку NEW:

Select the Data Center:

Выберите необходимый Data Center:

Note that Network type must be Routed:

Network type должен быть Routed:

Connect the EdgeRouter to the network:

Присоедините EdgeRouter к сети:

Set the network name and CIDR:

Установите имя сети и CIDR:

Do not add Static IP Pools, because DHCP will be used:

Не добавляйте Static IP Pools, т.к. будет использоваться DHCP:

Specify the DNS server addresses:

Укажите адреса DNS-серверов:

Configuring DHCP

Настройка DHCP

To provision nodes dynamically, you have to enable the DHCP server for the internal network.

Для динамического заказа узлов необходимо включить DHCP-сервер для внутренней сети.

We recommend allocating the beginning of the network address range to system consumers (control plane, frontend nodes, system nodes) and the rest to the DHCP pool. For example, for a /24 mask network it would be enough to allocate 20 addresses to system consumers.

Рекомендуем выделить начало диапазона адресов сети на системные нагрузки (control plane, frontend-узлы, системные узлы), а остальное выделить на DHCP-пул. Например, для сети по маске /24 будет достаточно выделения 20 адресов под системные нагрузки.

Click the Networking tab and open the network you created:

Перейдите во вкладку Networking и откройте созданную сеть:

In the window that opens, select the IP Management -> DHCP -> Activate tab:

В открытом окне откройте вкладку IP Management -> DHCP -> Activate:

In the General settings tab, set the parameters as shown in the example:

Во вкладке General settings настройте параметры аналогично примеру:

Next, add a pool:

Добавьте пул:

Set the DNS server addresses:

Установите адреса DNS-серверов:

Adding a vApp

Добавление vApp

Switch to the Data Centers -> vApps -> NEW -> New vApp tab:

Перейдите во вкладку Data Centers -> vApps -> NEW -> New vApp:

Set a name and enable the vApp:

Установите имя и включите vApp:

Adding a network to the vApp

Добавление сети к vApp

Once the vApp is created, you have to connect the created internal network to it.

После создания vApp, необходимо присоединить к ней созданную внутреннюю сеть.

Switch to the Data Centers -> vApps tab and open the target vApp:

Перейдите во вкладку Data Centers -> vApps, откройте необходимый vApp:

Go to the Networks tab and click on the NEW button:

Перейдите во вкладку Networks и нажмите на кнопку NEW:

In the window that opens, click the Direct type and select the network:

В появившемся окне выберите тип Direct и выберите сеть:

Incoming traffic

Входящий трафик

Incoming traffic should be routed to the edge router (ports 80, 443) using DNAT rules to be forwarded to a dedicated address on the internal network.
This address can be created by running MetalLB in L2 mode for dedicated frontend nodes.

Входящий трафик необходимо направить на edge router (порты 80, 443) при помощи правил DNAT на выделенный адрес во внутренней сети. Этот адрес поднимается при помощи MetalLB в L2 режиме на выделенных frontend-узлах.

Configuring DNAT rules on the edge gateway

Настройка правила DNAT на edge gateway

Navigate to the Networking -> Edge Gateways tab, open the edge gateway:

Перейдите во вкладку Networking -> Edge Gateways, откройте edge gateway:

Switch to the Services -> NAT tab:

Перейдите во вкладку Services -> NAT:

Add the following rules:

Добавьте следующие правила:

The first two rules are used for incoming traffic, while the third rule is used for SSH access to the control plane host (without this rule the installation will not be possible).

Первые два правила используются для входящего трафика, а третье — для доступа по SSH к узлу с control plane (без этого правила установка будет невозможна).

Configuring a firewall

Настройка firewall

Once DNAT is configured, you have to set up the firewall. First, configure the IP sets.

После настройки DNAT необходимо настроить firewall. Сначала необходимо настроить наборы IP-адресов (IP sets).

Switch to the Security -> IP Sets tab:

Перейдите во вкладку Security -> IP Sets:

Create the following set of IPs (the MetalLB address here is .10 and the control plane node address is .2):

Создайте следующий набор IP (тут подразумевается, что адрес MetalLB будет .10 а адрес узла с control plane — .2):

Add the following firewall rules:

Добавьте следующие правила firewall:

Virtual machine template

Шаблон виртуальной машины

The provider is confirmed to work with Ubuntu 22.04-based virtual machine templates only.

Работоспособность провайдера подтверждена только для шаблонов виртуальных машин на базе Ubuntu 22.04.

The example below uses the OVA file provided by Ubuntu, updated to include two fixes. Those fixes are essential for CloudPermanent nodes to be provisioned correctly and to be able to mount CSI-created disks.

В примере используется OVA-файл, предоставляемый Ubuntu, с двумя исправлениями. Исправления необходимы для корректного заказа CloudPermanent-узлов и для возможности подключать диски, созданные CSI.

Making a template from an OVA file

Подготовка шаблона из OVA-файла

Download the OVA file:

Скачайте OVA-файл:

Switch to the Libraries -> Catalogs -> Organization Catalog tab:

Перейдите на вкладку Libraries -> Catalogs -> Каталог организации:

Select the template you downloaded and add it to the catalog:

Выберите скаченный шаблон и загрузите его в каталог:

Create a virtual machine from the template:

Создайте виртуальную машину из шаблона:

Enter the default password and public key. You will need them to log in to the VM console.

Укажите пароль по умолчанию и публичный ключ. Это необходимо для того, чтобы войти в консоль виртуальной машины.

Follow these steps to be able to connect to the virtual machine:

1. Start the virtual machine
2. Wait for the IP address to be set
3. Forward port 22 to the virtual machine:

Для того чтобы получить возможность подключения к виртуальной машине, выполните следующие шаги:

1. Запустите виртуальную машину
2. Дождитесь получение IP-адреса
3. Пробросьте порт 22 до виртуальной машины:

Log on to the virtual machine over SSH and run the following commands:

Войдите на виртуальную машину по SSH и выполните следующие команды:

Shut down the virtual machine and create a virtual machine template:

Выключите виртуальную машину и создайте шаблон виртуальной машины:

After creating a virtual machine template, ask your VMware Cloud Director service provider to enable the disk.enableUUID parameter for the template.

После создания шаблона виртуальной машины, обратитесь к поставщику услуг VMware Cloud Director с просьбой включить для шаблона параметр disk.enableUUID.

Using the storage

Использование хранилища

• VCD supports CSI; disks are created as VCD Independent Disks.
• The disk.EnableUUID guest property must be set for the virtual machine templates in use.
• Deckhouse Kubernetes Platform supports disk resizing as of v1.59.1.

• VCD поддерживает CSI, диски создаются как VCD Independent Disks.
• Guest property disk.EnableUUID должно быть разрешено для используемых шаблонов виртуальных машин.
• Deckhouse Kubernetes Platform поддерживает изменение размера дисков с версии v1.59.1.