Skip to content

Describe the NixOps4 integrations - #88

Merged
clhodapp merged 7 commits into
mainfrom
docs/caisson-nixops4
Oct 29, 2026
Merged

clhodapp merged 7 commits into
mainfrom
docs/caisson-nixops4

Conversation

@clhodapp

@clhodapp clhodapp commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Documents the NixOps4 integrations of nix-caisson/caisson#142. The first commit described the shape of nix-caisson/caisson#139, flake-time machines under a component option; the second rewrites it for #142.

  • docs/reference/lib.md describes four integrations. caisson-nixops4, the declaration named nixops4, holds the root composite as a deferred configuration. caisson-nixops4-composite and caisson-nixops4-resource describe the two component classes, the members view, cacheableOutputs and the NixOS adapter. nixops4, the upstream-compatible integration, takes root modules written for mkRoot.
  • docs/concepts/ecosystem-sources.md and docs/concepts/module-classes.md name the four integrations and their classes.

The link to the deferred configurations section resolves once #89 is merged, so we recommend merging #89 first.

🤖 Generated with Claude Code

@clhodapp clhodapp self-assigned this Oct 26, 2026
@clhodapp clhodapp changed the title Describe the caisson-nixops4 integration Describe the NixOps4 integrations Oct 26, 2026
clhodapp and others added 6 commits October 26, 2026 23:07
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The caisson-nixops4 configuration, named nixops4, holds its root composite as a deferred configuration finalized when NixOps4 calls rootFunction; composites and resources are their own integrations, and a resource deploys the NixOS configuration declared beneath it through the NixOS adapter. The upstream-compatible nixops4 integration takes root modules as written for mkRoot and evaluates every component in caisson.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… composite

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… asks

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…esourceConfiguration

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The root of a native deployment is the caisson-nixops4-composite
configuration declared under the name nixops4, and the
upstream-compatible root is caisson.nixops4.configurations.nixops4 of
class nixops4Component. A composite finalizes each member with its
part of its args and holds the members' manifests as its children. Its
members argument holds outputs and absoluteMemberPath. The root's
discovery program finds the state resources from each resource's
state option. The example takes its modules from the registry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp
clhodapp force-pushed the docs/caisson-nixops4 branch from 8e25c28 to 1e36f0a Compare October 27, 2026 06:08
@clhodapp
clhodapp changed the base branch from main to docs/single-outputs-and-cross-child October 27, 2026 06:09
…s read from outputs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp
clhodapp changed the base branch from docs/single-outputs-and-cross-child to main October 29, 2026 03:27
@clhodapp
clhodapp merged commit aadcf02 into main Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant