Important

We identified a bug in this release relating to the mutable state cache, that could cause workflows to be blocked under high load. We recommend not deploying this release.

If downgrading from this release to the 1.20 series, downgrade to 1.20.4 instead of 1.20.3. This addresses an issue where the new BuildIds search attribute was not understood and would cause errors in visibility processing.

Schema Upgrades

See the 1.21.0 release notes for schema upgrade information for upgrading to the 1.21 series.

Release Highlights

This release fixes a number of bugs:

• Workflows that use the new Workflow Update feature can be blocked with "non deterministic" errors under very rare circumstances.
• Introduce an option in the force-replication workflow to verify workflows were successfully replicated and applied on a target cluster.
• Fixed standby task discarding logic so that only task that does verification will be dropped.
• Changed the Elasticsearch Scan API back to use scroll if point in time is not available.
• Few other minor bugs.

And improvements:

• Change history event cache size from count-based to byte size-based to avoid caching large blob history events. The dynamic config keys history.eventsCacheInitialSize and history.eventsCacheMaxSize are changed to history.eventsCacheInitialSizeByte and history.eventsCacheMaxSizeByte, respectively.

All Changes

2023-07-24 - 55c4d36 - Restore defaultListWorkflowsPageSize back to 1000 (from 100) (#4674)
2023-07-21 - d0974cd - Execute VerifyReplicationTasks as an individual activity (#4656)
2023-07-21 - 9f9b172 - Fail force-replication fast if any GenerateReplicationTasks/GenerateAndVerifyReplicationTasks activity returns error (#4642)
2023-07-21 - 6247d88 - Add verification of replication tasks in force replication (#4630)
2023-07-21 - 1d5601a - Validate workflow task start time when complete (#4663)
2023-07-21 - 655c51a - Exclude history APIs from persistence health signals (#4637)
2023-07-21 - 4edce52 - Per shard per namespace RPS warning log (#4525)
2023-07-20 - 53517fd - Custom search attributes validation per store (#4655)
2023-07-20 - 2830f38 - Do not use Unvailable as error type for expected error cases (#4650)
2023-07-20 - a9a9acb - Add support for ES Scroll for Scan API (#4614)
2023-07-20 - 67de6df - change the history cache key name to *Bytes (#4649)
2023-07-20 - 268e274 - Log when health rate limiter value changes (#4648)
2023-07-20 - 32b4219 - Better handle admin handler stream replication API lifecycle (#4647)
2023-07-20 - 7a125d9 - Allow configurating history cache non-user context lock timeout (#4645)
2023-07-20 - f97b681 - do not cache large blob history event (#4621)
2023-07-20 - 49b99fe - Drop standby tasks in standby taks executor (#4626)
2023-07-20 - a466c4d - Fix metrics tagging in stream replication task processing (#4625)
2023-07-20 - bcbb3b9 - Handle replicate workflow state with exist workflow data (#4617)
2023-07-20 - 5614950 - properly fix migration in mem ack aggregation (#4571)
2023-07-20 - 1ca8443 - Allow context disable frontend redirection (#4547)
2023-07-20 - 674657b - Skip final task queue update if lost ownership (#4554)

Details about the v1.21.0 release can be found here.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.21.3)

Server
Server With Auto Setup (what is Auto-Setup?)
Admin-Tools