L

libvirt

[MVP] Multi-layer Terraform IaC for on-premise GitLab deployment on KVM/QEMU (Libvirt). Highly available core components include Kubeadm control plane, Patroni Postgres, Redis Sentinel, MinIO erasure coding, Gitaly Praefect, HashiCorp Vault with hierarchical PKI and AppRole, Harbor Registry, and GitLab Runner. The setup also integrates Keycloak OIDC SSO, standalone Harbor Bootstrapper, and LGTM observability stack. Provisioned end-to-end via Packer, Terraform, and Ansible.

Abstraction for libvirt provider in OpenTofu/Terraform + cloud-init, simplified for easy baremetal cluster creation and management on QEMU and KVM

tf-modules — Reusable Terraform Modules

The building blocks of the homelab private cloud — composable, versioned, and consumed by tf-infra.

Reusable Terraform modules for provisioning homelab infrastructure. Each module is independently versioned via semver git tags and sourced by tf-infra over SSH.

Modules network: NAT network with DHCP and local DNS via libvirt Usage

Modules are referenced in tf-infra via git SSH source:

module "network" { source = "git::ssh://git@gitlab.com/yggdrasil13/hnoss/tf-modules.git//modules/network?ref=v0.1.0" } Tech Stack IaC: Terraform (managed via tfenv) Provider: libvirt Versioning: Semver git tags (v0.1.0, v0.2.0, ...)

tf-infra — Live Terraform Infrastructure

Provisions and manages the homelab private cloud using reusable modules from tf-modules.

Live Terraform configurations that compose modules from tf-modules to provision actual infrastructure. Each environment is an independent root module with its own state.

Environments production: NAT network 10.0.100.0/24, DHCP, local DNS via libvirt staging: NAT network 10.0.101.0/24, separate domain (staging.homelab.local) What's in here environments/production/: Production root module — network layer, state, tfvars environments/staging/: Staging root module — mirrors production with isolated state CI/CD: terraform fmt + terraform validate for all environments, AI code review, semver auto-tagging Tech Stack IaC: Terraform (managed via tfenv) Provider: libvirt Modules: Sourced from yggdrasil13/hnoss/tf-modules via git SSH + semver tag

A Homelab project designed to deploy Openstack (kolla-ansible) multinode infrastructure using Gitlab CI. It will evolve step by step with endless possibilities!

Terraform for libvirt