Fluxheim 1.5.12

[eldryoth]

Fluxheim 1.5.12 Release Notes

Fluxheim 1.5.12 starts the Fluxheim-native background task registry line.

This release is intentionally narrow. It moves Fluxheim-owned background work
behind a Fluxheim adapter while keeping Pingora only as the server registration
boundary for now.

What Changed

• Added src/background.rs with Fluxheim-owned shutdown and readiness wrappers
  for background tasks. Task implementations now see a Tokio watch-based
  shutdown handle and a one-shot readiness callback instead of Pingora
  background-service types.
• Moved cache runtime metrics, stale cache purging, ACME renewal, and the admin
  self-healing watchdog to FluxBackgroundTask.
• Moved load-balancer discovery and health refresh services through the shared
  background adapter while preserving readiness after the initial discovery
  update.
• Added regression coverage for shutdown wakeups, closed shutdown channels,
  readiness idempotence, and load-balancer readiness after the initial
  background update.
• Kept the release boundary clear: no HTTP proxy lifecycle rewrite, no stream
  listener migration, no cache interface rewrite, and no UDP/GSLB, WAF,
  VPN/firewall, or Wasm/iRules/Lua work in this tag.

Operational Notes

• Existing configuration remains compatible.
• Background shutdown behavior remains graceful and cancellation-aware.
• ACME background automation, cache purging, cache metrics, admin watchdog, and
  load-balancer refresh behavior should match 1.5.11 from an operator
  perspective.

Checksums And Signatures

• Commit: 7ff7cfad8423b255df62addaf30e38a86840fcd2
• Local gate: GitHub CI green before tag; local release metadata checks passed
• CodeQL/code scanning: no open release-blocking alerts before tag
• Source archive checksums:
  • [MANUAL_SHA256] fluxheim-1.5.12.tar.gz
  • [MANUAL_SHA256] fluxheim-1.5.12.zip
• Binary checksums:
  • x86_64:
    • dcde4d5d6d2a4553c271135955b58bf0d7dd84103a091a773675b52ec564680e fluxheim-1.5.12-full-x86_64-linux.tar.gz
    • dd6199e1007d1f24e9a092929c06daef6f378ed7bb33a7ef0bf326eb087fbba4 fluxheim-1.5.12-cache-x86_64-linux.tar.gz
    • 5e52ddc47cfb76d2cc632b74dbf1ed422a2c483359e7ad6feccd9624edbca3c7 fluxheim-1.5.12-proxy-x86_64-linux.tar.gz
    • 9743cad95e70d3e525c3632a4a73c71115de5d5d1420a5c747d21e962bf90e0f fluxheim-1.5.12-php-x86_64-linux.tar.gz
    • c50420c7a7cd0a94b53e3187c07ff1a08246fac40d09a72a2b4e16883741bf90 fluxheim-1.5.12-load-balancer-x86_64-linux.tar.gz
    • a3aed416d9acaa64c5df85e365cdbb9c75dc0abd49d41029186f3ff4032dabaf fluxheim-1.5.12-config-tester-x86_64-linux.tar.gz
  • aarch64:
    • a51635db0881e46367b6afcee4f061493fa722835745fbd3c4033b71e12481d5 fluxheim-1.5.12-full-aarch64-linux.tar.gz
    • 724ba7d6b74c37236becffb60b88a9cf4c31b1be09968bc79150bbdf10c511b6 fluxheim-1.5.12-cache-aarch64-linux.tar.gz
    • c473f0c639bbeec76a02b27d0c181553bc9f67d6054901c0b63e8872cc75c9bc fluxheim-1.5.12-proxy-aarch64-linux.tar.gz
    • fbb5d9e65aa3f57505ee30b5785329da24164ac35a27fa9229dbdf8d92adec9a fluxheim-1.5.12-php-aarch64-linux.tar.gz
    • 9e9d7fbe46188af9b3f8285f8ac47e0f1c487a84064bccd040097418d9c7d9ac fluxheim-1.5.12-load-balancer-aarch64-linux.tar.gz
    • e22683a576604114ab03a62c01ad35ff761c65e6caf5187ffad07ea942543db3 fluxheim-1.5.12-config-tester-aarch64-linux.tar.gz
  • macos:
    • cac15d20ff378fd0e72d98eedfd3f7a185ad9e8e0b4d9428db3edba15af40a12 fluxheim-1.5.12-dev-aarch64-macos.tar.gz
