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.
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.USERNAMEandPASSWORD: 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.