From c7a67bb7e5966095839cd44a5cb4ff1a8112865d Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Mon, 2 Nov 2026 20:58:20 -0600 Subject: [PATCH 1/2] Chart 1.0.1: default to native Server 3.0.2 The source release record moves helm_chart to 1.0.1 with app_version 3.0.2, and sync-source-release.mjs --write regenerates Chart.yaml's version, appVersion and image-reference, values.yaml's image tag and the README example. The Artifact Hub changes note and UPGRADING.md describe 1.0.1: templates and values are unchanged and the native schema stays at 8, so no schema-upgrade job is needed from 1.0.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 | 12 ++++++++++++ k8s/helm/durable-workflow/values.yaml | 2 +- resources/release/source-release.json | 4 ++-- 5 files changed, 20 insertions(+), 14 deletions(-) diff --git a/k8s/helm/durable-workflow/Chart.yaml b/k8s/helm/durable-workflow/Chart.yaml index 2b83cb0b8..bf79bcb1a 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.0.0 +version: 1.0.1 # 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.0.1" +appVersion: "3.0.2" kubeVersion: ">=1.27.0-0" home: https://durable-workflow.github.io/docs/2.0/deployment sources: @@ -30,16 +30,10 @@ 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.0.1" + dev.durable-workflow.image-reference: "docker.io/durableworkflow/server:3.0.2" 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: Run the native 3.x Server by default as one Deployment with no worker, scheduler, migration job or Redis. - - kind: added - description: Add runtime=php so existing PHP 2.x installs keep their worker, scheduler and bootstrap job. - - kind: added - description: Add an opt-in pre-upgrade job that runs the native schema-upgrade command while every Server is stopped. - - kind: changed - description: Refuse to move an existing PHP release to native unless runtime is set explicitly. + description: Default to native Server 3.0.2, which fixes the query queue wedge, failed-run describe fields and adds offline backup-hold release and inspect. Schema unchanged. diff --git a/k8s/helm/durable-workflow/README.md b/k8s/helm/durable-workflow/README.md index 175f62bf0..34a370e4d 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.0.1" + tag: "3.0.2" # 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 6ddd3ff51..aaad96dd5 100644 --- a/k8s/helm/durable-workflow/docs/UPGRADING.md +++ b/k8s/helm/durable-workflow/docs/UPGRADING.md @@ -69,6 +69,18 @@ chart MINOR bump and an entry below. ## Per-version migration notes +### Chart 1.0.1 / Server 3.0.2 (native) + +The default image is native Server 3.0.2. Nothing in the chart's templates +or values changes, and the native schema is unchanged (version 8), so an +upgrade from chart 1.0.0 needs no schema-upgrade job. Server 3.0.2 fixes +queries that stopped being answered after about 63 sequential queries, adds +the terminal failure to a failed run's describe, applies activity +cancellation policies on whole-run delivery, and adds the offline +`backup-hold release` and `backup-hold inspect` commands used during a +restore. See the +[3.0.2 release](https://github.com/durable-workflow/server/releases/tag/native-3.0.2). + ### Chart 1.0.0 / Server 3.0.1 (native) The chart now runs the native 3.x Server by default. Native is one process diff --git a/k8s/helm/durable-workflow/values.yaml b/k8s/helm/durable-workflow/values.yaml index b9585e661..3749591c8 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.0.1" + tag: "3.0.2" # 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 9feeb1b48..91090cfe7 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.0.0", - "app_version": "3.0.1" + "version": "1.0.1", + "app_version": "3.0.2" } } From 772da48aa6a8707a8216ddcb21307554620ae874 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Mon, 2 Nov 2026 21:13:50 -0600 Subject: [PATCH 2/2] Chart 1.0.1 notes: say the default image changes; disclose #979 Security's review of c7a67bb7: - The upgrade note said nothing in the chart's values changes, but the default image tag does. It now says the default image changes to 3.0.2, with no template, values contract or schema change. - Chart users configure external payload storage, so the notes now carry the known issue the 3.0.2 Release discloses (server#979, also in 3.0.1, fixed in 3.0.3): a signal above the threshold leaves its run waiting. The mitigation is to keep signal arguments below the threshold until 3.0.3. Artifact Hub's changes list and UPGRADING.md both say so and link the Release. Co-Authored-By: Claude Opus 5.5 --- k8s/helm/durable-workflow/Chart.yaml | 4 +++- k8s/helm/durable-workflow/docs/UPGRADING.md | 12 ++++++++++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/k8s/helm/durable-workflow/Chart.yaml b/k8s/helm/durable-workflow/Chart.yaml index bf79bcb1a..d68cf0e4a 100644 --- a/k8s/helm/durable-workflow/Chart.yaml +++ b/k8s/helm/durable-workflow/Chart.yaml @@ -36,4 +36,6 @@ annotations: # Free-form changelog for the current chart release shown by Artifact Hub. artifacthub.io/changes: | - kind: changed - description: Default to native Server 3.0.2, which fixes the query queue wedge, failed-run describe fields and adds offline backup-hold release and inspect. Schema unchanged. + description: Default image changes to native Server 3.0.2 (query queue wedge, failed-run describe fields, offline backup-hold release and inspect). No template, values contract or schema change. + - kind: changed + description: "Known issue in Server 3.0.2 and 3.0.1 (server#979, fixed in 3.0.3): with namespace external payload storage enabled, a signal whose arguments exceed the threshold leaves its run waiting. Keep signal arguments below the threshold until 3.0.3. https://github.com/durable-workflow/server/releases/tag/native-3.0.2" diff --git a/k8s/helm/durable-workflow/docs/UPGRADING.md b/k8s/helm/durable-workflow/docs/UPGRADING.md index aaad96dd5..eefeb6ff4 100644 --- a/k8s/helm/durable-workflow/docs/UPGRADING.md +++ b/k8s/helm/durable-workflow/docs/UPGRADING.md @@ -71,8 +71,9 @@ chart MINOR bump and an entry below. ### Chart 1.0.1 / Server 3.0.2 (native) -The default image is native Server 3.0.2. Nothing in the chart's templates -or values changes, and the native schema is unchanged (version 8), so an +The default image changes to native Server 3.0.2 (`image.tag: "3.0.2"`), so +the rendered Deployment runs the new image. No template, values contract or +values schema changes, and the native schema is unchanged (version 8), so an upgrade from chart 1.0.0 needs no schema-upgrade job. Server 3.0.2 fixes queries that stopped being answered after about 63 sequential queries, adds the terminal failure to a failed run's describe, applies activity @@ -81,6 +82,13 @@ cancellation policies on whole-run delivery, and adds the offline restore. See the [3.0.2 release](https://github.com/durable-workflow/server/releases/tag/native-3.0.2). +Known issue in Server 3.0.2, also present in 3.0.1 +([server#979](https://github.com/durable-workflow/server/issues/979), fixed in +3.0.3): when a namespace has external payload storage enabled, a signal whose +arguments exceed the storage threshold fails when it is applied and leaves its +run waiting. Until the chart moves to Server 3.0.3, keep signal arguments below +the threshold if your workflows send signals that large. + ### Chart 1.0.0 / Server 3.0.1 (native) The chart now runs the native 3.x Server by default. Native is one process