ShadowsOverWestgate/sow-tools
7
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases 38 Activity
Files
682f920114f86001354b0ffa4f97f6843cbb41c2
sow-tools/docs/adr/0004-nix-built-oci-images-start-server-side-with.md
T
archvillainette ed6945d308 Adopt workspace-wide agent standards; retire sow-docs (#51) 
Part of the workspace-wide standards rollout. Establishes where work lives (issues vs ADRs vs standing law), scaffolds `docs/agents/` for the engineering skills, and adopts ADR-0001 locally. See `sow-platform` ADR-0021 for the `sow-docs` retirement.Reviewed-on: #51
Reviewed-by: xtul <mpiasecki720@protonmail.com>
Co-authored-by: vickydotbat <vickydotbat@tutamail.com>
2026-07-24 18:43:31 +00:00

1.4 KiB
Raw Blame History

ADR-0004: Nix-built OCI images start server-side with Crucible; local Anvil images deferred

  • Status: Accepted

  • Date: 2026-06-12

  • Migrated from: sow-docs 07-decisions-log.md entry D29, on the retirement of sow-docs. Content is the original decision, unchanged.

  • Decision: Introduce Nix-built OCI images as an artifact-production option, starting with sow-tools/Crucible in server-side CI. sow-tools will grow a Nix-built crucible package plus crucible-image; PR CI builds/smokes it and main publishes the normal pinned OCI image registry.westgate.pw/deployment/crucible:<sha>. docker/Dockerfile stays during parity and as the client-compatible fallback.

  • Local rule: Nix users may get optional wrappers that provide tools and call the existing Dockerfiles for local Anvil/NWServer testing. A true nix build .#nwserver-test-image is explicitly deferred until real sow-codebase/src exists and the Dockerfile image is proven.

  • Rationale: Server-side image build shape is harder to change once deploy promotion and registry gates are active, so prove Nix image builds before cutover. Crucible is the lowest-risk pilot because it is a Go toolchain image; NodeBB and Anvil/NWServer depend more heavily on upstream container filesystem semantics.

  • Non-goals: no source builds in sow-platform; no nix-sidecar or Kubernetes-style runtime cache layer; no removal of client Dockerfiles.

Reference in New Issue View Git Blame Copy Permalink