From e26d81cc21c6854eb74cdc3d710ea2c5cf3de34c Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Thu, 12 Nov 2026 11:31:45 +0000 Subject: [PATCH] Chart 1.5.0: default to native Server 3.7.0 Co-Authored-By: Claude Opus 5.5 --- k8s/helm/durable-workflow/Chart.yaml | 14 ++++++------ k8s/helm/durable-workflow/README.md | 2 +- k8s/helm/durable-workflow/docs/UPGRADING.md | 24 +++++++++++++++++++++ k8s/helm/durable-workflow/values.yaml | 2 +- resources/release/source-release.json | 4 ++-- 5 files changed, 35 insertions(+), 11 deletions(-) diff --git a/k8s/helm/durable-workflow/Chart.yaml b/k8s/helm/durable-workflow/Chart.yaml index 3a08b0242..523a5b398 100644 --- a/k8s/helm/durable-workflow/Chart.yaml +++ b/k8s/helm/durable-workflow/Chart.yaml @@ -5,11 +5,11 @@ type: application # The chart's own semver version. Bumped on every chart release; treated as # independent of the server image version (appVersion). Breaking-change rules # for this version live in docs/UPGRADING.md alongside the chart. -version: 1.4.0 +version: 1.5.0 # The immutable native Durable Workflow Server this chart release packages. # The onboarding default in values.yaml and appVersion are generated from the # checked-in source release record (helm_chart.app_version). -appVersion: "3.6.0" +appVersion: "3.7.0" kubeVersion: ">=1.27.0-0" home: https://durable-workflow.github.io/docs/2.0/deployment sources: @@ -30,14 +30,14 @@ annotations: # exact commit that most recently changed the packaged chart. org.opencontainers.image.source: https://github.com/durable-workflow/server dev.durable-workflow.source-revision: "unreleased" - dev.durable-workflow.image-reference: "docker.io/durableworkflow/server:3.6.0" + dev.durable-workflow.image-reference: "docker.io/durableworkflow/server:3.7.0" artifacthub.io/license: MIT artifacthub.io/category: integration-delivery # Free-form changelog for the current chart release shown by Artifact Hub. artifacthub.io/changes: | - kind: changed - description: "Default image changes from native Server 3.5.0 to 3.6.0. No schema upgrade from 3.5.0: MySQL, MariaDB and PostgreSQL stay at native schema 12, so helm upgrade only replaces the image. Rolling back to 3.5.0 is an image change. From 3.4.x or earlier, run the 3.5.0 schema upgrade first (docs/UPGRADING.md)." - - kind: security - description: "Server 3.6.0's runtime base moves to the current Debian 12 bookworm-slim image, fixing CVE-2026-109518 (apt 2.6.1); every release is now scanned and a fixable HIGH or CRITICAL finding holds promotion (server#802)." + description: "Default image changes from native Server 3.6.0 to 3.7.0. MySQL only needs a schema upgrade, 12 to 13: its 75 json columns become exact-text LONGTEXT with json_valid checks, about 2 minutes of downtime per million history rows. Scale to zero, back up, run helm upgrade with native.schemaUpgrade.enabled=true, scale up; rolling back means restoring the backup. MariaDB, PostgreSQL and SQLite have no schema change, so helm upgrade only replaces the image (docs/UPGRADING.md)." + - kind: fixed + description: "Server 3.7.0: MySQL stores JSON documents exactly, so doubles in history, memos, search attributes and heartbeat details come back bit for bit (server#1016)." - kind: added - description: "Server 3.6.0: read an update's outcome later (server#1131), replay-safe entry clock on workflow tasks (server#1132), activity retries resume from the last heartbeat (server#1139), replay-blocked runs in operator metrics (server#1154). https://github.com/durable-workflow/server/releases/tag/3.6.0" + description: "Server 3.7.0: redrive keeps start-time memos and search attributes, and describe reports can_redrive and redrive_blocked_reason (server#980). https://github.com/durable-workflow/server/releases/tag/3.7.0" diff --git a/k8s/helm/durable-workflow/README.md b/k8s/helm/durable-workflow/README.md index 9174723d3..d8e4bd5fc 100644 --- a/k8s/helm/durable-workflow/README.md +++ b/k8s/helm/durable-workflow/README.md @@ -77,7 +77,7 @@ helm install durable-workflow ./k8s/helm/durable-workflow \ ```yaml image: - tag: "3.6.0" + tag: "3.7.0" # Pin a digest in production: # digest: "sha256:abc123..." diff --git a/k8s/helm/durable-workflow/docs/UPGRADING.md b/k8s/helm/durable-workflow/docs/UPGRADING.md index d0b29d695..54f1f532a 100644 --- a/k8s/helm/durable-workflow/docs/UPGRADING.md +++ b/k8s/helm/durable-workflow/docs/UPGRADING.md @@ -69,6 +69,30 @@ chart MINOR bump and an entry below. ## Per-version migration notes +### Chart 1.5.0 / Server 3.7.0 (native) + +**MySQL only: this upgrade needs an explicit native schema upgrade, 12 to 13.** +Server 3.7.0 stores MySQL JSON documents as exact text: its 75 `json` columns in +36 tables become `LONGTEXT` (`utf8mb4_bin`) with an enforced `json_valid` +check, one `ALTER TABLE` per table. The Server is down for the whole upgrade: +measured at about 2 minutes per million history rows (MySQL 8.0, 2 CPUs, +default buffer pool). A resumed upgrade continues table by table. + +1. Scale the Server to zero. +2. Back up the database. +3. Run `helm upgrade` with `native.schemaUpgrade.enabled=true` (or the manual + schema-upgrade Job in the chart README) so the 3.7.0 image runs + `schema-upgrade` once. +4. Scale the Server back up. + +Rolling back to 3.6.0 on MySQL requires restoring the backup taken in step 2. + +**MariaDB, PostgreSQL and SQLite: no schema change.** MariaDB stays at 12 with +an unchanged checksum and PostgreSQL at 12, so `helm upgrade` only replaces the +image, and rolling back to 3.6.0 is an image change. From Server 3.4.x or +earlier, apply the Chart 1.3.0 schema upgrade below first. See the +[3.7.0 release notes](https://github.com/durable-workflow/server/releases/tag/3.7.0). + ### Chart 1.4.0 / Server 3.6.0 (native) No schema upgrade from Server 3.5.0: MySQL, MariaDB and PostgreSQL stay at diff --git a/k8s/helm/durable-workflow/values.yaml b/k8s/helm/durable-workflow/values.yaml index 9161188db..71c2f1ef9 100644 --- a/k8s/helm/durable-workflow/values.yaml +++ b/k8s/helm/durable-workflow/values.yaml @@ -42,7 +42,7 @@ image: # scripts/ci/sync-source-release.mjs. Do not edit this default. # A tag must match the runtime: 3.x (or latest) for native, 2.x for php. # The chart refuses a mismatch at render time. - tag: "3.6.0" + tag: "3.7.0" # Optional digest pin. When set, takes precedence over tag for change control. # Example: "sha256:abc123..." # The chart cannot see which runtime a digest names. Pin a native digest diff --git a/resources/release/source-release.json b/resources/release/source-release.json index 886c19234..e82b7a94a 100644 --- a/resources/release/source-release.json +++ b/resources/release/source-release.json @@ -4,7 +4,7 @@ "version": "2.11.8" }, "helm_chart": { - "version": "1.4.0", - "app_version": "3.6.0" + "version": "1.5.0", + "app_version": "3.7.0" } }