KVM / Libvirt CreateVm

KVM / Libvirt CreateVm

Certified

Create or update KVM domain

Defines a libvirt domain from rendered XML, creating it if it doesn't exist and keeping configuration in sync. Can optionally boot the VM when startAfterCreate is true (default false); requires access to the target libvirt URI.

yaml
type: io.kestra.plugin.kvm.CreateVm
yaml
id: crea_kvm_vm_ssh
namespace: kvmtest.ssh

tasks:
  - id: create_vm
    type: io.kestra.plugin.kvm.CreateVm

    # Replace with your Droplet IP.
    # ?no_verify=1 skips the 'known_hosts' check for the first run.
    uri: qemu+ssh://root@167.99.104.163/system

    # This is the standard Libvirt XML format
    xmlDefinition: |
      <domain type='kvm'>
        <name>kestra-worker-nodes</name>
        <memory unit='MiB'>512</memory>
        <vcpu placement='static'>1</vcpu>
        <os>
          <type arch='x86_64' machine='pc-q35-6.2'>hvm</type>
          <boot dev='hd'/>
        </os>
        <devices>
          <disk type='volume' device='disk'>
            <driver name='qemu' type='qcow2'/>
              <source pool='default' volume='kestra-worker-nodes-os.qcow2'/>
                <target dev='vda' bus='virtio'/>
          </disk>

          <disk type='volume' device='disk'>
            <driver name='qemu' type='qcow2'/>
              <source pool='default' volume='kestra-worker-nodes-data.qcow2'/>
              <target dev='vdb' bus='virtio'/>
          </disk>
        </devices>
      </domain>

    # If true, it attempts to boot the VM immediately after defining it
    startAfterCreate: true

  - id: log_result
    type: io.kestra.plugin.core.log.Log
    message: |
      VM Created!
      Name: {{outputs.create_vm.name}}
      UUID: {{ outputs.create_vm.uuid }}
      State: {{ outputs.create_vm.state }}
Properties

Domain name

VM name used for lookup and definition; should match the element in the XML.

Domain XML

Full libvirt domain XML template rendered with flow variables before being sent to defineXML.

Reference (ref) of the pluginDefaults to apply to this task.

Defaultfalse

Start after define

If true, boots the VM after definition when it isn't already running. Default false.

Libvirt URI

VM Name

Defined domain name.

VM State

Libvirt domain state after definition and optional start.

VM UUID

Persistent libvirt UUID of the domain.

More Plugins in this Category

NetBox (EE)
NetBox
Enterprise

Enterprise NetBox tasks to create, update, and query devices, IP addresses, and sites over the NetBox API.

Infrastructure

7 tasks

4 blueprints

AS400
AS400

Tasks that connect to AS400 via JDBC to run queries and loads.

DataInfrastructure

3 tasks