Files
tasks/tests/workflow_delete_execution.go
Stephan BehnkeandGitHub e0c1ec646d Rename "engine" to "client" in tests (#6232)
## What changed?
<!-- Describe what has changed in this PR -->

Renamed fields of type `FrontendClient` from `engine` to `client`.

PS: using `frontendClient` seemed unnecessarily specific/verbose

## Why?
<!-- Tell your future self why have you made these changes -->

There is a `shard.Engine` and `matching.Engine` etc. which makes using
this identifier for a frontend client misleading. Due to its name, more
than once have I thought that a History Service test was calling the
History Service directly, only to learn/remember that it's actually
going through the Frontend Service.

## How did you test it?
<!-- How have you verified this change? Tested locally? Added a unit
test? Checked in staging env? -->

Only touches tests. Refactoring was done via IDE.

## Potential risks
<!-- Assuming the worst case, what can be broken when deploying this
change to production? -->

## Documentation
<!-- Have you made sure this change doesn't falsify anything currently
stated in `docs/`? If significant
new behavior is added, have you described that in `docs/`? -->

## Is hotfix candidate?
<!-- Is this PR a hotfix candidate or does it require a notification to
be sent to the broader community? (Yes/No) -->
2024-07-06 00:02:42 +00:00

441 lines
14 KiB
Go

// The MIT License
//
// Copyright (c) 2020 Temporal Technologies Inc. All rights reserved.
//
// Copyright (c) 2020 Uber Technologies, Inc.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
package tests
import (
"fmt"
"strconv"
"time"
"github.com/pborman/uuid"
commandpb "go.temporal.io/api/command/v1"
commonpb "go.temporal.io/api/common/v1"
enumspb "go.temporal.io/api/enums/v1"
"go.temporal.io/api/serviceerror"
"go.temporal.io/api/workflowservice/v1"
"go.temporal.io/server/common/log/tag"
"go.temporal.io/server/common/testing/testvars"
)
const (
// Internal task processing for DeleteExecutionTask checks if there is no pending CloseExecutionTask
// comparing ack levels of the last processed task and DeleteExecutionTask TaskID.
// Queue states/ack levels are updated with delay from "history.transferProcessorUpdateAckInterval"
// which default 30s, but it is overridden in tests to 1s (see overrideHistoryDynamicConfig in onebox.go).
// With few executions closed and deleted in parallel, it is hard to predict time needed for every DeleteExecutionTask
// to process. Set it to 20s here, as minimum sufficient interval. Increase it, if tests in this file are failing with
// "Condition never satisfied" error.
waitForTaskProcessing = 20 * time.Second
)
func (s *FunctionalSuite) TestDeleteWorkflowExecution_CompetedWorkflow() {
tv := testvars.New(s.T())
const numExecutions = 5
var wes []*commonpb.WorkflowExecution
// Start numExecutions workflow executions.
for i := 0; i < numExecutions; i++ {
we, err := s.client.StartWorkflowExecution(NewContext(), &workflowservice.StartWorkflowExecutionRequest{
RequestId: uuid.New(),
Namespace: s.namespace,
WorkflowId: tv.WorkflowID(strconv.Itoa(i)),
WorkflowType: tv.WorkflowType(),
TaskQueue: tv.TaskQueue(),
Identity: tv.WorkerIdentity(),
})
s.NoError(err)
wes = append(wes, &commonpb.WorkflowExecution{
WorkflowId: tv.WorkflowID(strconv.Itoa(i)),
RunId: we.RunId,
})
}
// Complete workflow.
wtHandler := func(task *workflowservice.PollWorkflowTaskQueueResponse) ([]*commandpb.Command, error) {
return []*commandpb.Command{{
CommandType: enumspb.COMMAND_TYPE_COMPLETE_WORKFLOW_EXECUTION,
Attributes: &commandpb.Command_CompleteWorkflowExecutionCommandAttributes{CompleteWorkflowExecutionCommandAttributes: &commandpb.CompleteWorkflowExecutionCommandAttributes{}},
}}, nil
}
poller := &TaskPoller{
Client: s.client,
Namespace: s.namespace,
TaskQueue: tv.TaskQueue(),
Identity: tv.WorkerIdentity(),
WorkflowTaskHandler: wtHandler,
Logger: s.Logger,
T: s.T(),
}
for range wes {
_, err := poller.PollAndProcessWorkflowTask()
s.NoError(err)
}
// Verify that workflow is completed and visibility is updated.
for _, we := range wes {
s.Eventually(
func() bool {
visibilityResponse, err := s.client.ListWorkflowExecutions(
NewContext(),
&workflowservice.ListWorkflowExecutionsRequest{
Namespace: s.namespace,
PageSize: 1,
NextPageToken: nil,
Query: fmt.Sprintf("WorkflowId='%s'", we.WorkflowId),
},
)
s.NoError(err)
if len(visibilityResponse.Executions) == 1 &&
visibilityResponse.Executions[0].Status == enumspb.WORKFLOW_EXECUTION_STATUS_COMPLETED {
return true
}
return false
},
waitForESToSettle,
100*time.Millisecond,
)
}
// Delete workflow executions.
for _, we := range wes {
_, err := s.client.DeleteWorkflowExecution(NewContext(), &workflowservice.DeleteWorkflowExecutionRequest{
Namespace: s.namespace,
WorkflowExecution: &commonpb.WorkflowExecution{
WorkflowId: we.WorkflowId,
RunId: we.RunId,
},
})
s.NoError(err)
}
for i, we := range wes {
s.Eventually(
func() bool {
// Check execution is deleted.
describeResponse, err := s.client.DescribeWorkflowExecution(
NewContext(),
&workflowservice.DescribeWorkflowExecutionRequest{
Namespace: s.namespace,
Execution: we,
},
)
if err == nil {
s.Logger.Warn("Execution is not deleted yet", tag.NewInt("number", i), tag.WorkflowID(we.WorkflowId), tag.WorkflowRunID(we.RunId))
return false
}
var notFoundErr *serviceerror.NotFound
s.ErrorAs(err, &notFoundErr)
s.Nil(describeResponse)
return true
},
waitForTaskProcessing,
100*time.Millisecond,
)
// Check history is deleted.
historyResponse, err := s.client.GetWorkflowExecutionHistory(
NewContext(),
&workflowservice.GetWorkflowExecutionHistoryRequest{
Namespace: s.namespace,
Execution: we,
},
)
var invalidArgumentErr *serviceerror.InvalidArgument
s.ErrorAs(err, &invalidArgumentErr)
s.Nil(historyResponse)
s.Eventually(
func() bool {
// Check visibility is updated.
visibilityResponse, err := s.client.ListWorkflowExecutions(
NewContext(),
&workflowservice.ListWorkflowExecutionsRequest{
Namespace: s.namespace,
PageSize: 1,
NextPageToken: nil,
Query: fmt.Sprintf("WorkflowId='%s'", we.WorkflowId),
},
)
s.NoError(err)
if len(visibilityResponse.Executions) != 0 {
s.Logger.Warn("Visibility is not deleted yet")
return false
}
return true
},
waitForESToSettle,
100*time.Millisecond,
)
}
}
func (s *FunctionalSuite) TestDeleteWorkflowExecution_RunningWorkflow() {
tv := testvars.New(s.T())
const numExecutions = 5
var wes []*commonpb.WorkflowExecution
// Start numExecutions workflow executions.
for i := 0; i < numExecutions; i++ {
we, err := s.client.StartWorkflowExecution(NewContext(), &workflowservice.StartWorkflowExecutionRequest{
RequestId: uuid.New(),
Namespace: s.namespace,
WorkflowId: tv.WorkflowID(strconv.Itoa(i)),
WorkflowType: tv.WorkflowType(),
TaskQueue: tv.TaskQueue(),
Identity: tv.WorkerIdentity(),
})
s.NoError(err)
wes = append(wes, &commonpb.WorkflowExecution{
WorkflowId: tv.WorkflowID(strconv.Itoa(i)),
RunId: we.RunId,
})
}
// Verify that workflow is running and visibility is updated.
for _, we := range wes {
s.Eventually(
func() bool {
visibilityResponse, err := s.client.ListWorkflowExecutions(
NewContext(),
&workflowservice.ListWorkflowExecutionsRequest{
Namespace: s.namespace,
PageSize: 1,
NextPageToken: nil,
Query: fmt.Sprintf("WorkflowId='%s'", we.WorkflowId),
},
)
s.NoError(err)
return len(visibilityResponse.Executions) == 1 &&
visibilityResponse.Executions[0].Status == enumspb.WORKFLOW_EXECUTION_STATUS_RUNNING
},
waitForESToSettle,
100*time.Millisecond,
)
}
// Delete workflow executions.
for _, we := range wes {
_, err := s.client.DeleteWorkflowExecution(NewContext(), &workflowservice.DeleteWorkflowExecutionRequest{
Namespace: s.namespace,
WorkflowExecution: we,
})
s.NoError(err)
}
for i, we := range wes {
s.Eventually(
func() bool {
// Check execution is deleted.
describeResponse, err := s.client.DescribeWorkflowExecution(
NewContext(),
&workflowservice.DescribeWorkflowExecutionRequest{
Namespace: s.namespace,
Execution: we,
},
)
if err == nil {
s.Logger.Warn("Execution is not deleted yet", tag.NewInt("number", i), tag.WorkflowID(we.WorkflowId), tag.WorkflowRunID(we.RunId))
return false
}
var notFoundErr *serviceerror.NotFound
s.ErrorAs(err, &notFoundErr)
s.Nil(describeResponse)
return true
},
waitForTaskProcessing,
100*time.Millisecond,
)
// Check history is deleted.
historyResponse, err := s.client.GetWorkflowExecutionHistory(
NewContext(),
&workflowservice.GetWorkflowExecutionHistoryRequest{
Namespace: s.namespace,
Execution: we,
},
)
var invalidArgumentErr *serviceerror.InvalidArgument
s.ErrorAs(err, &invalidArgumentErr)
s.Nil(historyResponse)
s.Eventually(
func() bool {
// Check visibility is updated.
visibilityResponse, err := s.client.ListWorkflowExecutions(
NewContext(),
&workflowservice.ListWorkflowExecutionsRequest{
Namespace: s.namespace,
PageSize: 1,
NextPageToken: nil,
Query: fmt.Sprintf("WorkflowId='%s'", we.WorkflowId),
},
)
s.NoError(err)
if len(visibilityResponse.Executions) != 0 {
s.Logger.Warn("Visibility is not deleted yet")
return false
}
return true
},
waitForESToSettle,
100*time.Millisecond,
)
}
}
func (s *FunctionalSuite) TestDeleteWorkflowExecution_JustTerminatedWorkflow() {
tv := testvars.New(s.T())
const numExecutions = 3
var wes []*commonpb.WorkflowExecution
// Start numExecutions workflow executions.
for i := 0; i < numExecutions; i++ {
we, err := s.client.StartWorkflowExecution(NewContext(), &workflowservice.StartWorkflowExecutionRequest{
RequestId: uuid.New(),
Namespace: s.namespace,
WorkflowId: tv.WorkflowID(strconv.Itoa(i)),
WorkflowType: tv.WorkflowType(),
TaskQueue: tv.TaskQueue(),
Identity: tv.WorkerIdentity(),
})
s.NoError(err)
wes = append(wes, &commonpb.WorkflowExecution{
WorkflowId: tv.WorkflowID(strconv.Itoa(i)),
RunId: we.RunId,
})
}
// Verify that workflow is running and visibility is updated.
for _, we := range wes {
s.Eventually(
func() bool {
visibilityResponse, err := s.client.ListWorkflowExecutions(
NewContext(),
&workflowservice.ListWorkflowExecutionsRequest{
Namespace: s.namespace,
PageSize: 1,
NextPageToken: nil,
Query: fmt.Sprintf("WorkflowId='%s'", we.WorkflowId),
},
)
s.NoError(err)
return len(visibilityResponse.Executions) == 1 &&
visibilityResponse.Executions[0].Status == enumspb.WORKFLOW_EXECUTION_STATUS_RUNNING
},
waitForESToSettle,
100*time.Millisecond,
)
}
// Internal task processing for DeleteExecutionTask checks if there is no pending CloseExecutionTask
// to make sure that the workflow is closed successfully before deleting it. Otherwise, the mutable state
// might be deleted before the close task is executed, and so the close task will be dropped.
// See comment about ensureNoPendingCloseTask in transferQueueTaskExecutorBase.deleteExecution() for more details.
// This is why this test _terminates_ and _immediately deletes_ workflow execution to simulate race between
// two types of tasks and make sure that they are executed in correct order.
for i, we := range wes {
_, err := s.client.TerminateWorkflowExecution(NewContext(), &workflowservice.TerminateWorkflowExecutionRequest{
Namespace: s.namespace,
WorkflowExecution: we,
})
s.NoError(err)
s.Logger.Warn("Execution is terminated", tag.NewInt("number", i), tag.WorkflowID(we.WorkflowId), tag.WorkflowRunID(we.RunId))
_, err = s.client.DeleteWorkflowExecution(NewContext(), &workflowservice.DeleteWorkflowExecutionRequest{
Namespace: s.namespace,
WorkflowExecution: we,
})
s.NoError(err)
s.Logger.Warn("Execution is scheduled for deletion", tag.NewInt("number", i), tag.WorkflowID(we.WorkflowId), tag.WorkflowRunID(we.RunId))
}
for i, we := range wes {
s.Eventually(
func() bool {
// Check execution is deleted.
describeResponse, err := s.client.DescribeWorkflowExecution(
NewContext(),
&workflowservice.DescribeWorkflowExecutionRequest{
Namespace: s.namespace,
Execution: we,
},
)
if err == nil {
s.Logger.Warn("Execution is not deleted yet", tag.NewInt("number", i), tag.WorkflowID(we.WorkflowId), tag.WorkflowRunID(we.RunId))
return false
}
var notFoundErr *serviceerror.NotFound
s.ErrorAs(err, &notFoundErr)
s.Nil(describeResponse)
return true
},
waitForTaskProcessing,
1*time.Second,
)
// Check history is deleted.
historyResponse, err := s.client.GetWorkflowExecutionHistory(
NewContext(),
&workflowservice.GetWorkflowExecutionHistoryRequest{
Namespace: s.namespace,
Execution: we,
},
)
var invalidArgumentErr *serviceerror.InvalidArgument
s.ErrorAs(err, &invalidArgumentErr)
s.Nil(historyResponse)
s.Eventually(
func() bool {
// Check visibility is updated.
visibilityResponse, err := s.client.ListWorkflowExecutions(
NewContext(),
&workflowservice.ListWorkflowExecutionsRequest{
Namespace: s.namespace,
PageSize: 1,
NextPageToken: nil,
Query: fmt.Sprintf("WorkflowId='%s'", we.WorkflowId),
},
)
s.NoError(err)
if len(visibilityResponse.Executions) != 0 {
s.Logger.Warn("Visibility is not deleted yet", tag.NewInt("number", i), tag.WorkflowID(we.WorkflowId), tag.WorkflowRunID(we.RunId))
return false
}
return true
},
waitForESToSettle,
100*time.Millisecond,
)
}
}