You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/migration-to-unversioned.md
+5-24Lines changed: 5 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Migrating from Versioned to Unversioned Workflows
2
2
3
-
This guide walks you through reverting from versioned workflows back to unversioned Temporal Workflows. It assumes you have enabled worker versioning and currently have (or previously had) versioned workers polling the Temporal Server.
3
+
This guide walks you through reverting from versioned workers to unversioned workers. It assumes you have enabled worker versioning and currently have (or previously had) versioned workers polling the Temporal Server.
Look for pollers with an `UNVERSIONED` Build ID in the output.
79
-
69
+
Deploy your unversioned workers, using a manner of your choice, and ensure they are polling all of the Task Queues in your Worker Deployment. This can be done by verifying their presence on the Task Queues page (https://cloud.temporal.io/namespaces/<your-namespace>/task-queues/<your-task-queue>)
80
70
81
71
### Step 3: Set Current Version to Unversioned
82
72
@@ -97,13 +87,13 @@ After completing the migration steps:
97
87
1.**Verify in the Temporal UI** that traffic is gradually shifting from versioned workers to unversioned workers.
98
88
2.**AutoUpgrade workflows** will eventually move onto the unversioned worker(s).
99
89
3.**Pinned workflows** that were started on versioned workers will continue and complete execution on those pinned workers.
100
-
4.**New executions** of workflows, regardless of them being *Pinned* or *AutoUpgrade*, shall start on the deployed unversioned workers (unless they have a versioning-override set.)
90
+
4.**New executions** of workflows, regardless of them being *Pinned* or *AutoUpgrade*, will start on the deployed unversioned workers (unless they have a versioning-override set.)
101
91
102
92
---
103
93
104
94
## Cleanup and Garbage Collection
105
95
106
-
This section highlights the ways in which one can delete the corresponding Worker Versions or Worker Deployment resources that were created in Temporal.
96
+
**NOTE**: The cleanup steps below are optional as it is not required to garbage collect the Worker Versions or Worker Deployment resources from the Temporal Server while migrating to unversioned workers.
107
97
108
98
### Deleting Kubernetes Deployments created with the Worker-Controller:
109
99
@@ -112,23 +102,14 @@ The Worker Controller will delete Kubernetes Deployments, which represent versio
112
102
### Deleting Worker Versions
113
103
114
104
A Worker Version can be deleted once it has been drained and has no active pollers.
115
-
Once it's drained and without active pollers, delete the Worker Version using:
105
+
Once it's drained and is without active pollers, delete the Worker Version using:
116
106
117
107
```bash
118
108
temporal worker deployment delete-version \
119
109
--deployment-name <your-deployment-name> \
120
110
--build-id <your-build-id>
121
111
```
122
112
123
-
> **Tip:** To skip the draining requirement, add the `--skip-drainage` flag:
0 commit comments