Skip to content

docs: Serverless Workers - Evaluate pages (1/4)#4417

Open
lennessyy wants to merge 1 commit intofeat/serverless-worker-prereleasefrom
feat/serverless-worker-1-evaluate
Open

docs: Serverless Workers - Evaluate pages (1/4)#4417
lennessyy wants to merge 1 commit intofeat/serverless-worker-prereleasefrom
feat/serverless-worker-1-evaluate

Conversation

@lennessyy
Copy link
Copy Markdown
Contributor

@lennessyy lennessyy commented Apr 8, 2026

Summary

  • Adds the Evaluate section for Serverless Workers documentation, including the overview page and interactive demo page
  • Adds ServerlessWorkerDemo component and its CSS module
  • Adds sidebar entry under Features > Serverless Workers
  • Adds redirect from /evaluate/serverless-workers-demo to /evaluate/serverless-workers/demo
  • Changes onBrokenLinks and onBrokenAnchors from 'throw' to 'warn' to support incremental PRs with cross-references

This is PR 1 of 4, splitting #4405 into smaller PRs targeting feat/serverless-worker-prerelease.

Test plan

  • Verify the Evaluate > Features > Serverless Workers sidebar category renders correctly
  • Verify the overview page loads at /evaluate/serverless-workers
  • Verify the demo page loads at /evaluate/serverless-workers/demo
  • Verify the redirect from /evaluate/serverless-workers-demo works

🤖 Generated with Claude Code

┆Attachments: EDU-6189 docs: Serverless Workers - Evaluate pages (1/4)

Add the Evaluate section for Serverless Workers documentation:
- Serverless Workers overview page
- Interactive demo page with ServerlessWorkerDemo component
- Sidebar entry under Features
- Redirect from old demo URL
- Change onBrokenLinks/onBrokenAnchors to 'warn' for incremental PRs

Part 1 of 4, splitting PR #4405 into smaller PRs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lennessyy lennessyy requested a review from a team as a code owner April 8, 2026 23:50
@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 11:51pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

📖 Docs PR preview links


Serverless Workers use the same Temporal SDKs as traditional Workers.
You register Workflows and Activities the same way.
The difference is in the lifecycle: instead of a long-lived process that polls continuously, Temporal triggers the compute environment on demand, the Worker processes available Tasks, and then exits.
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.

The workers, while alive, still poll the server.


Traditional Workers require you to provision infrastructure, configure scaling policies, manage deployments, and monitor host-level health.
Serverless Workers remove this burden.
The compute provider handles provisioning, scaling, and infrastructure management.
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.

We do not handle provisioning (yet).

### Reduce operational overhead

Traditional Workers require you to provision infrastructure, configure scaling policies, manage deployments, and monitor host-level health.
Serverless Workers remove this burden.
Copy link
Copy Markdown
Contributor

@bchav bchav Apr 9, 2026

Choose a reason for hiding this comment

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

Customers still need to manage deployments. We simplify the deployment process (because of the simplicity of serverless providers), reduce the ongoing infrastructure management burden, handle autoscaling, scale to zero.


Serverless Workers may not be ideal when:

- **Workloads are long-running.** Serverless platforms enforce execution time limits (for example, AWS Lambda has a 15-minute maximum). Activities that run longer than the provider's timeout need a different hosting strategy.
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.

If the work flows are long running, it's a good fit. If you have an activity that needs longer than 15 minutes and cannot be interrupted, lambda is not a good fit. This limitation does not apply to cloud run.


- **Workloads are long-running.** Serverless platforms enforce execution time limits (for example, AWS Lambda has a 15-minute maximum). Activities that run longer than the provider's timeout need a different hosting strategy.
- **Workloads require sustained high throughput.** For consistently high-volume Task Queues, long-lived Workers on dedicated compute may be more cost-effective and performant.
- **You need persistent connections.** Some features require a persistent connection between the Worker and Temporal, which serverless invocations do not maintain.
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.

@smuneebahmad Is this true? Should we comment on how sticky works here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This is here primarily because in Go it looks like DisableEagerActivities is set to always true (users can't override). But yeah if there is a roadmap to remove these limitations we can remove this bullet

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.

2 participants