Struct Libvirt 

pub struct Libvirt {
    pub hypervisor_host: String,
    pub hypervisor_user: String,
    pub hypervisor_key: Option<String>,
    pub vcpus: u32,
    pub memory_mib: u32,
    pub disk_gib: u32,
    pub image_url: String,
    pub network: NetworkMode,
    pub storage_dir: String,
    pub vm_ssh_key: String,
    pub os_variant: String,
}

Libvirt/KVM provisioner for local or remote hypervisors.

Manages virtual machines via virsh and virt-install over SSH. Cloud images are provisioned with cloud-init (NoCloud datasource).

Fields

hypervisor_host: String

SSH hostname or IP of the hypervisor.

hypervisor_user: String

SSH user on the hypervisor (default: root).

hypervisor_key: Option<String>

Optional SSH private key for the hypervisor connection.

vcpus: u32

Number of vCPUs (default: 2).

memory_mib: u32

RAM in MiB (default: 2048).

disk_gib: u32

Disk size in GiB (default: 20).

image_url: String

Cloud image URL to download on the hypervisor.

network: NetworkMode

Network mode (default: NAT).

storage_dir: String

Directory on the hypervisor for VM disk images.

vm_ssh_key: String

Local SSH private key whose .pub sibling is injected via cloud-init. Used to SSH into the VM after creation.

os_variant: String

os-variant passed to virt-install.

Implementations

impl Libvirt

pub fn new(hypervisor_host: &str, vm_ssh_key: &str) -> Self

Create a new Libvirt provisioner.

Arguments

• hypervisor_host - SSH-reachable hostname of the KVM host
• vm_ssh_key - path to the local SSH private key; the matching .pub file is read and injected into the VM via cloud-init

pub fn hypervisor_user(self, user: &str) -> Self

pub fn hypervisor_key(self, key: &str) -> Self

pub const fn vcpus(self, n: u32) -> Self

pub const fn memory_mib(self, mib: u32) -> Self

pub const fn disk_gib(self, gib: u32) -> Self

pub fn image_url(self, url: &str) -> Self

pub fn network(self, mode: NetworkMode) -> Self

pub fn storage_dir(self, dir: &str) -> Self

pub fn os_variant(self, variant: &str) -> Self

Trait Implementations

impl Provisioner for Libvirt

fn check_prerequisites(&self) -> DeployResult<()>

Check that all prerequisites are installed and authenticated.

fn detect_ssh_keys(&self) -> DeployResult<Vec<(String, String)>>

Detect SSH keys to use for provisioning.

fn create_server( &self, name: &str, _region: &str, _ssh_key_ids: &[String], ) -> DeployResult<ServerInfo>

Create a new server and return its info.

fn setup_server( &self, server: &ServerInfo, domain: Option<&str>, ) -> DeployResult<()>

Install Docker, configure firewall, start Caddy placeholder.

fn get_server(&self, name: &str) -> DeployResult<Option<ServerInfo>>

Get an existing server by name.

fn destroy_server(&self, name: &str) -> DeployResult<()>

Destroy a server by name.