v1.28.0

Nexus pre-release

⚠️ EXPERIMENTAL - APIs may change in a future release ⚠️

See the proposal for usage instructions.

Self hosted users can try Nexus out in single cluster deployments with server version 1.25.0-rc.0 - not meant for production use.

Temporal Cloud users may reach out and open a support ticket to request access to the pre-release.

To use Nexus with the temporal CLI dev server:

1. download CLI 0.14.0-nexus.0 to the current directory:

   curl -sSf https://temporal.download/cli.sh | sh -s -- --version v0.14.0-nexus.0 --dir .
   

2. run the dev server with the required configs:

   ./temporal server start-dev --dynamic-config-value system.enableNexus=true --http-port 7243
   

Warn on unfinished handlers

The SDK will now WARN by default if a workflow is completed by the SDK with unfinished update handlers. Users can use workflow.AllHandlersFinished to wait for all handlers to be finished or set UnfinishedPolicy in UpdateHandlerOptions.

Add Workflow safe Mutex and Semaphore

This release includes new helper interfaces workflow.Mutex and workflow.Semaphore that are workflow safe versions of a mutex and semaphore. These interfaces are to help users synchronize sensitive business logic across multiple coroutines or update handlers.

What's Changed

• Clean up docs for NextRetryDelay by @Quinn-With-Two-Ns in #1522
• Update some docs around grpc Dial options by @Quinn-With-Two-Ns in #1514
• Wrap GRPC::CANCELED and DEADLINE_EXCEEDED in an SDK Timeout exception… by @Quinn-With-Two-Ns in #1524
• Use grpc context for GetSystemInfo. by @Quinn-With-Two-Ns in #1528
• Add option to handle scream snake case enums. by @Quinn-With-Two-Ns in #1529
• Add workflow safe Mutex and Semaphore by @Quinn-With-Two-Ns in #1530
• Ensure our proxy helpers forward metadata by @Quinn-With-Two-Ns in #1531
• Point feature repo back to main by @Quinn-With-Two-Ns in #1532
• Warn on unhandled updates by @Quinn-With-Two-Ns in #1533
• Experimental cloud operations client by @cretz in #1462
• add Name method to ReceiveChannel and SendChannel interface by @bentveljanzx in #1538
• Test AllHandlersFinished in update validator by @Quinn-With-Two-Ns in #1540
• Fix some Deprecated go docs by @Quinn-With-Two-Ns in #1542
• Fix bug in updateWorkflowByID by @Quinn-With-Two-Ns in #1548
• Fix typed search attributes with SignalWithStartWorkflow by @Quinn-With-Two-Ns in #1552
• Add support for query parameter when listing schedules by @justinp-tt in #1556
• Nexus by @bergundy in #1555