53 lines
2 KiB
Markdown
53 lines
2 KiB
Markdown
|
---
|
||
|
|
title: Pin Container Versions
|
||
|
|
modified: 2026-02-20
|
||
|
|
tags:
|
||
|
|
- how-to
|
||
|
|
- containers
|
||
|
|
- ci
|
||
|
|
- zot
|
||
|
|
---
|
||
|
|
|
||
|
|
# 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 now 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:
|
||
|
|
|
||
|
|
```dockerfile
|
||
|
|
ARG CONTAINER_APP_VERSION=v0.60.3
|
||
|
|
ARG NAVIDROME_VERSION=${CONTAINER_APP_VERSION}
|
||
|
|
```
|
||
|
|
|
||
|
|
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)
|
||
|
|
- **nettest**: `CONTAINER_APP_VERSION=0.1.0` (internal, no upstream)
|
||
|
|
- **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
|
||
|
|
|
||
|
|
- [x] Every container Dockerfile has `ARG CONTAINER_APP_VERSION=X.Y.Z`
|
||
|
|
- [x] ARG chaining tested with Docker build (nginx:1.28.2-alpine)
|
||
|
|
- [x] devpi container pins pip package versions
|
||
|
|
- [x] cv version matches Forgejo package release (1.0.3)
|
||
|
|
- [x] quartz pins nginx base image to stable (1.28.2)
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [[add-container-version-sync-check]] — Parent: needs parseable versions for sync check
|
||
|
|
- [[adopt-commit-based-container-tags]] — Grandparent goal
|