The module lifecycle stage: General Availability

Only the Standard layout is supported. The layout is set with the layout parameter in the ModuleConfig resource of the module.

Standard

In the Standard layout, all cluster nodes are created in a single zVirt cluster set with the clusterID parameter. Virtual machines are cloned from a prepared template, and their network interface is created from a vNIC profile.

Standard layout in zVirt

Example of the layout configuration with one master node:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: cloud-provider-zvirt
spec:
  version: 2
  enabled: true
  settings:
    provider:
      parameters:
        server: <ZVIRT_API_URL>
        clusterID: <CLUSTER_ID>
    nodes:
      parameters:
        layout: Standard
        sshPublicKey: <SSH_PUBLIC_KEY>
---
apiVersion: v1
kind: Secret
metadata:
  name: d8-credentials
  namespace: d8-cloud-provider-zvirt
type: cloud-provider.deckhouse.io/credentials
stringData:
  authScheme: userPassword
  identity: <USERNAME>
  secret: <PASSWORD>
---
apiVersion: deckhouse.io/v1
kind: ZvirtInstanceClass
metadata:
  name: master
spec:
  numCPUs: 4
  memory: 8192
  rootDiskSizeGb: 50
  etcdDiskSizeGb: 10
  template: <TEMPLATE_NAME>
  vnicProfileID: <VNIC_PROFILE_ID>
  storageDomainID: <STORAGE_DOMAIN_ID>
---
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
  name: master
spec:
  nodeType: CloudPermanent
  cloudInstances:
    classReference:
      kind: ZvirtInstanceClass
      name: master
    minPerZone: 1
    maxPerZone: 1

Where:

  • ZVIRT_API_URL: URL of the zVirt API endpoint, for example, https://zvirt.example.com/ovirt-engine/api.
  • CLUSTER_ID: ID of the zVirt cluster to create virtual machines in.
  • SSH_PUBLIC_KEY: Public SSH key for accessing the nodes.
  • USERNAME and PASSWORD: zVirt user login and password for the Secret whose format is covered in the “Credentials Secret” section.
  • TEMPLATE_NAME: Name of the virtual machine template prepared as described in the “Prepare a virtual machine template” section.
  • VNIC_PROFILE_ID: ID of the vNIC profile that you can get as described in the “How to get the vNIC profile ID?” section.
  • STORAGE_DOMAIN_ID: ID of the zVirt storage domain to create the etcd disk in.

The number of master nodes is set with the minPerZone parameter of the master node group. In the ZvirtInstanceClass resource of the master group, set the etcdDiskSizeGb and storageDomainID parameters, which set the size and the storage domain of a separate disk for etcd. The etcdDiskSizeGb parameter cannot be set in the instance classes of other CloudPermanent groups.