Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

housekeeping: Update module go.temporal.io/sdk to v1.29.1 #3119

Closed
wants to merge 1 commit into from

Conversation

renovate[bot]
Copy link
Contributor

@renovate renovate bot commented Sep 19, 2024

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
go.temporal.io/sdk v1.26.1 -> v1.29.1 age adoption passing confidence

Release Notes

temporalio/sdk-go (go.temporal.io/sdk)

v1.29.1

Compare Source

What's Changed

Full Changelog: temporalio/sdk-go@v1.29.0...v1.29.1

v1.29.0

Compare Source

Highlights

Workflow Update-With-Start (Private Preview)

Note: This feature requires a server version 1.24+ and must be enabled. For self hosted you can set frontend.enableExecuteMultiOperation for Temporal Cloud please reach out to your Temporal account team or Temporal Support Team to enable update with start in your namespace.

This release add support for Workflow Update-With-Start. Update-With-Start allows users to send a Workflow Update request along with a Start Workflow request in the same RPC. Users can think of Update-With-Start as analogous to Signal-With-Start except for Updates instead of Signals. To create a Update with start request users call client.NewUpdateWithStartWorkflowOperation and pass it to WorkflowOptions.WithStartOperation .

Slot auto tuning (Public Preview)

  • Added WorkerOptions.Tuner which is a WorkerTuner composed of SlotSupplier s. These interfaces can be used to customize how the worker decides to make slots available for Workflow and Activity Tasks. Some default slot suppliers are included:

  • ResourceBasedSlotSupplier can be used to tune the workers slot count based on available memory and cpu resources. Make a ready-to-go WorkerTuner by using NewResourceBasedTuner. You can set a memory/cpu target and the worker will automatically try to reach those target usage levels.

  • FixedSizeSlotSupplier always hands out slots until an upper bound

  • CompositeTuner can be used to combine different kinds of SlotSuppliers to implement WorkerTuner.

Please give the resource based tuning a try and let us know how it works for you (feedback on community slack is welcome)! It'll work best if the worker is the only thing on your host using significant resources. Try setting the thresholds to a reasonable value like 0.8

Note: Resource based tuning and custom Slot Supplier implementations are currently considered experimental.

User Metadata (Public Preview)

Note: This feature requires a server version 1.25+

This release add support for user metadata inside Workflows. This lets users set custom metadata on Workflow executions and certain APIs inside workflow that will be visible on the UI

Currently the Go SDK support:

  • Fixed "summary" and "details" on workflow start
  • Details on timer names through workflow.NewTimerWithOptions
  • Details on signals, updates and query handlers through workflow.SignalChannelOptions, workflow.QueryHandlerOptions and workflow.UpdateHandlerOptions

See also: https://github.com/temporalio/features/issues/486

What's Changed

