diff --git a/README.md b/README.md index bcb85c2..a262d6c 100644 --- a/README.md +++ b/README.md @@ -18,22 +18,23 @@ list: | Target | Purpose | | --- | --- | -| `linode-minimal` | Minimal NixOS host profile on a Linode VPS (real, deployed) | -| `proxmox-minimal` | Minimal NixOS host profile on Proxmox (real, deployed — previously the flat `nix-minimal` target) | +| `linode-minimal` | Minimal NixOS host profile on a Linode VPS | +| `proxmox-minimal` | Minimal NixOS host profile on Proxmox — previously the flat `nix-minimal` target | | `lxc-minimal` | Minimal NixOS host profile in a Proxmox LXC container | -| `linode-nix-cache` / `proxmox-nix-cache` / `lxc-nix-cache` | Local Nix binary cache and remote builder (`lxc-nix-cache` is the real, deployed one — previously `proxmox-nix-cache`, itself previously the flat `nix-cache` target) | -| `linode-server` / `proxmox-server` / `lxc-server` | Storage, NFS, backup, and monitoring exporter host (`proxmox-server` is the real, deployed one — previously the flat `server` target) | -| `linode-docker` / `proxmox-docker` / `lxc-docker` | Docker host for the main container stack (`proxmox-docker` is the real, deployed one — previously the flat `docker` target) | -| `linode-gui` / `proxmox-gui` / `lxc-gui` | Cinnamon desktop workstation (`proxmox-gui` is the real, deployed one — previously the flat `nixos` target) | -| `proxmox-pxe-boot` / `lxc-pxe-boot` | HTTP/iPXE boot asset host (`proxmox-pxe-boot` is the real, deployed one — previously the flat `pxe-boot` target) | -| `linode-tailscale-exit-node` / `proxmox-tailscale-exit-node` / `lxc-tailscale-exit-node` | Tailscale exit node (no deployed target yet; `lxc-tailscale-exit-node` is the one planned for actual use) | +| `linode-nix-cache` / `proxmox-nix-cache` / `lxc-nix-cache` | Local Nix binary cache and remote builder — previously the flat `nix-cache` target | +| `linode-server` / `proxmox-server` / `lxc-server` | Storage, NFS, backup, and monitoring exporter host — previously the flat `server` target | +| `linode-docker` / `proxmox-docker` / `lxc-docker` | Docker host for the main container stack — previously the flat `docker` target | +| `linode-gui` / `proxmox-gui` / `lxc-gui` | Cinnamon desktop workstation — previously the flat `nixos` target | +| `proxmox-pxe-boot` / `lxc-pxe-boot` | HTTP/iPXE boot asset host — previously the flat `pxe-boot` target | +| `linode-tailscale-exit-node` / `proxmox-tailscale-exit-node` / `lxc-tailscale-exit-node` | Tailscale exit node | -This table is the only place "(real, deployed)" status is tracked — there's -no separate machine-readable copy to keep in sync. `scripts/create-proxmox-resource.sh` -guards against creating a same-identity duplicate of an already-deployed host -by checking the Proxmox node itself (live `qm`/`pct` state) rather than any -file in this repo, since a static list can't track whether a resource still -actually exists. +Which variant of a given buildtype is actually deployed isn't tracked +anywhere in this repo — that's live infrastructure state, not something a +committed file can keep accurate, and it changes independently of the code. +Check the Proxmox node itself, or `/etc/flake-target` on a running host (see +below), if you need to know what's really out there right now. +`scripts/create-proxmox-resource.sh`'s duplicate-host guard works the same +way: it checks the Proxmox node directly rather than any file here. Each buildtype's `hosts//host.nix` carries the per-machine identity (hostname, hostId, per-machine secrets, `system.stateVersion`) that must stay