docs: document nexus.provisioning provisioning-pointer options #12

Merged

vnprc merged 1 commit from agent/document-provisioning-option into master

2026-07-15 21:46:01 +01:00

allod-agent commented

2026-07-15 21:41:45 +01:00

Member

Follow-up to allod/nexus#10 (merged): documents the nexus.provisioning.deployFlake / inventoryCheckout options that PR added.

Adds a "Provisioning pointers" section to docs/provisioning-scripts.md describing the DEPLOY_FLAKE / INVENTORY_CHECKOUT environment variables the host-side rebuild-vm-from-host / provision-vm-from-host scripts read (and their $HOME/work/allod/{profiles,inventory} defaults), and how the nexus.provisioning.* options render them into the operator session environment declaratively instead of per-shell exports. Notes the absolute-path requirement (a malformed value fails evaluation) and that these are login/session variables, so a one-shot non-interactive ssh host '…' may not see them and falls back to the defaults.

Docs-only (R0). Validation: prose only, no code or generated-behavior change; no flake check reads docs/, so nix flake check is unaffected.

Follow-up to allod/nexus#10 (merged): documents the `nexus.provisioning.deployFlake` / `inventoryCheckout` options that PR added. Adds a "Provisioning pointers" section to `docs/provisioning-scripts.md` describing the `DEPLOY_FLAKE` / `INVENTORY_CHECKOUT` environment variables the host-side `rebuild-vm-from-host` / `provision-vm-from-host` scripts read (and their `$HOME/work/allod/{profiles,inventory}` defaults), and how the `nexus.provisioning.*` options render them into the operator session environment declaratively instead of per-shell exports. Notes the absolute-path requirement (a malformed value fails evaluation) and that these are login/session variables, so a one-shot non-interactive `ssh host '…'` may not see them and falls back to the defaults. Docs-only (R0). Validation: prose only, no code or generated-behavior change; no flake check reads `docs/`, so `nix flake check` is unaffected.

allod-agent added 1 commit

2026-07-15 21:41:45 +01:00

docs: document nexus.provisioning options for provisioning pointers 8e483f94b9

Note in docs/provisioning-scripts.md that rebuild-vm-from-host and
provision-vm-from-host read DEPLOY_FLAKE / INVENTORY_CHECKOUT from the operator
environment, and that nexus.provisioning.deployFlake / inventoryCheckout set
them declaratively on the host module instead of per-shell exports (unset by
default; absolute path required).