2024-07-23 - 9c40461 - Add utility to get metrics handler for a Nexus operation (#​1559)
2024-07-25 - bcc623d - Add support for managing schedule search attributes when when updating a schedule (#​1562)
2024-07-26 - 1f0296c - Support for WorkflowIdConflictPolicy (#​1563)
2024-07-29 - 2baa60e - Test duplicate rejected updates (#​1569)
2024-07-29 - 6bb8f99 - Add rule code to warning (#​1572)
2024-07-29 - dd28ced - Protect against legacy queries when state is destroyed (#​1568)
2024-08-05 - 9b9201f - Use correct branch when not a pull request (#​1578)
2024-08-05 - c5b519e - Build omes worker image w/ pending changes (#​1577)
2024-08-06 - a1d05a6 - WorkerTuner & Resource based autotuning (#​1546)
2024-08-06 - c2ce2e6 - Do not warn on unfinished handlers if workflow failed (#​1581)
2024-08-08 - 2927574 - Switch omes to post-merge (#​1583)
2024-08-09 - 0b7928d - Fix UpsertTypedSearchAttributes docs typo (#​1585)
2024-08-14 - bb42a8b - Fix Go SDK CI (#​1590)
2024-08-14 - c3ac511 - Improve docs and tests for HandlerUnfinishedPolicy (#​1589)
2024-08-15 - 2a02c48 - Removing wording saying a signal will ignore start delay (#​1592)
2024-08-15 - b5db2b7 - Add TaskQueueStats to DescribeTaskQueueEnhanced (#​1553)
2024-08-20 - edc3c6c - Allow workflow interceptors to add nexus headers (#​1604)
2024-08-21 - 1fe6141 - Support updates in tracing interceptor (#​1595)
2024-08-21 - a31f86d - Address flaky tests (#​1607)
2024-08-22 - 9bcc1a9 - Minor docstring grammar updates in activity.go (#​1608)
2024-08-23 - 94f2100 - Minor correction to TQ stats docs (#​1606)
2024-08-28 - 5364a47 - Handle Nexus links (#​1605)
2024-08-29 - e85a098 - Update-with-Start operation (#​1579)
2024-08-30 - 1b6220d - Mark Nexus link converter functions as experimental (#​1615)
2024-08-30 - f47e644 - Experimental user metadata and workflow metadata query support (#​1597)
2024-09-03 - 2af8c72 - Narrow scope of used slots lock for tracking slot supplier (#​1617)
2024-09-03 - 52ea97f - Mark NewTimerWithOptions as Experimental (#​1619)
2024-09-03 - eb41d13 - Expose QueryRejectedError (#​1616)

2024-07-23 - 9c40461 - Add utility to get metrics handler for a Nexus operation (#​1559)
2024-07-25 - bcc623d - Add support for managing schedule search attributes when when updating a schedule (#​1562)
2024-07-26 - 1f0296c - Support for WorkflowIdConflictPolicy (#​1563)
2024-07-29 - 2baa60e - Test duplicate rejected updates (#​1569)
2024-07-29 - 6bb8f99 - Add rule code to warning (#​1572)
2024-07-29 - dd28ced - Protect against legacy queries when state is destroyed (#​1568)
2024-08-05 - 9b9201f - Use correct branch when not a pull request (#​1578)
2024-08-05 - c5b519e - Build omes worker image w/ pending changes (#​1577)
2024-08-06 - a1d05a6 - WorkerTuner & Resource based autotuning (#​1546)
2024-08-06 - c2ce2e6 - Do not warn on unfinished handlers if workflow failed (#​1581)
2024-08-08 - 2927574 - Switch omes to post-merge (#​1583)
2024-08-09 - 0b7928d - Fix UpsertTypedSearchAttributes docs typo (#​1585)
2024-08-14 - bb42a8b - Fix Go SDK CI (#​1590)
2024-08-14 - c3ac511 - Improve docs and tests for HandlerUnfinishedPolicy (#​1589)
2024-08-15 - 2a02c48 - Removing wording saying a signal will ignore start delay (#​1592)
2024-08-15 - b5db2b7 - Add TaskQueueStats to DescribeTaskQueueEnhanced (#​1553)
2024-08-20 - edc3c6c - Allow workflow interceptors to add nexus headers (#​1604)
2024-08-21 - 1fe6141 - Support updates in tracing interceptor (#​1595)
2024-08-21 - a31f86d - Address flaky tests (#​1607)
2024-08-22 - 9bcc1a9 - Minor docstring grammar updates in activity.go (#​1608)
2024-08-23 - 94f2100 - Minor correction to TQ stats docs (#​1606)
2024-08-28 - 5364a47 - Handle Nexus links (#​1605)
2024-08-29 - e85a098 - Update-with-Start operation (#​1579)
2024-08-30 - 1b6220d - Mark Nexus link converter functions as experimental (#​1615)
2024-08-30 - f47e644 - Experimental user metadata and workflow metadata query support (#​1597)
2024-09-03 - 2af8c72 - Narrow scope of used slots lock for tracking slot supplier (#​1617)
2024-09-03 - 52ea97f - Mark NewTimerWithOptions as Experimental (#​1619)
2024-09-03 - eb41d13 - Expose QueryRejectedError (#​1616)
2024-09-05 - 6f8719a - Improve active task queue definition (#​1621)

v1.28.1

Compare Source

Specific Changes

v1.28.0

Compare Source

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

v1.27.0

Compare Source

Reset workflow with Updates

The Go SDK now supports reapplying Workflow Updates when resetting a workflow execution.

Note: Support for reapplying updates on workflow reset require a server version ≥1.24.0

Request failure code labeled metrics

gRPC request failure metrics (*request_failure) emitted by the Go SDK now include the error status code as a tag under status_code. This can be disabled by setting DisableErrorCodeMetricTags on client.Options.

See also: #​1472

💥 BREAKING CHANGES

This release includes some breaking changes for the experimental features Workflow Update and Worker Versioning. Users of these features should read the release notes carefully before upgrading.

Workflow Update (Experimental)

Based on users feedback this release makes some breaking changes to the Workflow Update API used by client and workflows code.

Client API changes
  • Merged Client.UpdateWorkflowWithOptions and Client.UpdateWorkflow into one API called Client.UpdateWorkflow that takes a client.UpdateWorkflowOptions struct.
  • WaitPolicy in client.UpdateWorkflowOptions was replaced with WaitForStageWaitForStage is now a required parameter in client.UpdateWorkflowOptions.
  • WaitForStage is now properly respected by Client.UpdateWorkflow. Previously Client.UpdateWorkflow may have returned a handle before the desired WaitForStage was reached.
Workflow API changes
  • workflow.SetUpdateHandler and workflow.SetUpdateHandlerWithOptions Now require update handles to take a workflow.Context as the first argument.
  • workflow.GetUpdateInfo has been renamed to workflow.GetCurrentUpdateInfo .

Worker Versioning (Experimental)

Worker Versioning is a pre-release, experimental feature that simplifies managing code changes by allowing you to peg workflows to build versions. This change revamps and improves the API and deprecates the existing experience.

The new APIs introduced with worker versioning are:

  • GetWorkerVersioningRules returns assignment and redirect rules for a given task queue.
  • UpdateWorkerVersioningRules updates assignment and redirect rules for a given task queue.
  • DescribeTaskQueueEnhanced extends the functionality of DescribeTaskQueue with workflow reachability status.

A few APIs associated with legacy worker versioning have been deprecated:

  • UpdateWorkerBuildIdCompatibility replaced by UpdateWorkerVersioningRules.
  • GetWorkerBuildIdCompatibility replaced by GetWorkerVersioningRules.
  • GetWorkerTaskReachability replaced by DescribeTaskQueueEnhanced.

Note: These new Worker Versioning APIs require a server version ≥1.24.0

Internally call grpc.NewClient instead of grpc.Dial

Internally the SDK now calls grpc.NewClient instead of grpc.Dial because it was deprecated in google.golang.org/grpc

This should be a transparent change to most users, google.golang.org/grpc does call out one subtle difference:

One subtle difference between NewClient and Dial and DialContext is that the former uses "dns" as the default name resolver, while the latter use "passthrough" for backward compatibility. This distinction should not matter to most users, but could matter to legacy users that specify a custom dialer and expect it to receive the target string directly.

Some deprecated dial options like WithBlock, WithTimeout, WithReturnConnectionError, and FailOnNonTempDialError are now ignored by grpc.NewClient. See https://github.com/grpc/grpc-go/blob/master/Documentation/anti-patterns.md for more context.

See also: #​1488

Child workflows now properly Continue-As-New in the TestWorkflowEnvironment

In previous version of the Go SDK when a child workflow running in the test environment tried to continue as new the parent workflow would receive an error from the child workflow. Now the child workflow properly continues as new and the parent workflow will not receive an error.

See also: #​1437

Specific Changes

2024-04-12 - c4bf074 - datadog: Add tracer option to check error eligibility in the span (#​1438)
2024-04-17 - 69bc6c3 - Update reapply (#​1436)
2024-04-23 - 93c08b0 - Ensure consistent labels for rpc metrics (#​1444)
2024-04-24 - 8361067 - Disable UTF8-invalid tests when running CLI dev server (#​1448)
2024-04-30 - fe44a47 - Improve error message for missing body (#​1451)
2024-05-01 - d051de6 - Option to redirect devserver stdout/stderr to a file (#​1452)
2024-05-09 - 386a6d3 - Require update handler to have a context (#​1457)
2024-05-09 - ded70a3 - Add support for NextRetryDelay for local activities (#​1456)
2024-05-10 - 81cd5dc - Fix QueryRejectCondition parameter in QueryWorkflowWithOptions (#​1461)
2024-05-10 - c69831e - Remove DisableStickyExecution (#​1464)
2024-05-14 - 3b68c6d - Add request failure code label to metrics (#​1472)
2024-05-17 - aa17647 - get-free-port: prevent duplicate ports on Linux (#​1478)
2024-05-21 - 06c0ebc - Add SetFailureConverter to the activity and workflow test environments (#​1484)
2024-05-21 - 222d4cf - Fix gauge metrics with latest otel SDK (#​1482)
2024-05-21 - 725b428 - Only record activity_succeed_endtoend_latency on success (#​1481)
2024-05-21 - fb06909 - Send original update request back in response (#​1480)
2024-05-22 - bf2c79d - Switch to using Float64Gauge in otel integration (#​1485)
2024-05-24 - a6ca6a5 - Replace grpc.Dial with grpc.NewClient (#​1488)
2024-05-28 - bcfa85a - Workflow update client API refactor (#​1489)
2024-05-31 - 486c233 - Minor logger improovments (#​1495)
2024-05-31 - 4dd1ed8 - Fix bugs when using a custom FailureConverter in tests (#​1490)
2024-06-06 - 0df7ad5 - Bump GitHub Actions (#​1503)
2024-06-06 - 17193aa - Manually copy proxy options (#​1502)
2024-06-06 - 5c171b7 - Make backfill tests more robust (#​1504)
2024-06-06 - 9ecb2a4 - Change GetUpdateInfo to GetCurrentUpdateInfo (#​1505)
2024-06-06 - bf29944 - testsuite.StartDevServer: Respect timeout during dial (#​1498)
2024-06-07 - c73a007 - Support the new versioning API (#​1494)
2024-06-10 - d4ff1f6 - Fix flake in TestUpdateAdmittedNoWorker (#​1506)
2024-06-12 - 38fe879 - Always run all the versioning tests (#​1510)
2024-06-12 - a7c8208 - Allow SDK to handle speculative WFT with command events (#​1509)
2024-06-13 - 2720358 - Improve CI action (#​1512)
2024-06-13 - 30a29ce - Add integration test for reset with update events (#​1507)
2024-06-13 - 4c8b9e1 - Update API to v1.34.0 (#​1511)


Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate renovate bot requested a review from a team as a code owner September 19, 2024 22:05
@renovate renovate bot added the dependencies Pull requests that update a dependency file label Sep 19, 2024
Copy link
Contributor Author

renovate bot commented Sep 19, 2024

ℹ Artifact update notice

File name: backend/go.mod

In order to perform the update(s) described in the table above, Renovate ran the go get command, which resulted in the following additional change(s):

  • 17 additional dependencies were updated

Details:

Package Change
github.com/grpc-ecosystem/grpc-gateway/v2 v2.19.1 -> v2.22.0
golang.org/x/net v0.24.0 -> v0.28.0
golang.org/x/oauth2 v0.17.0 -> v0.22.0
golang.org/x/sync v0.6.0 -> v0.8.0
google.golang.org/genproto/googleapis/api v0.0.0-20240415180920-8c6c420018be -> v0.0.0-20240822170219-fc7c04adadcd
google.golang.org/genproto/googleapis/rpc v0.0.0-20240415180920-8c6c420018be -> v0.0.0-20240822170219-fc7c04adadcd
google.golang.org/grpc v1.63.2 -> v1.65.0
google.golang.org/protobuf v1.33.0 -> v1.34.2
github.com/cespare/xxhash/v2 v2.2.0 -> v2.3.0
github.com/cncf/xds/go v0.0.0-20231128003011-0fa0005c9caa -> v0.0.0-20240423153145-555b57ec207b
go.temporal.io/api v1.32.0 -> v1.38.0
golang.org/x/crypto v0.22.0 -> v0.26.0
golang.org/x/mod v0.15.0 -> v0.17.0
golang.org/x/sys v0.19.0 -> v0.24.0
golang.org/x/term v0.19.0 -> v0.23.0
golang.org/x/text v0.14.0 -> v0.17.0
golang.org/x/tools v0.18.0 -> v0.21.1-0.20240508182429-e35e4ccd0d2d

Copy link

This PR has been marked as stale after 7 or more days of inactivity. Please have a maintainer add the on hold label if this PR should remain open. If there is no further activity or the on hold label is not added, this PR will be closed in 3 days.

@github-actions github-actions bot added the stale Issue hasn't had activity in awhile label Sep 27, 2024
@github-actions github-actions bot closed this Sep 30, 2024
Copy link
Contributor Author

renovate bot commented Sep 30, 2024

Renovate Ignore Notification

Because you closed this PR without merging, Renovate will ignore this update (v1.29.1). You will get a PR once a newer version is released. To ignore this dependency forever, add it to the ignoreDeps array of your Renovate config.

If you accidentally closed this PR, or if you changed your mind: rename this PR to get a fresh replacement PR.

@renovate renovate bot deleted the renovate/go.temporal.io-sdk-1.x branch September 30, 2024 22:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dependencies Pull requests that update a dependency file stale Issue hasn't had activity in awhile
Projects
None yet
Development

Successfully merging this pull request may close these issues.

0 participants