docs: migrate all documentation to Discourse wiki topics
All knowledge docs (architecture, runbooks, references, audits, policies) have been migrated to community.turnsys.com as wiki topics in the VP TechOps category. Discourse is now the canonical source of truth for documentation; git edit history no longer serves as the doc changelog. 37 .md files converted to short pointers linking to their Discourse topics. AGENTS.md updated with new documentation workflow policy. Code (scripts, configs, playbooks) remains authoritative in git.
This commit is contained in:
@@ -1,25 +1,10 @@
|
||||
# Naming and DNS Policy
|
||||
# proxmox/docs/NAMING-POLICY.md
|
||||
|
||||
> **Canonical naming policy for the PFVCluster fleet.**
|
||||
> Established: 2026-07-31
|
||||
|
||||
## Rule
|
||||
|
||||
**The Proxmox VM name is the canonical identifier.** Everything else
|
||||
derives from it:
|
||||
|
||||
1. **VM name** (set via `qm set <vmid> --name <name>`) is the source of truth
|
||||
2. **DNS records** (Technitium, forward + reverse) must match the VM name exactly
|
||||
3. **Tailscale node name** must match the VM name
|
||||
4. **Monitoring/alerting** (Beszel, Uptime Kuma, LibreNMS) uses the VM name
|
||||
5. **Inventory/k8s** references use the VM name
|
||||
|
||||
Any mismatch between VM name and DNS/Tailscale name is a **critical bug**
|
||||
that must be fixed. The Technitium DNS API key is stored at
|
||||
`~/.secrets/api-keys.env` for programmatic DNS management.
|
||||
|
||||
## Tools
|
||||
|
||||
- Technitium DNS API key: `~/.secrets/api-keys.env`
|
||||
- Uptime Kuma API key: `~/.secrets/api-keys.env`
|
||||
- DNS audit: `perf/scripts/probe-vm-dns.sh`
|
||||
> **Documentation moved to Discourse — the canonical source of truth.**
|
||||
>
|
||||
> **Canonical naming policy for VMs/DNS/Tailscale**
|
||||
>
|
||||
> **Read it here:** https://community.turnsys.com/t/304
|
||||
>
|
||||
> *Migrated 2026-08-06. This file is kept as a pointer for git-browsing context.
|
||||
> Do not update content here — edit the Discourse wiki topic instead.*
|
||||
|
||||
Reference in New Issue
Block a user