Files
1e31c76ed1 Versioning cherry-pick for OSS v1.30.2 (#9543)
## What changed?
Cherry-pick versioning PRs
- #9168
  - Cache for system protection
- #9262 
  - Cache for system protection
- #9239 
- Critical PR to enable sending `TargetVersionChanged` flag for
Upgrade-on-CaN feature
- #9147 
- Tracks version drainage properly when version receives workflows via
`VersioningOverride`. Needed for automated worker controllers to
correctly scale versioned workers that received workflows via
`VersioningOverride`.
- #9300 
- Needed for `approximate_backlog_count` metric to track Current and
Ramping version tasks correctly
- #9316 
- Needed for `approximate_backlog_count` metric to track Current and
Ramping version tasks correctly
- #8957 
- Contains minor metric improvement. Included because it adds a test
harness that is used in the two metrics PRs above
- #9250 
  - Bug fix of task rescheduling edge case during AutoUpgrade Transition

## Why?
For OSS v1.30.2

## How did you test it?
- [x] built
- [ ] run locally and tested manually
- [x] covered by existing tests
- [ ] added new unit test(s)
- [ ] added new functional test(s)





---

> [!NOTE]
> **Medium Risk**
> Touches history/matching worker-versioning paths, adding new caches
and changing workflow task/start handling and backlog metric emission;
incorrect caching or signaling could affect dispatch/upgrade behavior
and observability.
> 
> **Overview**
> Adds new worker-versioning protections and upgrade signaling: workflow
task started events now persist a
`workflow_task_target_worker_deployment_version_changed` flag (and emit
a new `workflow_target_version_changed_count` metric) under a new
`EnableSendTargetVersionChanged` dynamic config.
> 
> Introduces two new caches with metrics and dynamic config knobs: a
`RoutingInfoCache` to avoid repeated `GetTaskQueueUserData` lookups
during activity start/transition logic, and a `ReactivationSignalCache`
plus `EnableVersionReactivationSignals` to dedupe and asynchronously
send “reactivation” signals when workflows are pinned (via
start/signal-with-start/reset/update-options) to potentially
drained/inactive worker versions.
> 
> Extends matching backlog metrics to support version-attributed
reporting by adding `BacklogMetricsEmitInterval` and switching queue DB
emission to *physical* backlog gauges (`physical_approximate_backlog_*`)
when attribution is enabled, while keeping legacy gauges when disabled.
> 
> Adds frontend scaffolding for a new visibility RPC `CountSchedules`
(client plumbing, interception/metadata/quota wiring) but leaves the
frontend handler unimplemented, and bumps `go.temporal.io/api` to
`v1.62.2`.
> 
> <sup>Written by [Cursor
Bugbot]() for commit
cb8ae14c86666654c51dd66ae91cb225722e1ba7. This will update automatically
on new commits. Configure
[here]().</sup>

---------

Co-authored-by: Shahab Tajik <[email protected]>
Co-authored-by: Shivam <[email protected]>
2026-03-17 17:19:47 -05:00

742 lines
28 KiB
Go

package respondworkflowtaskcompleted
import (
"context"
"errors"
"maps"
"testing"
"time"
"github.com/stretchr/testify/require"
"github.com/stretchr/testify/suite"
commandpb "go.temporal.io/api/command/v1"
enumspb "go.temporal.io/api/enums/v1"
historypb "go.temporal.io/api/history/v1"
protocolpb "go.temporal.io/api/protocol/v1"
querypb "go.temporal.io/api/query/v1"
"go.temporal.io/api/serviceerror"
updatepb "go.temporal.io/api/update/v1"
"go.temporal.io/api/workflowservice/v1"
enumsspb "go.temporal.io/server/api/enums/v1"
"go.temporal.io/server/api/historyservice/v1"
persistencespb "go.temporal.io/server/api/persistence/v1"
tokenspb "go.temporal.io/server/api/token/v1"
"go.temporal.io/server/common"
"go.temporal.io/server/common/clock"
"go.temporal.io/server/common/cluster"
"go.temporal.io/server/common/effect"
"go.temporal.io/server/common/locks"
"go.temporal.io/server/common/log"
"go.temporal.io/server/common/metrics"
"go.temporal.io/server/common/namespace"
"go.temporal.io/server/common/payloads"
"go.temporal.io/server/common/persistence"
"go.temporal.io/server/common/tasktoken"
"go.temporal.io/server/common/testing/historyrequire"
"go.temporal.io/server/common/testing/protorequire"
"go.temporal.io/server/common/testing/protoutils"
"go.temporal.io/server/common/testing/testvars"
"go.temporal.io/server/common/testing/updateutils"
"go.temporal.io/server/service/history/api"
"go.temporal.io/server/service/history/events"
"go.temporal.io/server/service/history/hsm"
historyi "go.temporal.io/server/service/history/interfaces"
"go.temporal.io/server/service/history/shard"
"go.temporal.io/server/service/history/tests"
"go.temporal.io/server/service/history/workflow"
wcache "go.temporal.io/server/service/history/workflow/cache"
"go.temporal.io/server/service/history/workflow/update"
"go.uber.org/mock/gomock"
)
type (
WorkflowTaskCompletedHandlerSuite struct {
suite.Suite
*require.Assertions
protorequire.ProtoAssertions
historyrequire.HistoryRequire
updateutils.UpdateUtils
controller *gomock.Controller
mockShard *shard.ContextTest
mockEventsCache *events.MockCache
mockExecutionMgr *persistence.MockExecutionManager
workflowCache wcache.Cache
mockNamespaceCache *namespace.MockRegistry
logger log.Logger
workflowTaskCompletedHandler *WorkflowTaskCompletedHandler
}
)
func TestWorkflowTaskCompletedHandlerSuite(t *testing.T) {
suite.Run(t, new(WorkflowTaskCompletedHandlerSuite))
}
func (s *WorkflowTaskCompletedHandlerSuite) SetupSubTest() {
s.Assertions = require.New(s.T())
s.ProtoAssertions = protorequire.New(s.T())
s.HistoryRequire = historyrequire.New(s.T())
s.UpdateUtils = updateutils.New(s.T())
s.controller = gomock.NewController(s.T())
config := tests.NewDynamicConfig()
s.mockShard = shard.NewTestContext(
s.controller,
&persistencespb.ShardInfo{
ShardId: 1,
RangeId: 1,
},
config,
)
reg := hsm.NewRegistry()
err := workflow.RegisterStateMachine(reg)
s.NoError(err)
s.mockShard.SetStateMachineRegistry(reg)
mockEngine := historyi.NewMockEngine(s.controller)
mockEngine.EXPECT().NotifyNewHistoryEvent(gomock.Any()).AnyTimes()
mockEngine.EXPECT().NotifyNewTasks(gomock.Any()).AnyTimes()
s.mockShard.SetEngineForTesting(mockEngine)
s.mockNamespaceCache = s.mockShard.Resource.NamespaceCache
s.mockExecutionMgr = s.mockShard.Resource.ExecutionMgr
s.mockShard.Resource.ShardMgr.EXPECT().UpdateShard(gomock.Any(), gomock.Any()).Return(nil).AnyTimes()
mockClusterMetadata := s.mockShard.Resource.ClusterMetadata
mockClusterMetadata.EXPECT().GetClusterID().Return(int64(1)).AnyTimes()
mockClusterMetadata.EXPECT().GetCurrentClusterName().Return(cluster.TestCurrentClusterName).AnyTimes()
mockClusterMetadata.EXPECT().ClusterNameForFailoverVersion(false, common.EmptyVersion).Return(cluster.TestCurrentClusterName).AnyTimes()
mockClusterMetadata.EXPECT().ClusterNameForFailoverVersion(true, tests.Version).Return(cluster.TestCurrentClusterName).AnyTimes()
mockClusterMetadata.EXPECT().GetAllClusterInfo().Return(nil).AnyTimes()
s.mockEventsCache = s.mockShard.MockEventsCache
s.mockEventsCache.EXPECT().PutEvent(gomock.Any(), gomock.Any()).AnyTimes()
s.logger = s.mockShard.GetLogger()
s.workflowCache = wcache.NewHostLevelCache(s.mockShard.GetConfig(), s.mockShard.GetLogger(), metrics.NoopMetricsHandler)
s.workflowTaskCompletedHandler = NewWorkflowTaskCompletedHandler(
s.mockShard,
tasktoken.NewSerializer(),
events.NewNotifier(clock.NewRealTimeSource(), metrics.NoopMetricsHandler, func(namespace.ID, string) int32 { return 1 }),
nil,
nil,
nil,
api.NewWorkflowConsistencyChecker(s.mockShard, s.workflowCache),
nil,
nil)
}
func (s *WorkflowTaskCompletedHandlerSuite) TearDownTest() {
s.controller.Finish()
}
func (s *WorkflowTaskCompletedHandlerSuite) TestUpdateWorkflow() {
createWrittenHistoryCh := func(expectedUpdateWorkflowExecutionCalls int) <-chan []*historypb.HistoryEvent {
writtenHistoryCh := make(chan []*historypb.HistoryEvent, expectedUpdateWorkflowExecutionCalls)
s.mockExecutionMgr.EXPECT().UpdateWorkflowExecution(gomock.Any(), gomock.Any()).DoAndReturn(func(_ context.Context, request *persistence.UpdateWorkflowExecutionRequest) (*persistence.UpdateWorkflowExecutionResponse, error) {
var wfEvents []*persistence.WorkflowEvents
if len(request.UpdateWorkflowEvents) > 0 {
wfEvents = request.UpdateWorkflowEvents
} else {
wfEvents = request.NewWorkflowEvents
}
var historyEvents []*historypb.HistoryEvent
for _, uwe := range wfEvents {
for _, event := range uwe.Events {
historyEvents = append(historyEvents, event)
}
}
writtenHistoryCh <- historyEvents
return tests.UpdateWorkflowExecutionResponse, nil
}).Times(expectedUpdateWorkflowExecutionCalls)
return writtenHistoryCh
}
s.Run("Accept Complete", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
writtenHistoryCh := createWrittenHistoryCh(1)
_, err := wfContext.LoadMutableState(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
_, err = s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Commands: s.UpdateAcceptCompleteCommands(tv),
Messages: s.UpdateAcceptCompleteMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
},
})
s.NoError(err)
updStatus, err := upd.WaitLifecycleStage(context.Background(), enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_UNSPECIFIED, time.Duration(0))
s.NoError(err)
s.Equal(enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED.String(), updStatus.Stage.String())
s.ProtoEqual(payloads.EncodeString("success-result-of-"+tv.UpdateID()), updStatus.Outcome.GetSuccess())
s.EqualHistoryEvents(`
2 WorkflowTaskScheduled // Speculative WFT events are persisted on WFT completion.
3 WorkflowTaskStarted // Speculative WFT events are persisted on WFT completion.
4 WorkflowTaskCompleted
5 WorkflowExecutionUpdateAccepted
6 WorkflowExecutionUpdateCompleted`, <-writtenHistoryCh)
})
s.Run("Reject", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
_, err := s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Messages: s.UpdateRejectMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
},
})
s.NoError(err)
updStatus, err := upd.WaitLifecycleStage(context.Background(), enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_UNSPECIFIED, time.Duration(0))
s.NoError(err)
s.Equal(enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED.String(), updStatus.Stage.String())
s.Equal("rejection-of-"+tv.UpdateID(), updStatus.Outcome.GetFailure().GetMessage())
})
s.Run("Write failed on normal task queue", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
writeErr := errors.New("write failed")
s.mockExecutionMgr.EXPECT().UpdateWorkflowExecution(gomock.Any(), gomock.Any()).Return(nil, writeErr)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
_, err := s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Commands: s.UpdateAcceptCompleteCommands(tv),
Messages: s.UpdateAcceptCompleteMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
},
})
s.ErrorIs(err, writeErr)
s.Nil(wfContext.(*workflow.ContextImpl).MutableState, "mutable state must be cleared")
})
s.Run("Write failed on sticky task queue", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
writeErr := serviceerror.NewResourceExhausted(enumspb.RESOURCE_EXHAUSTED_CAUSE_PERSISTENCE_STORAGE_LIMIT, "write failed")
// First write of MS
s.mockExecutionMgr.EXPECT().UpdateWorkflowExecution(gomock.Any(), gomock.Any()).Return(nil, writeErr)
// Second write of MS to clear stickiness
s.mockExecutionMgr.EXPECT().UpdateWorkflowExecution(gomock.Any(), gomock.Any()).Return(tests.UpdateWorkflowExecutionResponse, nil)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
_, err := s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Commands: s.UpdateAcceptCompleteCommands(tv),
Messages: s.UpdateAcceptCompleteMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
StickyAttributes: tv.StickyExecutionAttributes(tv.Any().InfiniteTimeout().AsDuration()),
},
})
s.ErrorIs(err, writeErr)
s.Nil(wfContext.(*workflow.ContextImpl).MutableState, "mutable state must be cleared")
})
s.Run("GetHistory failed", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
s.mockNamespaceCache.EXPECT().GetNamespaceName(tv.NamespaceID()).Return(tv.NamespaceName(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
writtenHistoryCh := createWrittenHistoryCh(1)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
readHistoryErr := errors.New("get history failed")
s.mockExecutionMgr.EXPECT().ReadHistoryBranch(gomock.Any(), gomock.Any()).Return(nil, readHistoryErr)
_, err := s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Commands: s.UpdateAcceptCompleteCommands(tv),
Messages: s.UpdateAcceptCompleteMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
ReturnNewWorkflowTask: true,
ForceCreateNewWorkflowTask: true,
},
})
s.ErrorIs(err, readHistoryErr)
updStatus, err := upd.WaitLifecycleStage(context.Background(), enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_UNSPECIFIED, time.Duration(0))
s.NoError(err)
s.Equal(enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED.String(), updStatus.Stage.String())
s.ProtoEqual(payloads.EncodeString("success-result-of-"+tv.UpdateID()), updStatus.Outcome.GetSuccess())
s.EqualHistoryEvents(`
2 WorkflowTaskScheduled // Speculative WFT events are persisted on WFT completion.
3 WorkflowTaskStarted // Speculative WFT events are persisted on WFT completion.
4 WorkflowTaskCompleted
5 WorkflowExecutionUpdateAccepted
6 WorkflowExecutionUpdateCompleted
7 WorkflowTaskScheduled
8 WorkflowTaskStarted`, <-writtenHistoryCh)
})
s.Run("Discard speculative WFT with events", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
// Expect only 2 calls to UpdateWorkflowExecution: for timer started and timer fired events but not Update or WFT events.
writtenHistoryCh := createWrittenHistoryCh(2)
ms, err := wfContext.LoadMutableState(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
_, _, err = ms.AddTimerStartedEvent(
1,
&commandpb.StartTimerCommandAttributes{
TimerId: tv.TimerID(),
StartToFireTimeout: tv.Any().InfiniteTimeout(),
},
)
s.NoError(err)
err = wfContext.UpdateWorkflowExecutionAsActive(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
s.EqualHistoryEvents(`
2 TimerStarted
`, <-writtenHistoryCh)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
_, err = s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Messages: s.UpdateRejectMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
Capabilities: &workflowservice.RespondWorkflowTaskCompletedRequest_Capabilities{
DiscardSpeculativeWorkflowTaskWithEvents: true,
},
},
})
s.NoError(err)
updStatus, err := upd.WaitLifecycleStage(context.Background(), enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_UNSPECIFIED, time.Duration(0))
s.NoError(err)
s.Equal(enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED.String(), updStatus.Stage.String())
s.Equal("rejection-of-"+tv.UpdateID(), updStatus.Outcome.GetFailure().GetMessage())
ms, err = wfContext.LoadMutableState(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
_, err = ms.AddTimerFiredEvent(tv.TimerID())
s.NoError(err)
err = wfContext.UpdateWorkflowExecutionAsActive(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
s.EqualHistoryEvents(`
3 TimerFired // No WFT events in between 2 and 3.
`, <-writtenHistoryCh)
})
s.Run("Do not discard speculative WFT with more than 10 events", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext := s.createStartedWorkflow(tv)
// Expect 2 calls to UpdateWorkflowExecution: for timer started and WFT events.
writtenHistoryCh := createWrittenHistoryCh(2)
ms, err := wfContext.LoadMutableState(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
for i := 0; i < 11; i++ {
_, _, err = ms.AddTimerStartedEvent(
1,
&commandpb.StartTimerCommandAttributes{
TimerId: tv.WithTimerIDNumber(i).TimerID(),
StartToFireTimeout: tv.Any().InfiniteTimeout(),
},
)
s.NoError(err)
}
err = wfContext.UpdateWorkflowExecutionAsActive(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
s.EqualHistoryEvents(`
2 TimerStarted
3 TimerStarted
4 TimerStarted
5 TimerStarted
6 TimerStarted
7 TimerStarted
8 TimerStarted
9 TimerStarted
10 TimerStarted
11 TimerStarted
12 TimerStarted
`, <-writtenHistoryCh)
updRequestMsg, upd, serializedTaskToken := s.createSentUpdate(tv, wfContext)
s.NotNil(upd)
_, err = s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Messages: s.UpdateRejectMessages(tv, updRequestMsg),
Identity: tv.Any().String(),
Capabilities: &workflowservice.RespondWorkflowTaskCompletedRequest_Capabilities{
DiscardSpeculativeWorkflowTaskWithEvents: true,
},
},
})
s.NoError(err)
updStatus, err := upd.WaitLifecycleStage(context.Background(), enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_UNSPECIFIED, time.Duration(0))
s.NoError(err)
s.Equal(enumspb.UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED.String(), updStatus.Stage.String())
s.Equal("rejection-of-"+tv.UpdateID(), updStatus.Outcome.GetFailure().GetMessage())
s.EqualHistoryEvents(`
13 WorkflowTaskScheduled // WFT events were created even if it was a rejection (because number of events > 10).
14 WorkflowTaskStarted
15 WorkflowTaskCompleted
`, <-writtenHistoryCh)
})
}
func (s *WorkflowTaskCompletedHandlerSuite) TestForceCreateNewWorkflowTaskOnPausedWorkflow() {
s.Run("Returns error when workflow is paused and ForceCreateNewWorkflowTask is true", func() {
tv := testvars.New(s.T())
tv = tv.WithRunID(tv.Any().RunID())
s.mockNamespaceCache.EXPECT().GetNamespaceByID(tv.NamespaceID()).Return(tv.Namespace(), nil).AnyTimes()
wfContext, serializedTaskToken := s.createPausedWorkflowWithWFT(tv)
ms, err := wfContext.LoadMutableState(context.Background(), s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
s.True(ms.IsWorkflowExecutionStatusPaused())
_, err = s.workflowTaskCompletedHandler.Invoke(context.Background(), &historyservice.RespondWorkflowTaskCompletedRequest{
NamespaceId: tv.NamespaceID().String(),
CompleteRequest: &workflowservice.RespondWorkflowTaskCompletedRequest{
TaskToken: serializedTaskToken,
Identity: tv.Any().String(),
ForceCreateNewWorkflowTask: true,
},
})
s.Error(err)
var failedPrecondition *serviceerror.FailedPrecondition
s.ErrorAs(err, &failedPrecondition)
s.Contains(err.Error(), "Workflow is paused and force create new workflow task is not allowed")
})
}
func (s *WorkflowTaskCompletedHandlerSuite) TestHandleBufferedQueries() {
constructQueryResults := func(ids []string, resultSize int) map[string]*querypb.WorkflowQueryResult {
results := make(map[string]*querypb.WorkflowQueryResult)
for _, id := range ids {
results[id] = &querypb.WorkflowQueryResult{
ResultType: enumspb.QUERY_RESULT_TYPE_ANSWERED,
Answer: payloads.EncodeBytes(make([]byte, resultSize)),
}
}
return results
}
constructQueryRegistry := func(numQueries int) historyi.QueryRegistry {
queryRegistry := workflow.NewQueryRegistry()
for i := 0; i < numQueries; i++ {
queryRegistry.BufferQuery(&querypb.WorkflowQuery{})
}
return queryRegistry
}
assertQueryCounts := func(queryRegistry historyi.QueryRegistry, buffered, completed, unblocked, failed int) {
s.Len(queryRegistry.GetBufferedIDs(), buffered)
s.Len(queryRegistry.GetCompletedIDs(), completed)
s.Len(queryRegistry.GetUnblockedIDs(), unblocked)
s.Len(queryRegistry.GetFailedIDs(), failed)
}
setupBufferedQueriesMocks := func() (historyi.QueryRegistry, *historyi.MockMutableState) {
queryRegistry := constructQueryRegistry(10)
mockMutableState := historyi.NewMockMutableState(s.controller)
mockMutableState.EXPECT().GetQueryRegistry().Return(queryRegistry)
mockMutableState.EXPECT().GetExecutionInfo().Return(&persistencespb.WorkflowExecutionInfo{
WorkflowId: tests.WorkflowID,
}).AnyTimes()
mockMutableState.EXPECT().GetExecutionState().Return(&persistencespb.WorkflowExecutionState{
RunId: tests.RunID,
}).AnyTimes()
return queryRegistry, mockMutableState
}
s.Run("New WorkflowTask", func() {
queryRegistry, mockMutableState := setupBufferedQueriesMocks()
assertQueryCounts(queryRegistry, 10, 0, 0, 0)
queryResults := constructQueryResults(queryRegistry.GetBufferedIDs()[0:5], 10)
s.workflowTaskCompletedHandler.handleBufferedQueries(mockMutableState, queryResults, true, tests.GlobalNamespaceEntry)
assertQueryCounts(queryRegistry, 5, 5, 0, 0)
})
s.Run("No New WorkflowTask", func() {
queryRegistry, mockMutableState := setupBufferedQueriesMocks()
assertQueryCounts(queryRegistry, 10, 0, 0, 0)
queryResults := constructQueryResults(queryRegistry.GetBufferedIDs()[0:5], 10)
s.workflowTaskCompletedHandler.handleBufferedQueries(mockMutableState, queryResults, false, tests.GlobalNamespaceEntry)
assertQueryCounts(queryRegistry, 0, 5, 5, 0)
})
s.Run("Query Too Large", func() {
queryRegistry, mockMutableState := setupBufferedQueriesMocks()
assertQueryCounts(queryRegistry, 10, 0, 0, 0)
bufferedIDs := queryRegistry.GetBufferedIDs()
queryResults := constructQueryResults(bufferedIDs[0:5], 10)
largeQueryResults := constructQueryResults(bufferedIDs[5:10], 10*1024*1024)
maps.Copy(queryResults, largeQueryResults)
s.workflowTaskCompletedHandler.handleBufferedQueries(mockMutableState, queryResults, false, tests.GlobalNamespaceEntry)
assertQueryCounts(queryRegistry, 0, 5, 0, 5)
})
}
func (s *WorkflowTaskCompletedHandlerSuite) createStartedWorkflow(tv *testvars.TestVars) historyi.WorkflowContext {
ms := workflow.TestLocalMutableState(s.workflowTaskCompletedHandler.shardContext, s.mockEventsCache, tv.Namespace(),
tv.WorkflowID(), tv.RunID(), log.NewTestLogger())
startRequest := &workflowservice.StartWorkflowExecutionRequest{
WorkflowId: tv.WorkflowID(),
WorkflowType: tv.WorkflowType(),
TaskQueue: tv.TaskQueue(),
Input: tv.Any().Payloads(),
WorkflowExecutionTimeout: tv.Any().InfiniteTimeout(),
WorkflowRunTimeout: tv.Any().InfiniteTimeout(),
WorkflowTaskTimeout: tv.Any().InfiniteTimeout(),
Identity: tv.ClientIdentity(),
}
_, _ = ms.AddWorkflowExecutionStartedEvent(
tv.WorkflowExecution(),
&historyservice.StartWorkflowExecutionRequest{
Attempt: 1,
NamespaceId: tv.NamespaceID().String(),
StartRequest: startRequest,
ParentExecutionInfo: nil,
},
)
s.mockExecutionMgr.EXPECT().GetWorkflowExecution(gomock.Any(), gomock.Any()).DoAndReturn(
func(ctx context.Context, request *persistence.GetWorkflowExecutionRequest) (*persistence.GetWorkflowExecutionResponse, error) {
return &persistence.GetWorkflowExecutionResponse{State: workflow.TestCloneToProto(ctx, ms)}, nil
}).AnyTimes()
// Create WF context in the cache and load MS for it.
wfContext, release, err := s.workflowCache.GetOrCreateWorkflowExecution(
metrics.AddMetricsContext(context.Background()),
s.mockShard,
tv.NamespaceID(),
tv.WorkflowExecution(),
locks.PriorityHigh,
)
s.NoError(err)
s.NotNil(wfContext)
loadedMS, err := wfContext.LoadMutableState(context.Background(), s.mockShard)
s.NoError(err)
s.NotNil(loadedMS)
release(nil)
return wfContext
}
func (s *WorkflowTaskCompletedHandlerSuite) createSentUpdate(tv *testvars.TestVars, wfContext historyi.WorkflowContext) (*protocolpb.Message, *update.Update, []byte) {
ctx := context.Background()
ms, err := wfContext.LoadMutableState(ctx, s.workflowTaskCompletedHandler.shardContext)
s.NoError(err)
// 1. Create speculative WFT for update.
wt, _ := ms.AddWorkflowTaskScheduledEvent(false, enumsspb.WORKFLOW_TASK_TYPE_SPECULATIVE)
_, _, _ = ms.AddWorkflowTaskStartedEvent(
wt.ScheduledEventID,
tv.RunID(),
tv.StickyTaskQueue(),
tv.Any().String(),
nil,
nil,
nil,
false,
nil,
)
taskToken := &tokenspb.Task{
Attempt: 1,
NamespaceId: tv.NamespaceID().String(),
WorkflowId: tv.WorkflowID(),
RunId: tv.RunID(),
ScheduledEventId: wt.ScheduledEventID,
}
serializedTaskToken, err := taskToken.Marshal()
s.NoError(err)
// 2. Create update.
upd, alreadyExisted, err := wfContext.UpdateRegistry(ctx).FindOrCreate(ctx, tv.UpdateID())
s.False(alreadyExisted)
s.NoError(err)
updReq := &updatepb.Request{
Meta: &updatepb.Meta{UpdateId: tv.UpdateID()},
Input: &updatepb.Input{
Name: tv.HandlerName(),
Args: payloads.EncodeString("args-value-of-" + tv.UpdateID()),
}}
eventStore := workflow.WithEffects(effect.Immediate(ctx), ms)
err = upd.Admit(updReq, eventStore)
s.NoError(err)
seqID := &protocolpb.Message_EventId{EventId: tv.Any().EventID()}
msg := upd.Send(false, seqID)
s.NotNil(msg)
updRequestMsg := &protocolpb.Message{
Id: tv.Any().String(),
ProtocolInstanceId: tv.UpdateID(),
SequencingId: seqID,
Body: protoutils.MarshalAny(s.T(), updReq),
}
return updRequestMsg, upd, serializedTaskToken
}
func (s *WorkflowTaskCompletedHandlerSuite) createPausedWorkflowWithWFT(tv *testvars.TestVars) (historyi.WorkflowContext, []byte) {
ms := workflow.TestLocalMutableState(s.workflowTaskCompletedHandler.shardContext, s.mockEventsCache, tv.Namespace(),
tv.WorkflowID(), tv.RunID(), log.NewTestLogger())
startRequest := &workflowservice.StartWorkflowExecutionRequest{
WorkflowId: tv.WorkflowID(),
WorkflowType: tv.WorkflowType(),
TaskQueue: tv.TaskQueue(),
Input: tv.Any().Payloads(),
WorkflowExecutionTimeout: tv.Any().InfiniteTimeout(),
WorkflowRunTimeout: tv.Any().InfiniteTimeout(),
WorkflowTaskTimeout: tv.Any().InfiniteTimeout(),
Identity: tv.ClientIdentity(),
}
_, _ = ms.AddWorkflowExecutionStartedEvent(
tv.WorkflowExecution(),
&historyservice.StartWorkflowExecutionRequest{
Attempt: 1,
NamespaceId: tv.NamespaceID().String(),
StartRequest: startRequest,
ParentExecutionInfo: nil,
},
)
// Complete the first workflow task to transition state to Running.
wt, _ := ms.AddWorkflowTaskScheduledEvent(false, enumsspb.WORKFLOW_TASK_TYPE_NORMAL)
_, _, _ = ms.AddWorkflowTaskStartedEvent(
wt.ScheduledEventID,
tv.RunID(),
tv.TaskQueue(),
tv.Any().String(),
nil,
nil,
nil,
false,
nil,
)
_, _ = ms.AddWorkflowTaskCompletedEvent(wt, &workflowservice.RespondWorkflowTaskCompletedRequest{
Identity: tv.Any().String(),
}, historyi.WorkflowTaskCompletionLimits{MaxResetPoints: 10, MaxSearchAttributeValueSize: 2048})
// Add a speculative WFT before pausing.
wt2, _ := ms.AddWorkflowTaskScheduledEvent(false, enumsspb.WORKFLOW_TASK_TYPE_SPECULATIVE)
_, _, _ = ms.AddWorkflowTaskStartedEvent(
wt2.ScheduledEventID,
tv.RunID(),
tv.StickyTaskQueue(),
tv.Any().String(),
nil,
nil,
nil,
false,
nil,
)
taskToken := &tokenspb.Task{
Attempt: 1,
NamespaceId: tv.NamespaceID().String(),
WorkflowId: tv.WorkflowID(),
RunId: tv.RunID(),
ScheduledEventId: wt2.ScheduledEventID,
}
serializedTaskToken, err := taskToken.Marshal()
s.NoError(err)
// Pause the workflow
_, err = ms.AddWorkflowExecutionPausedEvent("test-identity", "test-reason", tv.Any().String())
s.NoError(err)
s.True(ms.IsWorkflowExecutionStatusPaused())
ms.FlushBufferedEvents()
s.mockExecutionMgr.EXPECT().GetWorkflowExecution(gomock.Any(), gomock.Any()).DoAndReturn(
func(ctx context.Context, request *persistence.GetWorkflowExecutionRequest) (*persistence.GetWorkflowExecutionResponse, error) {
return &persistence.GetWorkflowExecutionResponse{State: workflow.TestCloneToProto(context.Background(), ms)}, nil
}).AnyTimes()
wfContext, release, err := s.workflowCache.GetOrCreateWorkflowExecution(
metrics.AddMetricsContext(context.Background()),
s.mockShard,
tv.NamespaceID(),
tv.WorkflowExecution(),
locks.PriorityHigh,
)
s.NoError(err)
s.NotNil(wfContext)
loadedMS, err := wfContext.LoadMutableState(context.Background(), s.mockShard)
s.NoError(err)
s.NotNil(loadedMS)
release(nil)
return wfContext, serializedTaskToken
}