blumeops/docs/how-to
Erich Blume 1b9f706a30 Document container tag provenance and enhance container-list (#263)
## Summary

After investigating deployed container images, confirmed that squash-merging PRs orphans the commit SHAs embedded in container image tags. Two of our currently deployed images (prometheus, grafana) reference branch commits not on main.

This PR:

- Documents the squash-merge SHA orphan problem and the post-merge workflow in [[build-container-image]]
- Adds step 9 to the C1 process: after merging a PR that changes `containers/`, do a follow-up C0 to point manifests at the rebuilt `[main]` tag
- Rewrites `container-list` as a `uv run --script` (typer + rich + httpx)
- Adds optional container name filter (`mise run container-list prometheus` shows 10 tags instead of 4)
- Annotates every tag with `[main]` or `[branch]` based on git commit ancestry

## Test plan

- [x] `mise run container-list` — all containers shown with `[main]`/`[branch]` hints
- [x] `mise run container-list prometheus` — filtered view, more tags, correctly shows `[main]` and `[branch]`
- [x] `mise run container-list nonexistent` — error message with exit code 1
- [x] Pre-commit hooks pass

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/263
2026-02-24 09:54:58 -08:00
..
authentik Review migrate-grafana-to-authentik: fix file paths, add last-reviewed 2026-02-24 07:29:41 -08:00
configuration Rename containers/forgejo-runner to runner-job-image 2026-02-23 17:44:51 -08:00
deployment Document container tag provenance and enhance container-list (#263) 2026-02-24 09:54:58 -08:00
forgejo-runner Upgrade k8s forgejo-runner from v6.3.1 to v12.7.0 (#251) 2026-02-22 17:43:39 -08:00
grafana C2: Upgrade Grafana to 12.x with Nix container and Kustomize (#260) 2026-02-23 18:07:18 -08:00
knowledgebase Replace indri-runner-logs with general-purpose runner-logs Typer CLI (#244) 2026-02-22 10:20:11 -08:00
operations Review gandi-operations doc and reorganize how-to guides (#200) 2026-02-17 07:29:33 -08:00
plans Review Grafana: replace Helm upgrade plan with C2 Mikado chain (#258) 2026-02-23 15:06:00 -08:00
ringtail Update ringtail flake inputs, add flake-update pipeline (#240) 2026-02-22 08:17:52 -08:00
zot Docs pass: update zot Mikado chain for completion 2026-02-21 15:32:34 -08:00
agent-change-process.md Document container tag provenance and enhance container-list (#263) 2026-02-24 09:54:58 -08:00
how-to.md Formalize C0/C1/C2 change classification (#259) 2026-02-23 16:19:54 -08:00