release: cut and promote v26.11.0 to prod (first release on jazz) #515
Closed
opened 2026-07-20 23:14:37 +02:00 by timothy
·
1 comment
No Branch/Tag Specified
main
renovate/dotnet-monorepo
renovate/meziantou.analyzer-3.x
renovate/lucene.net
renovate/sqlitepclraw.bundle_e_sqlite3-3.x
renovate/cliwrap-3.x
913-scripted-playout-401
release/v26.15.0-notes
issue-806-guard-populations
scratch/767b-poisoned
scratch/767b-control
release/v26.14.0-notes
release/v26.14.0
docs/510-skill-logo-bug-policy
fix/510-watermark-resolution-policy
fix/629-verdict-classifier-falseopens
fix/609-decisions-edit-token-scope
issue-135-clear-to-none
release/v26.12.0-notes
fix/409b-lastscan-api-parity
fix/401-updatechannel-mirror-422
fix/327-playlist-rename-validation
fix/410-scancancel-log-level
fix/409-447-librariesscreen-neverscanned
fix/338-zap-exit-code
fix/367-plex-budget-message
fix/310-debom-legacy-cs
ci/604-lane-rebalance
feat/388-design-mirror
feat/247-test-ownership
feat/247-primary-action
feat/357-player-owned-playback
feat/357-jellyfin-plugin-poc
fix/289-mcp-hardening
issue58-mcp
feat/244-channels-extract
ci/auto-bump-prod-compose
feat/multi-rerun-collections-api
feat/collections-api
feat/quick-wins
feat/185-docs-part2
feat/140-collections-screen
feat/146-channel-edit
feat/147-classic-ui-link
issue22-renovate-dashboard
feat/91-cutover
feat/63-composite-create
feat/65-library-browse
feat/85-epg
feat/86-schedule-editor
feat/109-dashboard-data
feat/99-session-tracking
fix/dockerfile-node-tag
feat/59-spa-foundation
docs/59-ui-redesign-brief
feat/102-json-guide
feat/111-schedule-durations
feat/104-artwork-upload
feat/103-media-sources-api
feat/playouts-read-api
feat/108-health-api
feat/105-picker-list-endpoints
issue-97-channel-state-api
issue42-jellyfin-musicvideos
issue46-rest-api-error-contract
dependabot/nuget/ErsatzTV.FFmpeg.Tests/multi-d307a2e06f
qsv-improvements
hdr-vulkan-cuda-test
v26.16.0
v26.15.0
v26.14.0
v26.13.0
v26.12.0
v26.11.0
v26.10.0
v26.9.0
v26.8.0
v26.7.0
blazor-final
v26.6.0
v26.5.0
v26.4.0
v26.3.1
v26.3.0
v26.2.0
v26.1.1
v26.1.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.0
v25.1.0
v0.8.8-beta
v0.8.7-beta
v0.8.6-beta
v0.8.5-beta
v0.8.4-beta
v0.8.3-beta
v0.8.2-beta
v0.8.1-beta
v0.8.0-beta
v0.7.9-beta
v0.7.8-beta
v0.7.7-beta
v0.7.6-beta
v0.7.5-beta
v0.7.4-beta
v0.7.3-beta
v0.7.2-beta
v0.7.1-beta
v0.7.0-beta
v0.6.9-beta
v0.6.8-beta
v0.6.7-beta
v0.6.6-beta
v0.6.5-beta
v0.6.4-beta
v0.6.3-beta
v0.6.2-beta
v0.6.1-beta
v0.6.0-beta
v0.5.8-beta
v0.5.7-beta
v0.5.6-beta
v0.5.5-beta
v0.5.4-beta
v0.5.3-beta
v0.5.2-beta
v0.5.1-beta
v0.5.0-beta
v0.4.5-alpha
v0.4.4-alpha
v0.4.3-alpha
v0.4.2-alpha
v0.4.1-alpha
v0.4.0-alpha
v0.3.8-alpha
v0.3.7-alpha
develop
v0.3.6-alpha
v0.3.5-alpha
v0.3.4-alpha
v0.3.3-alpha
v0.3.2-alpha
v0.3.1-alpha
v0.3.0-alpha
v0.2.5-alpha
v0.2.4-alpha
v0.2.3-alpha
v0.2.2-alpha
v0.2.1-alpha
v0.2.0-alpha
v0.1.5-alpha
v0.1.4-alpha
v0.1.3-alpha
v0.1.2-alpha
v0.1.1-alpha
v0.1.0-alpha
v0.0.62-alpha
v0.0.61-alpha
v0.0.60-alpha
v0.0.59-alpha
v0.0.58-alpha
v0.0.57-alpha
v0.0.56-alpha
v0.0.55-alpha
v0.0.54-alpha
v0.0.53-alpha
v0.0.52-alpha
v0.0.51-alpha
v0.0.50-alpha
v0.0.49-prealpha
v0.0.48-prealpha
v0.0.47-prealpha
v0.0.46-prealpha
v0.0.45-prealpha
v0.0.44-prealpha
v0.0.43-prealpha
v0.0.42-prealpha
v0.0.41-prealpha
v0.0.40-prealpha
v0.0.39-prealpha
v0.0.38-prealpha
v0.0.37-prealpha
v0.0.36-prealpha
v0.0.35-prealpha
v0.0.34-prealpha
v0.0.33-prealpha
v0.0.32-prealpha
v0.0.31-prealpha
v0.0.30-prealpha
v0.0.29-prealpha
v0.0.28-prealpha
v0.0.27-prealpha
v0.0.26-prealpha
v0.0.25-prealpha
v0.0.24-prealpha
v0.0.23-prealpha
v0.0.22-prealpha
v0.0.21-prealpha
v0.0.20-prealpha
v0.0.19-prealpha
v0.0.18-prealpha
v0.0.17-prealpha
v0.0.16-prealpha
v0.0.15-prealpha
v0.0.14-prealpha
v0.0.13-prealpha
v0.0.12-prealpha
v0.0.11-prealpha
v0.0.10-prealpha
v0.0.9-prealpha
v0.0.8-prealpha
v0.0.7-prealpha
v0.0.6-prealpha
v0.0.5-prealpha
v0.0.4-prealpha
v0.0.3-prealpha
v0.0.2-prealpha
v0.0.1-prealpha
Labels
Clear labels
ad-hoc
api
bug
ci-cd
content
dependencies
enhancement
frontend
in-progress
jellyfin
parked
priority: high
priority: low
priority: medium
review
security
One-off / ad-hoc work not tracked by a dedicated issue
REST API / HTTP endpoints
Something isn't working
Build, test, deploy pipeline
Channel content / schedules / playlists
Dependency updates (Renovate)
New feature or improvement
ChicoryTV React SPA frontend
Claimed by an active session — do not pick up
Jellyfin tuner / IPTV integration
Excluded from automatic queue pickup; work only when explicitly selected
Adversarial review finding
Security / vulnerability fix
No labels
ad-hoc
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: timothy/ersatztv#515
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Done
What was done: Cut v26.11.0 and took it all the way through the release ritual to running in prod — the first ErsatzTV release promoted to jazz after the host move (server-management#633). Held the tag mid-flight at Timothy's request until #498 (QSV/VA-API decode) landed, then re-baselined on the new
main.Tag
v26.11.0@601d855b— 83 commits since v26.10.0, headlined by #498 (QSV profiles decode via VA-API,QsvPreferNativeDecoderdefault ON) and #67 (unified channel logo / on-screen bug).Pre-flight
mainCI green on the tag target; vulnerable-package scan clean (15/15 projects)docs/decisions.md: zero superseded entries, nothing to consolidateAdd_FFmpegProfile_QsvPreferNativeDecoder, SQLite + MySQL)Release gate — ZAP DAST on jazz against the immutable
:26.11.0: FAIL-NEW 0 / PASS 118 across 215 imported API URLs. The single WARN is the SPA catch-all returningtext/htmlon/,/appand unmatched paths — expected by design, ZAP assumes a pure-API surface. semgrep SAST: 175 rules × 4478 targets, 0 findings (verified non-vacuous —--quietproduces zero bytes either way).Promotion — Komodo
DeployStack jazz-media, all 6 stages green. Pre-deploy chain fired as designed: image-change trigger (5cc2556a → ca5e1fa1) → 286 M backup,integrity_check=ok, off-box PBS → migration smoke PASS on the prod-copy → onlyersatztvrecreated.Live verification — prod runs registry manifest digest
sha256:ca5e1fa1…, matched against:26.11.0rather than inferred from tag equality (the #350 lesson). Containerhealthy, migration20260720175125_…applied on the live DB, 43 channels in M3U and XMLTV, 4397 programmes, 0[ERR]/[FTL].Root cause (of the doc defects found): the release ritual was written for bumblebee and silently broke in three ways after the host move — none would have thrown an error.
security-scan.sh on bumblebee→ would have scanned the wrong host.jazzis a reused name — it was an earlier name for the .99 host, so pre-migration references meaning today's bumblebee read as "jazz", including one assertingjazz (192.168.1.99). A find-and-replace in either direction corrupts the other set, so the fix is a Hosts table + resolve by IP, not by name.DeployStack media-serversnames a dead stack: amedia-serversstack still exists on bumblebee (unhealthy, the stopped leftovers) so the wrong name doesn't error, and container labels hide it (compose project is stillmedia-servers; the Komodo stack isjazz-media). Alsoauto_update: falsenow, so the documented Global-Auto-Update fallback no longer exists.Near-miss worth recording:
jazz-media'spre_deployfield reads as a no-op (ssh … true) and I nearly filed a lost-safety-hook regression. It's anauthorized_keysforced command — thetrueis discarded andetv-komodo-predeploy.shruns. Judge the hook by the deploy'sPre Deploystage log, never the config field.Files changed:
docs/ci-cd.md(Hosts table + name-reuse warning, scan host, docker host,jazz-media+ no-auto-update, version-table rows for v26.10.0/v26.11.0),CLAUDE.md(deploy host, config volume, Komodo stack),docs/m3u-xmltv.md(stalejazz→ bumblebee).PRs: #501, #507, #514 (all docs-only, merged green).
Deferred:
QsvPreferNativeDecoder(stored1) does nothing until a profile is switched to QSV. That switch is the actual payoff and is Timothy's call; confirming the fix needs a few channel cold-starts watched afterwards.ersatztv/ersatztv-test/jellyfinplus the deadmedia-serversKomodo stack. Deliberately not reaped (not mine to remove); they are what made trap #3 silent. Belongs to server-management.Follow-up issues: none filed in this repo — the remaining cleanup is server-management's (bumblebee leftovers).
Docs updated:
docs/ci-cd.md,CLAUDE.md,docs/m3u-xmltv.md(PRs #501/#507/#514); vault~/homelab-docs/Docker/ErsatzTV.md(auto-update now OFF, resolved the open "confirm the backup chain exists on jazz" caveat by execution, recorded both traps) — pushed asf507d42. Project memory:prod-moved-to-jazz-and-name-reuse,komodo-stack-is-jazz-media.Deferred items — both now closed out
1. #498 activated in prod. Profile 1 switched
hardwareAcceleration: Vaapi → Qsv(keepingqsvPreferNativeDecoder: true), so the release's headline fix is no longer inert. Verified by the live ffmpeg command line —-hwaccel vaapidecode +-init_hw_device qsv=hw@va+-c:v h264_qsvencode, exactly the Jellyfin pattern — and 6/6 channel cold-starts clean against the issue's measured 50% failure rate. Full evidence in #498.Rollback if ever needed:
PUT /api/v1/ffmpeg/profiles/1withhardwareAcceleration: "Vaapi". (The API normalizespadModetoHardwareIfPossibleon the QSV path.)2. Bumblebee leftovers filed as server-management#641 (
priority: low) — the stoppedersatztv/ersatztv-test/jellyfin/dispatcharrcontainers plus the deadmedia-serversKomodo stack. Framed around why it matters rather than tidiness: while that stack exists,DeployStack media-serverssilently succeeds against the wrong, dead target, and the container labels don't reveal it because the compose project on jazz is stillmedia-servers.