blumeops/docs
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
..
changelog.d Document container tag provenance and enhance container-list (#263) 2026-02-24 09:54:58 -08:00
explanation Integrate Forgejo with Authentik OIDC (#228) 2026-02-20 17:39:50 -08:00
how-to Document container tag provenance and enhance container-list (#263) 2026-02-24 09:54:58 -08:00
reference Review deploy-authentik: rewrite as process guide (#257) 2026-02-23 14:35:39 -08:00
tutorials Formalize C0/C1/C2 change classification (#259) 2026-02-23 16:19:54 -08:00
index.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
quartz.config.ts Move zk cards to docs/zk/ for documentation restructuring (#84) 2026-02-03 09:13:50 -08:00
quartz.layout.ts Move zk cards to docs/zk/ for documentation restructuring (#84) 2026-02-03 09:13:50 -08:00