oVirt CSI module (shturval-capov-csi)

About the service

ParameterDescription
GUI nameoVirt CSI module
System name (identifier)shturval-capov-csi
Cluster AssignmentDynamic provisioning of volumes in oVirt; connecting oVirt disks as PersistentVolume upon request.
CriticalNo
Public repositoryoVirt CSI driver
Dependenciesshturval-networking
Namespaceshturval-capov-csi

Purpose

shturval-capov-csi - oVirt CSI module. Allows you to connect disks from oVirt as PersistentVolume upon request via StorageClass when using oVirt-based clusters.

Where to configure

Services and repositories → Installed services → shturval-capov-csi → Manage.

Setting up storage classes: StorageClasses. For clusters on oVirt, after installing the shturval-capov provider, when creating a cluster with CSI integration, the module can be installed automatically.

Installing a chart in a cluster

If CSI integration was enabled when creating a cluster with the oVirt provider, the module is installed automatically. To manually install, go to Services and Repositories → Available Charts, find the shturval-capov-csi chart and click Install.

In the Service Specification block, specify the parameters for access to oVirt Engine and the storage domain:

  • ovirtCredentials — oVirt Engine URL, login, password, CA bundle (base64), flag to disable SSL verification;
  • storageClass.parameters.storageDomainName — the name of the Storage Domain in oVirt for creating disks.
Customvalues example
ovirtCredentials:
  ovirtUrl: "https://rhv-mg.example.com/ovirt-engine"
  ovirtUsername: "admin@internal"
  ovirtPassword: "<password>"
  ovirtCaBundle: "<CA certificate in base64>"
  ovirtInsecure: "false"
storageClass:
  parameters:
    storageDomainName: "VM_Store"
ParameterDescriptionTypeExample
ovirtUrloVirt Engine URLstringhttps://rhv-mg.example.com/ovirt-engine
ovirtUsernameoVirt Engine username (with domain)stringadmin@internal
ovirtPasswordoVirt Engine user passwordstringPassword
ovirtCaBundleCA bundle for oVirt Engine certificate verification, encoded in base64stringLS0tLS1CRUdJTi…
ovirtInsecureDisable oVirt Engine SSL certificate verification. Specify the value in quotes in customvaluesboolean"false"
storageDomainNameStorage Domain name in oVirt where disks will be createdstringVM_Store

For the module to work, shturval-networking must be enabled in the cluster. If you need to redefine chart parameters, apply the changes via ShturvalServicePatch.

After installation, StorageClass ovirt-csi will be added to the cluster. To use it by default, remove the storageclass.kubernetes.io/is-default-class: "true" annotation from the StorageClass local-path (Storage → StorageClasses → local-path → Labels and Annotations).

Using oVirt CSI in a cluster with the Shturval v2 provider

Using oVirt CSI in a cluster with the Shturval v2 provider is only possible with hosts deployed on the oVirt (RHV) virtualization platform.

Installation when creating a cluster

If the module is installed when creating a cluster with the Shturval v2 provider, specify the customvalues from the section above.

Installation in a deployed cluster

If the cluster is already deployed with the Shturval v2 provider on oVirt hosts:

  1. If you have an old oVirt CSI installation, remove it.
  2. Install the module in the namespace shturval-capov-csi with customvalues from the section above.

After installation, the StorageClass is created as default. If necessary, remove the default flag from one of the StorageClass (local-path or ovirt-csi).


How to deploy this service - How to deploy a new service.