mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-09 21:10:59 +00:00
Hygiene: name the FHIR immunization gap, cache the digest offline, freeze the no-FK pair, document the pin bump
Four small debts from the audit tail. The FHIR bundle's missing Immunization resource gets the same written-decision paragraph the visits exclusion carries — deliberate follow-up, not oversight. The service worker's offline allowlist gains /api/daily/digest (both copies, policy module and sw.js, plus the test) so the Today rail renders on an offline reopen. The two Telegram plumbing tables that link to an account by a bare userId string are frozen as a closed NO_FK_BY_DESIGN set in the wipe guard — a third such table now fails the test instead of passing rule 1 silently. And deploy.md documents the manual digest-pin bump end to end: imagetools inspect, the env update, and the three-probe /api/version verification with the too-fast-deploy warning.
This commit is contained in:
1 parent
9d64eb6aa2
commit
bcabd43ca7
6 files changed
+79
No files matched your search
@@ -131,6 +131,34 @@ without touching the file:
|
||||
- `HEALTHLOG_IMAGE_REF=:v1.16.5` — pin to a release tag (still mutable).
|
||||
- `HEALTHLOG_IMAGE_REF=@sha256:<digest>` — pin to the immutable digest.
|
||||
|
||||
#### Bumping a digest pin by hand
|
||||
|
||||
A digest-pinned instance never follows a release on its own — an image
|
||||
promote does not touch the pin, so moving it is part of shipping. The
|
||||
mechanic, end to end:
|
||||
|
||||
1. Resolve the new release's digest from the registry (the manifest-list
|
||||
digest, which covers both architectures):
|
||||
|
||||
```sh
|
||||
docker buildx imagetools inspect ghcr.io/mbombeck/healthlog:v1.37.20 \
|
||||
| grep -m1 Digest
|
||||
```
|
||||
|
||||
2. Set `HEALTHLOG_IMAGE_REF=@sha256:<that digest>` where the compose
|
||||
environment lives — the `.env` next to the compose file, or the
|
||||
deployment platform's env vars for the app service.
|
||||
|
||||
3. Deploy as usual.
|
||||
|
||||
4. Verify `/api/version` on the target — and verify it **three times a
|
||||
few seconds apart**, not once: during the container swap a single
|
||||
probe can be answered by the outgoing container (or a cache) and read
|
||||
as success while the old release keeps running. Three stable answers
|
||||
reporting the shipped `version` + `buildSha` are the signal; a deploy
|
||||
that finishes suspiciously fast (under ~30 s) is a warning that
|
||||
nothing was actually pulled.
|
||||
|
||||
> **A pin is sticky, and a stale pin is silent.** Once set, every later deploy
|
||||
> ships that reference until someone changes it. The deploy still reports
|
||||
> success, the tag still builds, the image still publishes, and the running
|
||||
|
||||
Reference in new issue
Block a user