Cloud-Init with Terraform on Proxmox¶

This is a sample guide for using the cloud-init command with Terraform to deploy new VMs.

Table of Contents¶

1. Install cloud-init (If Not Already Installed)
2. Create a Cloud-Init Image Using the cloud-localds Command
3. Convert a Base VM into a Cloud-Init Template
- Install Dependencies on the Base VM
- Clean Up the Base VM for Cloning
4. Convert the VM into a Proxmox Cloud-Init Template
- Convert the VM to a Template
5. Use Terraform to Deploy the Cloud-Init Image
- Terraform Configuration
6. Deploy the Terraform Configuration
7. Verify the Cloud-Init VM
Conclusion

1. Install `cloud-init` (If Not Already Installed)¶

Ensure cloud-init is installed on your base VM before creating an image.

sudo dnf install cloud-init  # For Rocky Linux
sudo apt install cloud-init  # For Ubuntu/Debian

Verify installation:

cloud-init --version

2. Create a Cloud-Init Image Using the `cloud-localds` Command¶

Use cloud-localds to create a cloud-init disk with a user-defined configuration.

Create a `meta-data` file¶

This file provides instance-specific information, such as instance ID.

cat <<EOF > meta-data
instance-id: cloud-vm-001
local-hostname: my-cloud-init-vm
EOF

Create a `user-data` file¶

This file contains initial setup, such as users, passwords, SSH keys, and packages.

cat <<EOF > user-data
#cloud-config
users:
  - name: kolkhis
    sudo: ALL=(ALL) NOPASSWD:ALL
    shell: /bin/bash
    ssh_authorized_keys:
      - ssh-rsa AAAAB3...your-public-ssh-key...
package_update: true
packages:
  - qemu-guest-agent
  - htop
runcmd:
  - echo "Cloud-init configured successfully!" > /etc/motd
EOF

Generate a Cloud-Init Image¶

Create a cloud-init seed image:

cloud-localds cloud-init.img user-data meta-data

This creates a cloud-init.img file, which can be used to initialize VMs.

3. Convert a Base VM into a Cloud-Init Template¶

Now, take a clean base VM, install necessary dependencies, and configure it for cloud-init.

Install Dependencies on the Base VM¶

sudo dnf install cloud-init cloud-utils-growpart qemu-guest-agent
sudo systemctl enable --now qemu-guest-agent

Clean Up the Base VM for Cloning¶

Before turning this VM into a template, clean up persistent machine-specific settings:

sudo cloud-init clean
sudo rm -rf /etc/machine-id
sudo touch /etc/machine-id

Shut down the VM:

sudo poweroff

4. Convert the VM into a Proxmox Cloud-Init Template¶

If you're using Proxmox, create a template for future Terraform use.

Convert the VM to a Template¶

Locate the VM ID:
```
qm list
```
Convert it to a Template:
```
qm template <VM_ID>
```

Create a Cloud-Init Disk:

qm set <VM_ID> --ide2 local-lvm:cloud-init

Configure Boot Options for Cloud-Init:

qm set <VM_ID> --boot c --bootdisk scsi0

Resize the Disk (If Needed):
```
qm resize <VM_ID> scsi0 +10G
```

5. Use Terraform to Deploy the Cloud-Init Image¶

After setting up the cloud-init template, you can use Terraform to deploy VM instances.

Terraform Configuration¶

provider "proxmox" {
  pm_api_url      = "https://192.168.1.10:8006/api2/json"
  pm_user         = "root@pam"
  pm_password     = "password"
  pm_tls_insecure = true
}

resource "proxmox_vm_qemu" "cloud_vm" {
  name        = "cloud-vm-1"
  target_node = "proxmox-node"
  clone       = "cloud-init-template"

  disks {
    scsi {
      disk {
        size    = "10G"
        storage = "local-lvm"
      }
    }
  }

  network {
    model  = "virtio"
    bridge = "vmbr0"
  }

  os_type = "cloud-init"
  ciuser  = "kolkhis"
  cipassword = "your-password"
  sshkeys = <<EOT
ssh-rsa AAAAB3...your-public-ssh-key...
EOT
}

6. Deploy the Terraform Configuration¶

Run the following Terraform commands to deploy your VM.

terraform init
terraform apply -auto-approve

7. Verify the Cloud-Init VM¶

Once Terraform has created the VM, verify that cloud-init applied the settings.

ssh kolkhis@<VM_IP>

Check logs:

sudo cloud-init status
sudo cloud-init analyze

tl;dr¶

cloud-init automates VM initialization for Terraform in Proxmox.
Using cloud-localds, you preconfigure VM settings (users, SSH keys, packages).
Converting a base VM to a Proxmox Cloud-Init template allows dynamic deployment via Terraform.