Skip to content

faq and misc updates#4402

Open
dspinhirne-temporal wants to merge 1 commit intomainfrom
auto-migrate-update-08-04
Open

faq and misc updates#4402
dspinhirne-temporal wants to merge 1 commit intomainfrom
auto-migrate-update-08-04

Conversation

@dspinhirne-temporal
Copy link
Copy Markdown
Contributor

@dspinhirne-temporal dspinhirne-temporal commented Apr 8, 2026

What does this PR do?

Updates to FAQ + some misc corrections.

┆Attachments: EDU-6175 faq and misc updates

@dspinhirne-temporal dspinhirne-temporal requested a review from a team as a code owner April 8, 2026 15:16
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Apr 8, 2026 3:17pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

📖 Docs PR preview links


This is a complex question. The answer depends on your specific situation. The most common considerations are:

1. Risk of change - No matter what, clients must be updated to use the new cloud-side Namespace. The big difference is that
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This #1 is unclear to me. Are you saying "Automated Migration gives you the flexibility to migrate Workers in different orders / space it out over time, instead of 'all at once' ?"


## Frequently asked questions

### When should I opt for auto migration?
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do not think the answer here addresses this question.

### Can I split Workflows from a single source Namespace into multiple cloud-side Namespaces?

Not directly. The migration tooling migrates all Workflows from a Namespace. If your goal is to split Workflows, then you should
manually migrate any workflows into their new cloud-side targets prior to starting an auto-migration.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we link to a docs page about how to "manually migrate a workflow" ?


### Can I combine manual and auto migration?

It depends. Auto migration requires a "fresh" target cloud-side Namespace (e.g. one that has never had a running Workflow).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would suggest this, to make it more clear:

You can, as long as the automated migration comes first. Automated migrations require a brand new Temporal Cloud Namespace. An automated migration cannot be run against a Namespace that already has running Workflows, even if those Workflows were manually migrated from your cluster.

### What Workflows are migrated by default?

All Workflows are migrated by default. For closed Workflows, you may specify a date range to be migrated. Limiting the time range for
closed Workflows will greatly reduce the amount of time it takes to migrate a Namespace. Your cloud-side Namespace must
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested additional FAQ: "What affects the amount of time a migration takes?" or "How can I speed up a migration?"


### I have a long retention period for my Workflows. Is this compatible with Temporal Cloud?

Occasionally, self-hosted [retention periods](/temporal-service/temporal-server#retention-period) are in excess of what
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we ever spell out the max retention period we support for migrations?


### I would like to enable payload encryption as part of the migration. Is this supported?

Enabling payload encryption as part of the migration is not currently supported. If encryption is required, then the best
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested rewrite: "The automated migration tooling cannot add payload encryption. To encrypt payloads sent to Temporal Cloud, you must encrypt payloads in your cluster before starting the automated migration process."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants