hive-priv, hive-c0re: link docs/network.md instead of restating it
The network-isolation doc comments carried prose docs/network.md already owns, and three of them named `harness-base.nix` — a file that does not exist. The `hyperhive-isolated-dns` oneshot lives in nix/agent-modules/network.nix, which the doc gets right. That is #3749's argument reproducing itself: the same fact written in two places goes stale in the copy nobody reads. Linking removes the class, not just the instance — a link cannot name a nonexistent file without the doc noticing first. Trap and measurement comments stay put, per the issue's scope: the load-bearing HOST_ADDRESS default-route note, the unquoted $EXTRA_NSPAWN_FLAGS expansion, and the "isolation is the only mode" invariants are facts about this code, not about the subsystem.
This commit is contained in:
parent
49c3b86dfd
commit
e56fc97be8
3 changed files with 20 additions and 25 deletions
|
|
@ -131,12 +131,12 @@ fn bind_child_agent_dirs(child: &str, binds: &mut Vec<BindMount>) {
|
|||
}
|
||||
|
||||
/// Idempotently rewrite the lines in `/etc/nixos-containers/<container>.conf`
|
||||
/// that hive-c0re owns: `PRIVATE_NETWORK` (always 1 — every container runs in
|
||||
/// its own network namespace with a veth on the host bridge, and the agent's
|
||||
/// web UI is reached over that bridge rather than a host-shared netns),
|
||||
/// `HOST_ADDRESS` (the bridge gateway IP, so the container installs a default
|
||||
/// route before DHCP completes) and `EXTRA_NSPAWN_FLAGS` (the runtime-dir
|
||||
/// bind). The start script expands `$EXTRA_NSPAWN_FLAGS` unquoted into the
|
||||
/// that hive-c0re owns: `PRIVATE_NETWORK` (always 1), `HOST_ADDRESS` (the
|
||||
/// bridge gateway IP) and `EXTRA_NSPAWN_FLAGS` (the runtime-dir bind). What
|
||||
/// those network vars mean and why isolation is unconditional:
|
||||
/// `docs/network.md` § *What the Rust side does*.
|
||||
///
|
||||
/// ⚠️ The start script expands `$EXTRA_NSPAWN_FLAGS` unquoted into the
|
||||
/// `systemd-nspawn` command.
|
||||
#[allow(
|
||||
clippy::too_many_lines,
|
||||
|
|
|
|||
Loading…
Reference in a new issue