Files
docker/infrastructure/terraform/proxmox

Proxmox Terraform scaffold

This directory is a placeholder scaffold for future Proxmox Terraform adoption.

What this directory is for

  • Prepare provider/version/variable structure now.
  • Delay real Proxmox resource management until import strategy is validated.

Initialize

From this directory:

terraform init

Current status

  • No live Proxmox resources are defined yet.
  • Provider auth variables are placeholders only.
  • Import IDs and resource schemas must be verified against provider docs before adding resources.

Future safe workflow

  1. Add one resource block for an existing VM/object.
  2. Import it with the provider-specific ID format.
  3. Inspect with terraform state show.
  4. Reconcile .tf arguments until terraform plan is clean.
  5. Repeat incrementally.

Safety notes

  • Do not commit real credentials in .tf files or tracked .tfvars.
  • State files are ignored by the Terraform-level .gitignore.
  • Do not run terraform apply until plan is intentionally no-op for existing resources.