Repository navigation
Prepare native Server 3.12.0 retained payload bindings and version usage release - #1225
Conversation
Select durableworkflow/server:3.12.0 as the published Compose default and add docs/releases/3.12.0.md covering retained payload storage bindings (#1224), open-run version usage (#1221) and portable native library builds (#1223), with the explicit schema steps, rollback and retained limits. Co-Authored-By: Claude Opus 5.5 <[email protected]>
|
General review of head |
|



Native Server 3.12.0 release preparation. Following the 3.11.0 precedent (#1218), this changes two files: the published Compose default moves from
durableworkflow/server:3.11.0todurableworkflow/server:3.12.0, and newdocs/releases/3.12.0.mddocuments everything merged to main after tag3.11.0(da38c0ed) up to2c675220. The Chart 2.1.0 prep commit is excluded because it is already released.Contents
e363a472, fixes Keep stored external payloads readable after a namespace storage policy is disabled or moved #546). Native local external payloads keep an immutable original binding (namespace, storage generation, canonical root) across disabled or moved write policies. Reads, pruning, abandoned-upload cleanup and namespace deletion use that binding.c4070777, native slice of Report legacy version-marker usage across open native runs #1220). AddsGET /api/workflow-version-usagebehindcapabilities.workflow_version_usage.3d90086f, refs Compile disabled storage admission in the native library on Windows #1222). Unix-only storage-admission observation checks are now compiled only on Unix targets, so portable library builds work. Published Linux images behave the same.Schema, upgrade and rollback facts (from code)
rust/src/runtime/schema.rsVERSION,postgres.rsVERSION,mysql.rsMYSQL_VERSION/MARIADB_VERSION, andrust/migrations/*/00{15,16,17}_external_storage_bindings.sql. Each step adds the nullableruntime_external_payloads.storage_bindingandworkflow_namespaces.external_payload_storage_generation BIGINT NOT NULL DEFAULT 0.schema-upgradeis needed (schema_upgrade.rs). SQLite and PostgreSQL run it in one transaction. MySQL and MariaDB resume an interrupted ALTER (ensure_external_storage_bindings). With Helm 2.x, use the existing opt-innative.schemaUpgrade.enabledpre-upgrade hook or the manual Job.external_payload_storage_binding_unavailable(409) (external_storage_binding.rs,namespaces.rs::set_external_policy). Objects stranded under 3.11.x can be repaired by naming their original root explicitly.native_schema_newer_than_binary. Rollback means restoring the pre-upgrade database and payload backup.Checks run locally
native-release-github-release.shpass. All five relative links and anchors exist.scripts/ci/check-native-release-tags.shpasses.verify-native-release-dispatch.sh(stubgh) accepts tag 3.12.0 and refuses 3.11.0 against this Compose file.tests/Unit/NativePublishedComposeContractTest.phppasses (7 tests).resources/release/source-release.json(PHP 2.11.8 / chart) is intentionally unchanged.Open questions for the owner
schema_upgrade::UPGRADABLEis[7, 8, 10, 11, 12, 13, 14, 15]and does not include 16. As a result, a 3.12.0 binary started on a 3.11.x MySQL database (marker 16) refuses withunsupported_rust_schemainstead ofnative_schema_upgrade_required.schema-upgradeitself still upgrades 16 → 17 throughFlavor::earlier(16). No test covers this startup reason. The notes therefore avoid naming the reason code. Recommendation: add 16 toUPGRADABLEwith a test before tagging.pin_legacy_payloads. Please confirm, or document a supported repair.Not done here: merge, tag, dispatch, publication or alias movement. #980, #1204 and #1220 consumer follow-through are unchanged.
🤖 Generated with Claude Code