nix: comments state current behaviour, not history
Rewrite comments and option descriptions under nix/ that narrate how the
code got here ("used to", "new name", "sat at the TOP", "no longer",
renamed/moved narration, attributions) to say what the code does now and
why. Comments and description strings only; no logic changes.
Files in open PR #4970's diff are left alone. Refs #3902
This commit is contained in:
parent
ea63b0d150
commit
1c90619fbb
45 changed files with 331 additions and 411 deletions
|
|
@ -130,9 +130,9 @@ let
|
|||
# leaf to hold, and its absence there is the correct state rather
|
||||
# than a stale one — its own vhosts are covered by the hive leaf
|
||||
# above. Anywhere else it is expected: the leaf comes from the
|
||||
# secret store's `pki` mount now, not from a sub-CA that exists on
|
||||
# one host in the swarm, so "this host cannot issue it" is no longer
|
||||
# one of the answers.
|
||||
# secret store's `pki` mount, reachable from every host rather than
|
||||
# from a sub-CA on one host in the swarm, so "this host cannot issue
|
||||
# it" is not one of the answers.
|
||||
want_svc=${if localServiceDomains == [ ] then "0" else "1"}
|
||||
|
||||
# Expiry is not the only way a leaf goes wrong. One signed when the
|
||||
|
|
@ -346,17 +346,14 @@ in
|
|||
};
|
||||
|
||||
config = lib.mkIf active {
|
||||
# 🚫 The "these service names are outside this hive's domain and this
|
||||
# host cannot sign for them" warning is GONE, and its absence is the
|
||||
# deliverable rather than a tidy-up. It fired on
|
||||
# `!swarm.ca.autoConfigure` — i.e. "this host does not hold the swarm
|
||||
# root key" — which was the whole reason a hive could end up serving
|
||||
# its own leaf on a swarm-service name. The services leaf now comes
|
||||
# from the secret store's `pki` mount, which every hive reaches over
|
||||
# the network with its own identity, so holding the root key stopped
|
||||
# being the thing that decides. Left in place it would warn, on every
|
||||
# rebuild of every hive that is not the CA host, about a fallback
|
||||
# that no longer happens.
|
||||
# 🚫 There is deliberately NO warning that these service names are
|
||||
# outside this hive's domain and this host cannot sign for them. The
|
||||
# services leaf comes from the secret store's `pki` mount, which every
|
||||
# hive reaches over the network with its own identity, so holding the
|
||||
# swarm root key does not decide whether a hive can serve a
|
||||
# swarm-service name. Such a warning would fire on every rebuild of
|
||||
# every hive that is not the CA host, about a fallback that does not
|
||||
# happen.
|
||||
|
||||
# The state dir and the trust bundle. Never waits on the store: the
|
||||
# store's container is ordered after this unit, which writes the
|
||||
|
|
|
|||
Loading…
Reference in a new issue