blumeops/docs/how-to
Erich Blume a18a424866 Pin NixOS service versions via nixpkgs-services overlay (#321)
## Summary

- Add `nixpkgs-services` flake input pinned to a specific nixpkgs commit, with an overlay that pulls `forgejo-runner`, `snowflake`, and `k3s` from it instead of the rolling `nixpkgs`
- Dagger `flake-update` pipeline now excludes `nixpkgs-services` via `--exclude`
- Fix stale nix-container-builder version in service-versions.yaml (was 12.6.4, actually running 12.7.2)
- Add k3s and minikube to service-versions.yaml tracking
- Document the pinning approach in review-services how-to and ringtail reference

## Motivation

During service review, discovered that flake updates had silently upgraded forgejo-runner from 12.6.4 → 12.7.2 without updating service-versions.yaml. This "sneak-in upgrade" bypasses the service review process. The overlay ensures these three services only change versions deliberately.

## Test plan

- [ ] Verify `nix flake update` from `nixos/ringtail/` does not change `nixpkgs-services` lock entry
- [ ] Verify `mise run provision-ringtail` builds successfully with the overlay
- [ ] Confirm running service versions unchanged after deploy

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: #321
2026-04-01 21:37:57 -07:00
..
authentik Restructure docs: consolidate, recategorize, and extract 2026-03-15 19:55:59 -07:00
configuration Build custom Kingfisher container from sporked deploy branch (#318) 2026-03-30 06:34:49 -07:00
dagger Add how-to guide for upgrading Dagger 2026-03-06 20:31:30 -08:00
deployment Unify container build workflows (#306) 2026-03-23 20:55:50 -07:00
forgejo-runner Remove mikado frontmatter from closed chains, clarify finalization rules 2026-03-04 20:43:19 -08:00
grafana Restructure docs: consolidate, recategorize, and extract 2026-03-15 19:55:59 -07:00
knowledgebase Pin NixOS service versions via nixpkgs-services overlay (#321) 2026-04-01 21:37:57 -07:00
mealie Fix plan-a-meal random recipe API queries 2026-03-17 11:10:48 -07:00
operations Add compensating controls framework and date-based report dirs (#320) 2026-03-30 17:44:11 -07:00
ringtail Add ringtail post-deploy maintenance: kernel check, generation pruning, GC 2026-03-27 07:55:45 -07:00
runbooks C2: Deploy infrastructure alerting pipeline (#303) 2026-03-22 14:52:56 -07:00
zot Unify container build workflows (#306) 2026-03-23 20:55:50 -07:00