37 lines
1.0 KiB
Markdown
37 lines
1.0 KiB
Markdown
# 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.
|