docs: add Cloud Run Serverless Worker pages for Java, .NET, TypeScript, Ruby, and Rust - #5118
Merged
Conversation
…t, Ruby, and Rust Restores the TypeScript Cloud Run page and adds Cloud Run guides for Java, .NET, Ruby, and Rust. Each page was written from a worker that was built, deployed to a Cloud Run worker pool starting at 0 instances, and confirmed to run a Workflow through WCI scale-from-zero. Documents the packaging traps that testing surfaced: - TypeScript: node:22-slim ships without a CA bundle, so the SDK's Rust core fails at startup with NativeCertsNotFound. The existing Dockerfile in the deployment guide had this bug. - Ruby: install the precompiled gem, since Bundler can select the source gem and fail without a Rust toolchain. - Rust: the build needs libprotobuf-dev alongside protobuf-compiler, and debian:bookworm-slim needs ca-certificates added. - Java: the JVM defaults max heap to 25% of the container limit. Also fixes two unrelated Rust snippet bugs found while verifying that work. The versioned-Worker snippet in worker-process.mdx imported the raw proto VersioningBehavior, which stopped type-checking when SDK 0.6.0 added a first-class temporalio_common::worker::VersioningBehavior. The quickstart never built as written: its Cargo.toml omitted temporalio-workflow, which the Workflow macros expand to reference, and register_workflow was missing the ? it needs before build(). Both pages now compile against 0.6.0. vercel.json drops a duplicate JSON key that had silently disabled the /llms-api-reference.txt redirect.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📖 Docs PR preview links
|
The Java, .NET, TypeScript, and Ruby Cloud Run pages now pull their Worker code from features/snippets/worker/ via Snipsync instead of carrying hand-written code that nothing compiles. Snipsync is pinned to the features branch until temporalio/features#861 merges. Rust keeps its hand-written snippet, since the features repo has no Rust harness.
lennessyy
marked this pull request as draft
August 14, 2026 21:19
lennessyy
commented
Aug 19, 2026
- Link Worker Versioning on first mention across the SDK pages and the guide. - Drop the prerequisite wording implying only some SDKs support Worker Versioning. - Reword the per-tab SDK page links, which read as though the tab itself were not Cloud Run specific. - Condense the TypeScript container notes in the guide to what to do. - Cut the TypeScript-SDK framing from the packaging section on the TypeScript page. - Restore envconfig in the TypeScript snippet so it matches the page prose and the guide, and add the TypeScript SDK page link the guide was missing.
Matches the snippet in the features repo, whose harness cannot depend on @temporalio/envconfig. Both TypeScript samples now agree, and envconfig stays documented as the alternative.
…oud-run-sdks # Conflicts: # docs/develop/rust/quickstart.mdx # docs/develop/rust/workers/worker-process.mdx
lennessyy
marked this pull request as ready for review
August 19, 2026 23:46
Duncanma
enabled auto-merge (squash)
August 20, 2026 20:12
Duncanma
approved these changes
Aug 20, 2026
flippedcoder
approved these changes
Aug 20, 2026
Contributor
Author
|
@codex review this |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 7e8c1eb670
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Removes the Snipsync markers, the generated source links, and the branch pin in snipsync.config.yaml. The links pointed at temporalio/features#861, which has not merged, so they would 404 once that branch is deleted. The code is unchanged from the snippets. When #861 lands, restore the markers and re-run snipsync.
…m/temporalio/documentation into serverless-workers-cloud-run-sdks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Restores the TypeScript Cloud Run page and adds Cloud Run Serverless Worker guides for Java, .NET, Ruby, and Rust. Every page was written from a worker that was built, deployed to a Cloud Run worker pool starting at 0 instances, and confirmed to run a Workflow through WCI scale-from-zero.
Testing surfaced packaging traps that are now documented, including a bug in the deployment guide's own TypeScript Dockerfile:
node:22-slimships without a CA bundle, so the SDK's Rust core fails at startup withNativeCertsNotFound.Also updates the evaluate matrix and the encyclopedia page, which now state that any SDK can run on a Cloud Run worker pool, so a missing per-SDK page reads as "no example yet" rather than "unsupported."
Two unrelated Rust snippet fixes found while verifying that work: the versioned-Worker snippet in
worker-process.mdxno longer compiles on SDK 0.6.0, and the Rust quickstart never built as written. Both pages now compile against 0.6.0.vercel.jsondrops a duplicate JSON key that had silently disabled the/llms-api-reference.txtredirect.PHP is not included. Its worker runs under RoadRunner and the Temporal Cloud API key path there was not verified.
┆Attachments: EDU-6962 docs: add Cloud Run Serverless Worker pages for Java, .NET, TypeScript, Ruby, and Rust