https://github.com/rgl/terraform-libvirt-debian-example
example on how to launch a debian vm using terraform-libvirt
https://github.com/rgl/terraform-libvirt-debian-example
debian libvirt terraform
Last synced: 2 months ago
JSON representation
example on how to launch a debian vm using terraform-libvirt
- Host: GitHub
- URL: https://github.com/rgl/terraform-libvirt-debian-example
- Owner: rgl
- Created: 2023-09-10T11:08:12.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-04-04T15:16:38.000Z (3 months ago)
- Last Synced: 2026-04-04T18:09:39.359Z (3 months ago)
- Topics: debian, libvirt, terraform
- Language: HCL
- Homepage:
- Size: 72.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Usage (Ubuntu 24.04 host)
[](https://github.com/rgl/terraform-libvirt-debian-example/actions/workflows/lint.yml)
Create and install the [base Debian 13 UEFI vagrant box](https://github.com/rgl/debian-vagrant).
Install Terraform:
```bash
# see https://github.com/hashicorp/terraform/releases
# renovate: datasource=github-releases depName=hashicorp/terraform
terraform_version='1.14.8'
wget "https://releases.hashicorp.com/terraform/$terraform_version/terraform_${$terraform_version}_linux_amd64.zip"
unzip "terraform_${$terraform_version}_linux_amd64.zip"
sudo install terraform /usr/local/bin
rm terraform terraform_*_linux_amd64.zip
```
Create the infrastructure:
```bash
export CHECKPOINT_DISABLE='1'
export TF_LOG='DEBUG' # TRACE, DEBUG, INFO, WARN or ERROR.
export TF_LOG_PATH="$PWD/terraform.log"
rm -f "$TF_LOG_PATH"
terraform init
terraform plan -out=tfplan
time terraform apply tfplan
```
**NB** if you have errors alike `Could not open '/var/lib/libvirt/images/terraform-debian-example-root.img': Permission denied'` you need to reconfigure libvirt by setting `security_driver = "none"` in `/etc/libvirt/qemu.conf` and restart libvirt with `sudo systemctl restart libvirtd`.
Show information about the libvirt/qemu guest:
```bash
virsh dumpxml terraform-debian-example0
virsh qemu-agent-command terraform-debian-example0 '{"execute":"guest-info"}' --pretty
virsh qemu-agent-command terraform-debian-example0 '{"execute":"guest-network-get-interfaces"}' --pretty
./qemu-agent-guest-exec terraform-debian-example0 id
./qemu-agent-guest-exec terraform-debian-example0 uname -a
ssh-keygen -f ~/.ssh/known_hosts -R "$(terraform output --json ips | jq -r '.[0]')"
ssh "vagrant@$(terraform output --json ips | jq -r '.[0]')"
```
Destroy the infrastructure:
```bash
time terraform destroy -auto-approve
```
List this repository dependencies (and which have newer versions):
```bash
GITHUB_COM_TOKEN='YOUR_GITHUB_PERSONAL_TOKEN' ./renovate.sh
```
# Virtual BMC
You can externally control the VM using the following terraform providers:
* [vbmc terraform provider](https://registry.terraform.io/providers/rgl/vbmc)
* exposes an [IPMI](https://en.wikipedia.org/wiki/Intelligent_Platform_Management_Interface) endpoint.
* you can use it with [ipmitool](https://github.com/ipmitool/ipmitool).
* for more information see the [rgl/terraform-provider-vbmc](https://github.com/rgl/terraform-provider-vbmc) repository.
* [sushy-vbmc terraform provider](https://registry.terraform.io/providers/rgl/sushy-vbmc)
* exposes a [Redfish](https://en.wikipedia.org/wiki/Redfish_(specification)) endpoint.
* you can use it with [redfishtool](https://github.com/DMTF/Redfishtool).
* for more information see the [rgl/terraform-provider-sushy-vbmc](https://github.com/rgl/terraform-provider-sushy-vbmc) repository.