Requirements

To ensure proper operation of Deckhouse with the zVirt cloud, the following are required:

  • A working zVirt installation with accessible API.
  • A user account with permissions to access the API and manage virtual machines.
  • A storage domain with an uploaded cloud OS image.
  • A prepared virtual machine template based on the cloud image.

The zVirt cloud provider is in experimental status. API and behavior may change in future versions.

The provider supports working with only one disk in the virtual machine template. Make sure the template contains only one disk.

Preparing a cloud image

  1. Go to zVirt → Storage → Disks.

  2. Upload a cloud OS image (for example, .qcow2 or .img) to the storage.

    Start of uploading the cloud OS image into the repository

    Process of uploading a cloud OS image into the repository

  3. Wait for the upload to complete. The disk status should display OK.

    Finishing the upload of the cloud OS image into the repository

Preparing a virtual machine template

  1. Open Resources → Virtual Machines and create a new VM.

  2. Set the following parameters:
    • Template: Blank.
    • Operating system: Matches the uploaded cloud image.
    • Workload profile: High performance.
    • Disks: Attach the uploaded cloud image and set it as bootable.

    Setting general VM parameters

  3. Do not add any network interfaces. They will be created automatically when Deckhouse provisions a node.

    Skipping network interface setting

  4. Save and create the virtual machine.

  5. After the VM is created, open its details and create a template based on it.

    Creating a template based on a VM

  6. Specify the template name and enable the Seal Template option.

    Template parameters

  7. Ensure the template has been successfully created in Resources → Templates.

    Checking the created template