• SBOM checksums:
  • fluxheim.spdx.json
  • fluxheim.cyclonedx.json
• Reproducible build:
  • 98f59f9af39d071d02e98576b7eaa216c19bab0f9a2152d03798b8b3e38b620a x86_64
  • 69644c2c08b8513aa5dd06cccf206a1fc6b4f95e77837f42c1cacb68ec28277b aarch64
  • [MANUAL_SHA256] macos
• Full Build Container digests:
  • Wolfi: ghcr.io/valkyoth/fluxheim@sha256:c8c23efcb3c40d8efc409f0715d0c071c6be015b3f69b883a6798844cd22426d
  • Alpine: ghcr.io/valkyoth/fluxheim@sha256:32dd45ffaa71918d4bd0a0c6f938174e2435255f3602ad19d959473a93e02040
  • SUSE Micro: ghcr.io/valkyoth/fluxheim@sha256:1257d2db5026d248b9476137caa13e9b2b54d50577635eee441d7aa07d54059f
  • Debian: ghcr.io/valkyoth/fluxheim@sha256:301c7310402305387f13a6d96f8f8fbdee69a17ba52c4837f61b460bfc950038
• Cache Build Container digests:
  • Wolfi: ghcr.io/valkyoth/fluxheim@sha256:d2c424312032ab0bb3ae0ec51fd0db9ec2acb3067c29b4ef59c11485eb022583
  • Alpine: ghcr.io/valkyoth/fluxheim@sha256:cf1a46d3d6427d571112d875db33fd497231e5a879e6d3183a646d162db42c3e
  • SUSE Micro: ghcr.io/valkyoth/fluxheim@sha256:5f54bd2f37ab4932863f97892adb4671d474f50f2bf5a2a5647fb2738df29367
  • Debian: ghcr.io/valkyoth/fluxheim@sha256:775757cae27f5cf3e92373db430d9341943add9d1de051d2e8593994c7cc521a
• Proxy Build Container digests:
  • Wolfi: ghcr.io/valkyoth/fluxheim@sha256:c43e62979bb34be857e613d8be1e8c9fa43c8bfa64c310076ebd2372f508dcb6
  • Alpine: ghcr.io/valkyoth/fluxheim@sha256:3805674054b4b18f48bbcdddaf4f7993ae0e4ac4fdcbdd2d909273b83ae7c633
  • SUSE Micro: ghcr.io/valkyoth/fluxheim@sha256:1e17e5dad339b65a1343c98279528f684916cd1cb704a067d24a42259cb8a526
  • Debian: ghcr.io/valkyoth/fluxheim@sha256:7c4bf2ce4f632f43138eebd46d7b77356e2e93dc956a6536aa400fab56216a60
• PHP Build Container digests:
  • Wolfi: ghcr.io/valkyoth/fluxheim@sha256:321791f6f2b3f3eef94e3a0718749906b5e2d507e3c9c2a389eb8eca0c27cb30
  • Alpine: ghcr.io/valkyoth/fluxheim@sha256:56408e1f14d02cb7b27f79583843bf3bd0e5317c206c77cb2778b21c46a9950e
  • SUSE Micro: ghcr.io/valkyoth/fluxheim@sha256:2d0b84cc4e4c58eeb71a5fb6f6030911142d39c3b8a85c3499190de71ed83800
  • Debian: ghcr.io/valkyoth/fluxheim@sha256:00d807177204df07e49caea07259e30690ff051cb5f50197c831e91f816f9f94
• Load Balancer Build Container digests:
  • Wolfi: ghcr.io/valkyoth/fluxheim@sha256:604db7f86e55ffc54a392f88676c5fc37b007424c7e1351597d16ec3f1092cdc
  • Alpine: ghcr.io/valkyoth/fluxheim@sha256:016712339edbbfe789768701c73e77a81257afad85df4763c2e4acdadb000aa7
  • SUSE Micro: ghcr.io/valkyoth/fluxheim@sha256:7fa6344f0758ee63e748bd2f82068843478006e33b07cf404a416eaa3f71e213
  • Debian: ghcr.io/valkyoth/fluxheim@sha256:79a4699c1d96ed8fcc56363c6ab71e42dc634aa291c40ffb5d1186ede3803ff7
• Tag signature:
  • Good "git" signature for 1921261+eldryoth@users.noreply.github.com with ED25519 key SHA256:EoLRQ5k4J5pYz3UMFmkrV798gYFNkToGS2xEPvebqB4

---

This discussion was created from the release Fluxheim 1.5.12.