Erich Blume 215ebef73e Update docs for Dagger module restructure

- Update dagger.md reference card: new module name, source path,
  container build types table, container-version function
- Update build-container-image.md: container.py as preferred for indri,
  default.nix for ringtail, navidrome as reference pattern
- Update upgrade-dagger.md: uv.lock path (no longer under .dagger/)
- Update .dagger/src/blumeops_ci path references across 5 how-to docs
- Update container-version-check and pin-container-versions docs
- Update mise-tasks reference
- Set modified: 2026-04-11 on all changed docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-11 17:09:51 -07:00

2.2 KiB

Raw Blame History

title

modified

Pin Container Versions

Ensure every container has an explicit, parseable version declaration so that add-container-version-sync-check has something to validate against.

Context

Discovered during analysis of adopt-commit-based-container-tags: containers needed a uniform, parseable version declaration for the sync check. Most containers already had version ARGs (miniflux, navidrome, ntfy, etc.), but with inconsistent naming (NAVIDROME_VERSION, MINIFLUX_VERSION, etc.), and several containers (devpi, cv, quartz, nettest) had none.

What Was Done

Every container Dockerfile declares ARG CONTAINER_APP_VERSION=X.Y.Z as its first ARG, providing a uniform parsing target. Containers that use the version in build commands chain it to a semantic ARG:

ARG CONTAINER_APP_VERSION=v0.60.3
ARG NAVIDROME_VERSION=${CONTAINER_APP_VERSION}

Note: Containers migrated to native Dagger builds use VERSION = "X.Y.Z" in container.py instead. See containers/navidrome/container.py for the pattern. New containers should use container.py rather than Dockerfiles.

Specific changes:

devpi: Pinned devpi-server==6.19.1 and devpi-web==5.0.1
cv: CONTAINER_APP_VERSION=1.0.3 (matches latest Forgejo package release)
quartz: CONTAINER_APP_VERSION=1.28.2 (pinned nginx:1.28.2-alpine base)
All others: Existing versions carried forward with new uniform ARG pattern

Key Files

File	Change
`containers/*/Dockerfile`	Add `ARG CONTAINER_APP_VERSION` to all 13 containers
`service-versions.yaml`	Populate `current-version` for devpi, cv, docs

Verification

Every container Dockerfile has ARG CONTAINER_APP_VERSION=X.Y.Z
ARG chaining tested with Docker build (nginx:1.28.2-alpine)
devpi container pins pip package versions
cv version matches Forgejo package release (1.0.3)
quartz pins nginx base image to stable (1.28.2)

add-container-version-sync-check — Parent: needs parseable versions for sync check
adopt-commit-based-container-tags — Grandparent goal

2.2 KiB Raw Blame History