Skip to content

README.md

Latest commit

 

History

History
93 lines (79 loc) · 5.41 KB

README.md

File metadata and controls

93 lines (79 loc) · 5.41 KB

Terraform Module: terraform-libvirt-instance

Description

This Terraform module provisions virtual instances with customizable configurations.

Variables

Variable Name Description Required Default Value
instance_count Number of instances to create ❌ 1
instance_cloud_image Cloud image to use for instance provisioning ❌
instance_autostart Flag to set instance autostart ❌ true
instance_iso_image ISO to use for instance provisioning ❌
instance_additional_volume_size Additional block device size ❌ 0
instance_cloudinit_path Cloud-init config to use for instance provisioning ❌ ./cloud_init.cfg
instance_type Instance type, Windows/Linux ❌ linux
instance_hostname Hostname to assign the instance via cloud-init ❌ libvirt-vm
instance_domain Hostname to assign the instance via cloud-init ❌ example.com
instance_cpu Number of CPUs to configure for the instance ❌ 2
instance_memory Instance memory size, in GB ❌ 4
instance_volume_size Main volume size, in GB ❌ 20
instance_cloud_user Cloud user credentials ❌ See default in table
instance_libvirt_pool The libvirt pool to attach the instance to ❌ default
instance_uefi_enabled Set this to true if OS should be installed via ISO ❌ true
instance_network_interfaces A list of network interfaces to add to the instance ❌ [] (empty list)

instance_cloud_user Variable Details:

Sub-Variable Description Required Default Value
username Username for the instance ❌ sysadmin
password Password for the instance ❌ redhat
sshkey SSH key for the instance ❌ "" (empty)

instance_network_interfaces Variable Details:

Sub-Variable Description Required Default Value
interface_network Name of the network to attach the interface to ✔️
interface_mac_address MAC address of the network interface ❌
interface_address List of IP addresses for the network interface ❌ `` (empty list)
interface_prefix Prefix of the interface address for the network interface ❌ 24
interface_hostname Hostname for the network interface ❌
interface_wait_for_lease Whether to wait for DHCP lease on the interface ❌ false

Example

module "instance_provisioning" {
  source                       = "kubealex/libvirt-resources/libvirt//modules/terraform-libvirt-instance"
# version                      = "0.1.3" # Uncomment only if you are using the version 0.8.x of the provider

  instance_count               = 2
  instance_cloud_image         = "https://download.fedoraproject.org/pub/fedora/linux/releases/39/Cloud/x86_64/images/Fedora-Cloud-Base-39-1.5.x86_64.qcow2"
  instance_type                = "linux"
  instance_hostname            = "web-server"
  instance_domain              = "example.com"
  instance_cpu                 = 2
  instance_memory              = 4
  instance_volume_size         = 50

  instance_cloud_user = {
    username                   = "admin"
    password                   = "securepass"
    sshkey                     = "ssh-rsa AAAAB3NzaC1yc2EAAA...your-ssh-key-here"
  }

  instance_libvirt_network     = "default"
  instance_libvirt_pool        = "default"
  instance_uefi_enabled        = true
  instance_firmware            = "/usr/share/edk2/ovmf/OVMF_CODE.fd"

  instance_network_interfaces = [
    {
      interface_network_name    = "default"
      interface_mac_address     = "52:54:00:12:34:56"
      interface_address         = "192.168.1.2"
      interface_prefix          = 24
      interface_hostname        = "eth0-host"
      interface_wait_for_lease  = true
    },
    {
      interface_network_name    = "default"
      interface_mac_address     = "52:54:00:65:78:9A"
      interface_address         = "192.168.2.2"
      interface_prefix          = 16
      interface_hostname        = "eth1-host"
      interface_wait_for_lease  = false
    },
  ]
}