ansible-koji/opentofu

Despliegue Básico de OpenTofu Libvirt CS10

Este proyecto proporciona una configuración básica de OpenTofu para desplegar máquinas virtuales utilizando el proveedor Libvirt.

Prerrequisitos

Esto hay que hacerlo en tu estación de trabajo, como root.

# Añadir usuario a grupos libvirt, kvm, qemu (reemplaza <tu_nombre_de_usuario>)
usermod -a -G libvirt,kvm,qemu <tu_nombre_de_usuario>

# Sal y vuelve a entrar en tu sesión o reinicia

# Fedora
## Instalar libvirt-nss
dnf install libvirt-nss

## Habilitar libvirt-nss
authselect enable-feature with-libvirt-nss

# Reinicia tu sistema.

Adicionalmente, tienes que tener una imagen base de CentOS Stream 10 en: $HOME/VirtualMachines/cs10-base.qcow2. Debe ser una instalación mínima y con la instalación sin LVM; con la partición de root como la del índice más alto.

Por ejemplo, tus particiones deben lucir así:

# lsblk
NAME   MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
vda    253:0    0  100G  0 disk
├─vda1 253:1    0  600M  0 part /boot/efi
├─vda2 253:2    0    1G  0 part /boot
├─vda3 253:3    0  512M  0 part [SWAP]
└─vda4 253:4    0  2.9G  0 part /

Important

No olvides instalar cloud-init y cloud-utils-growpart en tu imagen base de CentOS Stream 10.

Actualiza tu imagen

Un pequeño truco para actualizar tu imagen base de CentOS Stream 10:

virt-customize -a $HOME/VirtualMachines/cs10.qcow2 --smp=4 --memsize=8192 --update

Eso la actualiza ahí mismo, utilizando 4 CPUs y 8192 MiB de RAM para que sea más rápido. Es muy útil para mantener al día tu imagen base.

Despliegue

Estos comandos se ejecutan en el directorio raíz del proyecto.

# Inicializar OpenTofu
tofu init

# Revisar el plan
tofu plan

# Aplicar configuración
tofu apply

# Aplicar configuración (sin confirmación)
tofu apply -auto-approve

# Destruir recursos
tofu destroy

# Destruir recursos (sin confirmación)
tofu destroy -auto-approve

Personalización de la inyección de llaves SSH

Para usar tu propia llave SSH en las VMs:

Copia tu llave pública de SSH (ej. id_rsa.pub) a ssh/millave.pub y, luego, modifica templates/cloudinit.cfg.tftpl:

ssh_authorized_keys:
  - ${file("ssh/millave.pub")}

Aumento del Número de máquinas virtuales

Para crear múltiples "guests", ajusta la variable guest_count:

Modifica variables.tf:

variable "guest_count" {
  description = "Número de máquinas virtuales a crear"
  type        = number
  default     = 1  # Cambia este valor
}

O en terraform.tfvars:

guest_count = 3

O por línea de comandos:

tofu apply -var="guest_count=3"

Problemática

El CD-ROM tiene que usar SATA cuando usamos UEFI

Por cuestiones de diseño del plugin, hay que aplicar un parche con XSLT al XML del CD-ROM en donde se adhiere el ISO de cloud-init. El problema es que no hay manera de definir ese CD-ROM para que use el bus SATA, así que usamos la táctica descrita en este reporte para hacerlo: https://github.com/dmacvicar/terraform-provider-libvirt/issues/1018#issuecomment-1886550277

Con este parche, es posible usar cloud-init para las operaciones que necesitamos.

Note

Una alternativa a esto sería olvidarnos de cloud-init y usar scripts solamente.