Add Dynu Terraform brownfield DNS documentation layer
This commit is contained in:
@@ -50,6 +50,12 @@ Compose files define intended service runtime composition, networking, labels, a
|
||||
|
||||
Dynu write operations are intentionally blocked in this repository stage.
|
||||
|
||||
### 7) Terraform Dynu DNS layer
|
||||
|
||||
`infrastructure/terraform/dynu/` is the brownfield Terraform DNS mirror/reconciliation root for Dynu domain/record inventory outputs.
|
||||
|
||||
At this stage it is primarily documentation-oriented catalog output, ready for one-object-at-a-time imports.
|
||||
|
||||
## Output shaping expectations
|
||||
|
||||
When adding Terraform outputs for documentation/tooling:
|
||||
|
||||
@@ -30,6 +30,10 @@ Use Terraform when documenting/reconciling existing:
|
||||
|
||||
Do **not** treat Terraform as a full replacement for Compose operations in this repo.
|
||||
|
||||
- Dynu public DNS records remain authoritative at Dynu.
|
||||
- Terraform Dynu configuration mirrors/reconciles Dynu DNS state for documentation and controlled drift management.
|
||||
- Imported Dynu Terraform state reflects actual provider-side DNS state at import time.
|
||||
|
||||
|
||||
### Ansible bootstrap decisions
|
||||
|
||||
|
||||
@@ -43,6 +43,21 @@ Use for existing Proxmox VMs and metadata reconciliation.
|
||||
5. Keep lifecycle ignore rules narrow and explicit.
|
||||
6. Iterate per VM until plan stabilizes.
|
||||
|
||||
|
||||
## Dynu DNS workflow
|
||||
|
||||
Directory: `infrastructure/terraform/dynu/`
|
||||
|
||||
Use for existing Dynu domains and DNS records.
|
||||
|
||||
1. Add or confirm the documentation catalog entry for one hostname.
|
||||
2. Confirm the provider resource type and import ID format.
|
||||
3. Import one existing domain or DNS record at a time.
|
||||
4. Inspect state with `terraform state show`.
|
||||
5. Reconcile only stable, meaningful attributes into hand-maintained `.tf`.
|
||||
6. Keep record IDs, dynamic DNS targets, and provider-computed values out unless intentionally required.
|
||||
7. Re-run plan until intended scope is clean.
|
||||
|
||||
## Physical host metadata workflow
|
||||
|
||||
Physical host metadata currently lives in Proxmox Terraform locals/outputs and is used as documentation inventory context.
|
||||
|
||||
Reference in New Issue
Block a user