Scaffold incremental Terraform foundations for docker and proxmox

2026-04-14 18:08:56 +10:00
parent 7279ade925
commit 228413d780
18 changed files with 301 additions and 15 deletions
@@ -0,0 +1,36 @@
+# 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:
+
+```bash
+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.