Using Terraform on macOS to manage KVM-backed VMs

Installing

Terraform

brew install terraform

Installing libvirt provider

brew install cdrtools

Setup Remote Host

# fedora / rhel / alma
sudo dnf update -y
sudo dnf install qemu-kvm qemu-img libvirt virt-manager virt-install virt-viewer libvirt-client
sudo systemctl enable --now libvirtd
sudo usermod -aG libvirt $(whoami)
sudo usermod -aG kvm $(whoami)

Testing libvirt provider

cloud-init.yml

#cloud-config
users:
  - name: pythoninthegrass
    group: users
    sudo: ALL=(ALL) NOPASSWD:ALL
    ssh_authorized_key:
      - SSH_KEY

main.tf

terraform {
  required_providers {
    libvirt = {
      source  = "dmacvicar/libvirt"
      version = "0.8.1"
    }
  }
}

provider "libvirt" {
  uri = "qemu+ssh://username@SERVER_IP:PORT/system?socket=/var/run/libvirt/libvirt-sock"
}

# Use an ubuntu release image from upstream
resource "libvirt_volume" "ubuntu-qcow2" {
  name = "ubuntu-qcow2"
  pool = "guest_images_hddvg"
  source = "https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64-disk-kvm.img"
  format = "qcow2"
}

# Create a network for our VMs
resource "libvirt_network" "vm_network" {
  name = "vm_network"
  addresses = ["10.0.1.0/24"]
}
 
# Use CloudInit to add our ssh-key to the instance
resource "libvirt_cloudinit_disk" "commoninit" {
  name = "commoninit.iso"
  user_data = "${data.template_file.user_data.rendered}"
}

data "template_file" "user_data" {
  template = "${file("${path.module}/cloud-init.yml")}"
}

# Create the machine
resource "libvirt_domain" "domain-ubuntu" {
  name = "ubuntu-tf"
  memory = "1024"
  vcpu = 2

  cloudinit = "${libvirt_cloudinit_disk.commoninit.id}"

  network_interface {
    hostname = "master"
    network_name = "vm_network"
  }

  # IMPORTANT
  # Ubuntu can hang is a isa-serial is not present at boot time.
  # If you find your CPU 100% and never is available this is why
  console {
    type        = "pty"
    target_port = "0"
    target_type = "serial"
  }

  console {
    type        = "pty"
    target_type = "virtio"
    target_port = "1"
  }

  disk {
    volume_id = "${libvirt_volume.ubuntu-qcow2.id}"
  }
  graphics {
    type = "spice"
    listen_type = "address"
    autoport = "true"
  }
}

# Print the Boxes IP
# Note: you can use `virsh domifaddr <vm_name> <interface>` to get the ip later
output "ip" {
  value = "${libvirt_domain.domain-ubuntu.network_interface.0.addresses.0}"
}

terraform init
terraform plan -out=tfplan
terraform apply tfplan
terraform destroy

pythoninthegrass/macos_terraform.md

Using Terraform on macOS to manage KVM-backed VMs

Installing

Terraform

Installing libvirt provider

Setup Remote Host

Testing libvirt provider

Links