KVM / Libvirt StartVm

KVM / Libvirt StartVm

Certified

Start a KVM domain

Boots a libvirt domain if it isn't already running. Can optionally wait until the domain reaches RUNNING state using exponential retry up to timeToWait (default PT60S). Requires access to the target libvirt URI.

yaml
type: io.kestra.plugin.kvm.StartVm
yaml
id: kvm_lifecycle_ssh
namespace: kvmtest.ssh

tasks:
  - id: start_vm
    type: io.kestra.plugin.kvm.StartVm
    uri: qemu+ssh://root@167.99.104.163/system
    name: "kestra-worker-nodes"
    waitForRunning: true
Properties

Domain name

Name of the libvirt domain to start.

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

DefaultPT1M

Max wait duration

Maximum time to wait for RUNNING when waitForRunning is true. Default PT60S.

Libvirt URI

Defaultfalse

Wait for RUNNING

If true, polls domain state until RUNNING or timeout. Default false.

VM Name

Started domain name.

VM State

Libvirt domain state after the start attempt.