Deckhouse Platform on VMware Cloud Director

1
Selecting infrastructure
2
Installation information
3
Preparing environment
4
Installation
5
Getting access to the cluster
6
What can I do next?
Preparing environment

Installation of Deckhouse Platform on VMware Cloud Director is only possible in the Enterprise Edition. See information about commercial editions.

Before installation, ensure the following:

  • Cloud provider quotas for cluster deployment.
  • The cloud-init package is installed on the VMs. After the VM starts, services cloud-config.service, cloud-final.service, cloud-init.service must be running.
  • The virtual machine template contains only one disk.
  • In VMware Cloud Director, vApp/Guest OS Customization is disabled for the cluster template and VMs.

Additional requirements and notes

  • For ContainerdV2 on cluster nodes, the OS on virtual machines must meet the requirements:
    • Linux kernel version 5.8 or newer, except for the ranges 6.12.0–6.12.28 or 6.14.0–6.14.6 (these versions are affected by CVE-2025-37999 in EROFS);
    • CgroupsV2 support;
    • Systemd version 244 or newer;
    • erofs kernel module support.

    For more information, see the ClusterConfiguration resource.

  • From version 1.74, Deckhouse Platform has a module integrity control mechanism (protection against replacement and modification). It turns on automatically when the OS on the nodes supports the erofs kernel module. Without it, Deckhouse Platform runs as before but the mechanism is off — an alert will indicate it is unavailable.

Prepare the VMware Cloud Director environment so that Deckhouse Platform can manage cloud resources. The full procedure is described on the environment preparation page of the cloud-provider-vcd module.

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

Perform the following preliminary steps:

  1. Get a tenant with the resources listed in List of required VCD resources. The virtual data center must have an Edge Gateway. The internal network of the cluster is created automatically in the WithNAT layout used on this page.
  2. Get a user with the required permissions.
  3. Prepare a virtual machine template.
Go back Next: Installation