blumeops/docs/how-to/deployment
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
..
add-ansible-role.md Review gandi-operations doc and reorganize how-to guides (#200) 2026-02-17 07:29:33 -08:00
build-container-image.md Document container tag provenance and enhance container-list (#263) 2026-02-24 09:54:58 -08:00
create-release-artifact-workflow.md Review gandi-operations doc and reorganize how-to guides (#200) 2026-02-17 07:29:33 -08:00
deploy-k8s-service.md Review gandi-operations doc and reorganize how-to guides (#200) 2026-02-17 07:29:33 -08:00