@@ -77,7 +77,7 @@ part doing the work: a candidate publishes images under its own tag and sorts
7777_ above_ the release it is a candidate for, so ` git tag --sort=-v:refname ` lists
7878` v0.1.0-rc.1 ` before ` v0.1.0 ` and ` git describe ` would hand you the candidate.
7979Dropping every tag with a ` - ` in it leaves only releases. To take a specific
80- one, name it instead: ` git checkout v0.7 .0 ` .
80+ one, name it instead: ` git checkout v0.8 .0 ` .
8181
8282Add ` --with-geoip ` to that last command to download the country and city
8383database in the same pass — see [ GeoIP] ( #geoip ) . It is the one thing in the
@@ -116,7 +116,7 @@ because you checked out the tag before running it:
116116> your version over the baked one, which still wins.
117117
118118``` sh
119- grep OA_IMAGE .env # ghcr.io/openlabs-so/openanalytics, v0.7 .0
119+ grep OA_IMAGE .env # ghcr.io/openlabs-so/openanalytics, v0.8 .0
120120docker compose pull
121121docker compose up -d
122122docker compose logs -f migrate # schemas, both stores, from empty
@@ -643,7 +643,7 @@ Two things worth knowing before you rely on any of it:
643643
644644``` sh
645645git fetch --tags
646- git checkout v0.7 .0 # the release you are moving to
646+ git checkout v0.8 .0 # the release you are moving to
647647cd infra/selfhost
648648./upgrade.sh # tells you what it costs, then does it
649649```
@@ -664,6 +664,31 @@ standing on, takes a snapshot, points `.env` at the new images, pulls them and
664664brings everything up. On an architecture with no published images,
665665` ./upgrade.sh --from-source ` builds instead.
666666
667+ ** 0.7.0 → 0.8.0 asks nothing else of you either** , and it is short:
668+
669+ - ** The hourly rollup tables are dropped.** ClickHouse migration 0029 removes
670+ the ten ` *_1h ` tables 0.7.0 stopped writing; nothing had read them since
671+ 0.7.0 moved every chart to the fifteen-minute rollups. Site deletion stops
672+ naming them in the same release. The ` *_1d ` tables stay.
673+ - ** The history fill checks itself against your raw events.** In 0.7.0 it
674+ compared its sums with the frozen hourly tables, so an upgrade with the
675+ worker still running could log one ` history fill backfill-15m failed ` with
676+ ` additive_mismatch ` over history that was complete. It now compares with
677+ ` events_raw ` , which every rollup is built from, so that line no longer
678+ appears for that reason — when it does appear, the filled history really
679+ disagrees with the raw events, and the report above it says where.
680+ - ** Going back from 0.8.0 is a restore, not an image tag.** 0029 deletes the
681+ hourly tables, so the 0.7.0 images would find tables missing. Use
682+ ` ./rollback.sh ` to the snapshot ` ./upgrade.sh ` took, as below.
683+
684+ ** Skipping 0.7.0 (0.6.0 → 0.8.0) is supported and asks nothing extra.** The
685+ migrate container applies ClickHouse migrations 0025 through 0029 in one run
686+ and fills the fifteen-minute rollups from your raw events afterwards, so
687+ everything 0.7.0 describes below happens too — only the hourly tables are gone
688+ by the time the fill runs. That is safe because the fill reads ` events_raw `
689+ and checks itself against ` events_raw ` ; no step of it needs an hourly table.
690+ Read the 0.7.0 notes below for what the fill costs on a large install.
691+
667692** 0.6.0 → 0.7.0 asks nothing else of you either, but it does more while it
668693runs** , so it is worth knowing what you are watching:
669694
@@ -686,12 +711,9 @@ runs**, so it is worth knowing what you are watching:
686711- ** If the worker keeps running through the upgrade** — a platform redeploy, or
687712 ` docker compose pull && docker compose up -d ` without ` ./upgrade.sh ` — one
688713 quarter hour can come out short: the one in which the new views were created
689- counts only the events that arrived after that moment. The first start can
690- also log one ` history fill backfill-15m failed ` with ` additive_mismatch ` :
691- the fill checks its sums against the hourly tables, and late events that
692- arrive after the switch reach the new tables but not the frozen hourly ones.
693- The history itself is complete, and the next start does not repeat the line.
694- ` ./upgrade.sh ` stops everything first, so it has neither.
714+ counts only the events that arrived after that moment. ` ./upgrade.sh `
715+ stops everything first, so it does not have that. (0.7.0 could also log one
716+ false ` additive_mismatch ` here; 0.8.0 no longer does.)
695717- ** ClickHouse gets new grants** , for the two rollups the worker writes itself.
696718 They are rendered when its container is created, and the new image tag is
697719 what recreates it, so ` ./upgrade.sh ` and a platform redeploy deliver them
0 commit comments