What causes non-determinism errors in Temporal workflows?

Non-determinism occurs when the workflow code is changed such that it produces a different sequence of commands during history replay than it did during the original execution.

What is the difference between versioning and resetting a workflow?

Versioning is a proactive strategy to handle code updates for future and running workflows, while resetting is a reactive measure used to fix workflows already stuck due to bugs or failures.

When is it safe to remove a version gate from my code?

You can safely remove versioning gates once all workflow executions that were started before the version change have reached a terminal state (Completed, Failed, or Canceled).

How does the GetVersion API prevent breaking changes?

It allows developers to branch their code logic. Existing workflows continue following the old execution path defined in the 'DefaultVersion', while new workflows follow the updated logic path.

Temporal Workflow Versioning Guide

Name: Temporal Workflow Versioning Guide
Author: therealbill

bytherealbill

0•

生产力与工作流

Provides expert guidance and implementation patterns for safely updating Temporal workflows without breaking long-running executions.

The Temporal Workflow Versioning skill is a specialized resource for developers using Temporal for orchestration. It offers comprehensive instructions on using the GetVersion API to maintain backward compatibility, preventing non-determinism errors during workflow replays. Users can access detailed patterns for adding or removing activities, modifying parameters, and managing multi-stage deployments. Beyond code-level versioning, it provides actionable commands for workflow resets and batch operations, ensuring that mission-critical business processes remain stable throughout the software development lifecycle.

主要功能

01Step-by-step deployment timelines for safe logic migrations

02CLI reference for targeted and batch workflow resets

03Best practices for version gate cleanup and history management

04Strategies for modifying workflow activities without non-determinism errors

050 GitHub stars

06Implementation patterns for the Temporal GetVersion API in Go

使用场景

01Recovering stuck workflow executions using the Temporal CLI reset tools

02Migrating legacy activity parameter structures to modern formats

03Safely updating business logic in workflows that take weeks or months to complete

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add therealbill/mynet versioning-guide

For use in Claude.ai and ChatGPT

Download Skill