docs(agents): record deploy helper

This commit is contained in:
2026-08-25 21:50:43 -04:00
parent f45aa44ead
commit 48bd335494

View File

@@ -103,6 +103,7 @@ The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overla
Keep `git.alexion.dev:2022` working by proxying that TCP stream through the reverse-proxy guest to Gitea.
- Remote deploy helpers that run target-side `sudo` over SSH need a TTY.
Use `ssh -t` unless the target command is guaranteed not to prompt for sudo credentials.
- Branch deploys to another host should use the flake-managed `deploy-to <host> [branch]` fish function when available instead of hand-writing the SSH and `nixos-rebuild` command.
- `self.lib.registry.collect { hosts = self.nixosConfigurations; }` reads top-level host `config.registry` declarations only.
Registry declarations inside guest interiors live under `config.containers.<guest>.config.registry` and do not enter the collected fleet registry unless host-side code also publishes them or the collector is explicitly extended to recurse into guests.
- A NixOS module function argument default such as `registry ? config.registry` is not a safe fallback for an unprovided module argument.