Extract local deploy into a reusable operational command #110

New issue

Closed

opened 2026-07-28 08:15:55 +01:00 by nimmo · 1 comment

nimmo commented

2026-07-28 08:15:55 +01:00

Owner

Goal

Move the implementation of local deployment out of the Just recipe and expose it as a reusable, explicitly packaged command.

Scope

Extract the current local deploy implementation: host/specialisation selection, build output handling, NVD comparison, sudo keepalive, activation, and cleanup.
Provide a stable command interface such as nixos-deploy through the flake's package/app surface.
Keep just deploy as a thin compatibility wrapper initially.
Preserve Electra's hardware-presence specialisation rules: dgpu only when the expansion bay is installed, igpu when it is absent.
Preserve current build, diff, activation, cleanup, and failure semantics.

Non-goals

Do not move deploy-remote; it is deliberately a Just workflow that stages the working tree with rsync and invokes deployment remotely.
Do not move test; it remains a workflow around temporary activation.
Do not change deployment policy or add unattended deployment.

Acceptance criteria

nixos-deploy supports the current local deployment modes and specialisation arguments.
just deploy delegates to the packaged command without duplicating the implementation.
Local deployment behavior is unchanged, including NVD output and cleanup on failure.
The command has declared runtime dependencies and can be exercised from the flake/development environment.
Shell linting, flake checks, and focused deployment-command regression coverage pass.
README command documentation explains when to use nixos-deploy, just deploy, and just deploy-remote.

## Goal Move the implementation of local deployment out of the Just recipe and expose it as a reusable, explicitly packaged command. ## Scope - Extract the current local `deploy` implementation: host/specialisation selection, build output handling, NVD comparison, sudo keepalive, activation, and cleanup. - Provide a stable command interface such as `nixos-deploy` through the flake's package/app surface. - Keep `just deploy` as a thin compatibility wrapper initially. - Preserve Electra's hardware-presence specialisation rules: `dgpu` only when the expansion bay is installed, `igpu` when it is absent. - Preserve current build, diff, activation, cleanup, and failure semantics. ## Non-goals - Do not move `deploy-remote`; it is deliberately a Just workflow that stages the working tree with rsync and invokes deployment remotely. - Do not move `test`; it remains a workflow around temporary activation. - Do not change deployment policy or add unattended deployment. ## Acceptance criteria - `nixos-deploy` supports the current local deployment modes and specialisation arguments. - `just deploy` delegates to the packaged command without duplicating the implementation. - Local deployment behavior is unchanged, including NVD output and cleanup on failure. - The command has declared runtime dependencies and can be exercised from the flake/development environment. - Shell linting, flake checks, and focused deployment-command regression coverage pass. - README command documentation explains when to use `nixos-deploy`, `just deploy`, and `just deploy-remote`.

nimmo added this to the Developer Experience and Configuration Hygiene milestone

2026-07-28 08:15:55 +01:00

nimmo referenced this issue

2026-07-31 18:27:23 +01:00

feat: package local NixOS deployment command #125

nimmo commented

2026-08-09 22:48:34 +01:00

Author

Owner

Closing as complete: packages/nixos-deploy/default.nix provides the reusable command; just deploy delegates to it; the README documents the intended command choice; and both focused regression checks pass (tests/nixos-deploy-regressions.sh and tests/nixos-deploy-wrapper-regressions.sh).

Closing as complete: `packages/nixos-deploy/default.nix` provides the reusable command; `just deploy` delegates to it; the README documents the intended command choice; and both focused regression checks pass (`tests/nixos-deploy-regressions.sh` and `tests/nixos-deploy-wrapper-regressions.sh`).

nimmo closed this issue

2026-08-09 22:48:35 +01:00