Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions k8s/helm/durable-workflow/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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"
2 changes: 1 addition & 1 deletion k8s/helm/durable-workflow/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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..."

Expand Down
24 changes: 24 additions & 0 deletions k8s/helm/durable-workflow/docs/UPGRADING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion k8s/helm/durable-workflow/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions resources/release/source-release.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
}
Loading