Skip to content

Document the per-Namespace Worker Controller Instance limit - #5199

Open
lennessyy wants to merge 1 commit into
mainfrom
serverless-wci-namespace-limit
Open

Document the per-Namespace Worker Controller Instance limit#5199
lennessyy wants to merge 1 commit into
mainfrom
serverless-wci-namespace-limit

Conversation

@lennessyy

Copy link
Copy Markdown
Contributor

What

  • Adds Max Worker Controller Instances limits to the Cloud limits page under Worker Versioning level: default 100, raisable through support, and separate from the per-deployment version limit. Records that drained versions still count, since a version's WCI runs until the version is deleted.
  • Notes the limit in the Serverless Workers encyclopedia page, in the WCI section.
  • Notes the limit in both deploy guides at step 4, where a version with a compute configuration is created.

Verified against temporal-auto-scaled-workers on main: wci/client/config.go (workercontroller.maxInstances, default 100), wci/client/client.go (the ResourceExhausted check), and the visibility count query, which filters on running WCI Workflows only. The delete path in temporal's version_workflow.go removes the WCI when the version is deleted, not when it drains.

Adds a Max Worker Controller Instances entry to the Cloud limits page,
covering the 100 default, that drained versions still count, and how it
differs from the per-deployment version limit. Notes the limit in the
serverless encyclopedia page and in both deploy guides at the step where
a version is created.
Copilot AI balanced review requested due to automatic review settings August 28, 2026 00:38
@lennessyy
lennessyy requested review from a team and bechols as code owners August 28, 2026 00:38
@vercel

vercel Bot commented Aug 28, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview Aug 28, 2026 12:39am

Request Review

@@ -398,3 +398,13 @@ The maximum number of versions that the server allows to be registered in a sing
### Max Task Queues In Deployment Version limits {/* #max-task-queues-in-deployment-version-limits */}

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.

📝 [vale] <Temporal.Headings> reported by reviewdog 🐶
'Max Task Queues In Deployment Version limits *****************************************************' should use sentence-style capitalization.

@github-actions

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Copilot AI left a comment

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.

Pull request overview

Documents the per-Namespace Worker Controller Instance limit for Serverless Workers.

Changes:

  • Adds the default limit, error, scope, and remediation.
  • Adds limit guidance to Serverless Worker concepts and deployment guides.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
cloud-run/index.mdx Notes the limit during version creation.
aws-lambda/index.mdx Notes the limit during version creation.
limits.mdx Defines the Cloud limit and remediation.
serverless-workers/index.mdx Explains WCI lifecycle and limit behavior.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +93 to +96
A Namespace runs at most 100 WCI Workflows by default, which caps how many Worker Deployment Versions in the Namespace
can have a compute provider at once. A version's WCI runs until the version is deleted, so drained versions count
against the limit. See
[Max Worker Controller Instances limits](/cloud/limits#max-worker-controller-instances-limits).
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