docs(720): name all three Komodo stacks and the label-based resolution rule #769

Merged

timothy merged 2 commits from docs/720-komodo-stack-naming into main 2026-08-11 21:26:08 +02:00

Conversation 0 Commits 2 Files Changed 1

+18

timothy commented 2026-08-11 19:10:32 +02:00

Owner

Copy Link

Copy Source

fixes #720

The existing docs/ci-cd.md callout tells you which stack name is dead (media-servers). It did not tell you that the most obvious name is live and wrong: a Komodo stack literally named ersatztv owns ersatztv-test, tracks :latest, and auto-updates. DeployStack ersatztv succeeds, looks healthy, and promotes nothing to prod — silent and plausible, the worst shape.

This extends (does not replace) the existing callout with all three names and the resolution rule: identify the prod stack by the container's com.docker.compose.project.config_files label, not by stack name.

Verification. The issue's table was dated 2026-08-03, so it was re-measured live against jazz (192.168.1.29) on 2026-08-11 rather than transcribed. It matched:

== ersatztv       media-servers  /etc/komodo/stacks/jazz-media/.../media-servers/compose.yaml  …/ersatztv:prod
== ersatztv-test  ersatztv       /etc/komodo/stacks/ersatztv/.../ersatztv/compose.yaml         …/ersatztv:latest

Scope note — one ## Done-when box is deliberately not closed by this PR. Box 2 ("server-management komodo skill example no longer uses the dead media-servers") is in a different repository and cannot land here. It is handed over rather than quietly ticked; see the issue comment. Docs-only, so exempt from the review-verdict gate.

fixes #720 The existing `docs/ci-cd.md` callout tells you which stack name is **dead** (`media-servers`). It did not tell you that the most obvious name is **live and wrong**: a Komodo stack literally named `ersatztv` owns `ersatztv-test`, tracks `:latest`, and auto-updates. `DeployStack ersatztv` succeeds, looks healthy, and promotes nothing to prod — silent and plausible, the worst shape. This extends (does not replace) the existing callout with all three names and the resolution rule: **identify the prod stack by the container's `com.docker.compose.project.config_files` label, not by stack name.** **Verification.** The issue's table was dated 2026-08-03, so it was re-measured live against jazz (192.168.1.29) on 2026-08-11 rather than transcribed. It matched: ``` == ersatztv media-servers /etc/komodo/stacks/jazz-media/.../media-servers/compose.yaml …/ersatztv:prod == ersatztv-test ersatztv /etc/komodo/stacks/ersatztv/.../ersatztv/compose.yaml …/ersatztv:latest ``` **Scope note — one `## Done-when` box is deliberately not closed by this PR.** Box 2 ("server-management `komodo` skill example no longer uses the dead `media-servers`") is in a **different repository** and cannot land here. It is handed over rather than quietly ticked; see the issue comment. Docs-only, so exempt from the review-verdict gate.

timothy added 1 commit 2026-08-11 19:10:34 +02:00

docs(720): name all three Komodo stacks and the label-based resolution rule ... d9c80e2a49

A live Komodo stack literally named `ersatztv` exists, but it owns the
TEST channel (`ersatztv-test`, tracks `:latest`, auto_update true) — not
prod. `DeployStack ersatztv` succeeds and looks healthy while promoting
nothing. Extend the existing jazz-media/media-servers callout with this
third stack and the rule that resolves the trap: identify the prod stack
by the container's `com.docker.compose.project.config_files` label, not
by stack name. Verified live against jazz (192.168.1.29) on 2026-08-11.

fixes #720

timothy referenced this pull request 2026-08-11 21:16:49 +02:00

docs(ci-cd): a Komodo stack named `ersatztv` now exists on jazz — and it is NOT prod #720

timothy added 1 commit 2026-08-11 21:19:42 +02:00

docs(720): scope the verification date to what was actually re-measured ... de69364376

Cold review: the "(verified 2026-08-11)" stamp sat on a paragraph whose
auto_update flags and bumblebee-unhealthy status were NOT re-checked that
day — only the container labels (stack name, compose project, config_files
path, image tag) were. A freshness claim that covers more than was measured
is the shape that later reads as a checked fact and talks the next reader
out of verifying.

Refs: #720

timothy merged commit f9f8f65cee into main 2026-08-11 21:26:08 +02:00

timothy deleted branch docs/720-komodo-stack-naming 2026-08-11 21:26:09 +02:00

timothy referenced this pull request 2026-08-11 21:26:31 +02:00

docs(ci-cd): a Komodo stack named `ersatztv` now exists on jazz — and it is NOT prod #720

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

ad-hoc

One-off / ad-hoc work not tracked by a dedicated issue

api

REST API / HTTP endpoints

bug

Something isn't working

ci-cd

Build, test, deploy pipeline

content

Channel content / schedules / playlists

dependencies

Dependency updates (Renovate)

enhancement

New feature or improvement

frontend

ChicoryTV React SPA frontend

in-progress

Claimed by an active session — do not pick up

jellyfin

Jellyfin tuner / IPTV integration

parked

Excluded from automatic queue pickup; work only when explicitly selected

priority: high

priority: low

priority: medium

review

Adversarial review finding

security

Security / vulnerability fix

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

renovate timothy (Timothy)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: timothy/ersatztv#769