vCloud Director Provider (shturval-capvcd)

About the service

ParameterDescription
GUI namevCloud Director Provider
System name (identifier)shturval-capvcd
Cluster AssignmentIntegration with VMware vCloud Director: deployment of virtual machines for cluster nodes via the Cluster API. Installed in the management cluster.
CriticalNo
Public repositoryVMware vCloud Director
Dependenciesshturval-capvcd-crds, shturval-capi-crds
Namespacecapvcd-system

Purpose

shturval-capvcd is the vCloud Director provider for the Cluster API. Enables the creation and management of virtual machines in VMware vCloud Director for use as nodes in Kubernetes clusters.

Installing the service

shturval-capvcd - infrastructure provider Cluster API for VMware vCloud Director. In the Shturval platform, the connection and life cycle of such a provider in the management cluster is ensured by cluster-manager; ShturvalServiceConfig (SSC) objects for provider charts are created and maintained as part of the platform configuration, rather than as an arbitrary manual installation of a service chart.

In the production environment, the provider is represented by two SSCs:

  • shturval-capvcd — main chart of the vCloud Director provider;
  • shturval-capvcd-crds — CRD chart of the vCloud Director provider module.

For correct operation, the CRD of the main Cluster API (shturval-capi-crds and the associated component shturval-capi) must be available in the management cluster.

If the service was disabled during platform deployment, the provider’s SSCs could receive an absence mode (mode: absent). To ensure that the provider is available to work with virtualization, first switch the mode shturval-capvcd-crds to auto, then shturval-capvcd to auto. You can change the mode in the platform GUI on the Providers page.

In the GUI, this action is performed by the service mode switch. The screenshot shows the selection of the Auto mode for the provider service.

Switching provider service mode

Customvalues parameters

The structure of the main chart values is described by the spec.customvalues field of the corresponding ShturvalServiceConfig and coincides with the helm/main/values.yaml of the shturval-capvcd chart.

Recommendation: do not edit the ShturvalServiceConfig object manually to change limits, nodeSelector, connection parameters to vCloud Director and other release settings - such an object belongs to the platform configuration and can be overwritten during updates. Make all changes to the behavior of the service through ShturvalServicePatch (SSP), which overlays spec.customvalues on top of the base SSC.

Where to configure

Services and repositories → Installed services → shturval-capvcd → Manage. The service is hosted in the management cluster.

Configuring provider instances in the platform - VMware vCloud Director. General overview - How work with providers in the platform works.

Reference: For vCloud Director infrastructure CRs, see Custom Node Lifecycle Resources - VMware vCloud Director.