docker/infrastructure/terraform/proxmox/README.md

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.