When should I update my application workers during an upgrade?

Workers should be scaled down before the server upgrade and updated with compatible SDK versions before being redeployed against the new server version.

How do I verify if my cluster is healthy after an upgrade?

The skill provides commands to check cluster health via the Temporal CLI (operator cluster health) and verify pod status using kubectl.

Does this skill provide database backup commands?

Yes, it includes specific PostgreSQL backup commands for both the main Temporal database and the visibility database.

Can I skip major versions when upgrading Temporal?

No, it is recommended to follow sequential upgrade paths (e.g., 1.21.x to 1.22.x) to ensure schema stability and prevent data corruption.

What is the recommended way to handle a failed upgrade?

The guide includes a rollback procedure that covers reverting Helm releases, restoring database backups, and redeploying previous worker versions.

Temporal Upgrade Guide

Name: Temporal Upgrade Guide
Author: therealbill

bytherealbill

0•

Deployment & DevOps

Provides safe procedures and expert guidance for upgrading Temporal server versions, SDKs, and database schemas.

The Temporal Upgrade Guide skill acts as a specialized operational companion for managing Temporal infrastructure lifecycles. It offers comprehensive checklists for pre-upgrade planning, sequential version mapping, and detailed rollback procedures to ensure system stability. By helping developers and SREs navigate complex schema migrations, verify cluster health, and maintain SDK compatibility across the Temporal ecosystem, it minimizes the risk of downtime and prevents non-determinism issues during major version transitions.

Key Features

01Database schema migration guidance and tool usage

020 GitHub stars

03Sequential version path planning and mapping

04Post-upgrade cluster health and verification checks

05SDK and server compatibility verification

06Step-by-step cluster backup and rollback procedures

Use Cases

01Upgrading a production Temporal cluster across major versions

02Checking SDK compatibility before performing server maintenance

03Executing SQL schema migrations using the temporal-sql-tool

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add therealbill/mynet upgrade-guide

For use in Claude.ai and ChatGPT

Download Skill