Repository navigation
docs: add serverless-worker-aws skill - #3888
Merged
Merged
Conversation
Documents the AWS side of Temporal serverless worker deployments: the IAM role and external ID the Worker Controller assumes, the Lambda function settings, deploying the Go worker from temporalio/temporal-serverless-worker, and the values that must match between .env and the Create Serverless Deployment form in the UI. Sourced from SETUP.md in temporal-serverless-worker, updated for the staging-first (Temporal Cloud mTLS) flow with local ngrok dev as a secondary path.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
The Require tests to pass ruleset needs unit-tests, integration-tests and e2e-tests, but both workflows that produce them ignored PRs that only touch Markdown. A docs-only PR therefore never ran the required checks and stayed blocked. Drop the path filter so the checks run on every PR.
Collaborator
Author
|
Heads up: this PR was blocked because the "Require tests to pass" ruleset needs |
temporal-cicd Bot
pushed a commit
that referenced
this pull request
Oct 1, 2026
Auto-generated version bump from 2.54.1 to 2.55.0 Bump type: minor Changes included: - [`79ca6514`](79ca651) Add size variants to IO badges (#3908) - [`6cc68ed0`](6cc68ed) feat(deployments): show worker deployment connection status by default (#3852) - [`c0885b3d`](c0885b3) Agents Product page (#3904) - [`8b9054d6`](8b9054d) Consistent headers (#3909) - [`4d8aa361`](4d8aa36) Fix test (#3911) - [`6d6cb9fc`](6d6cb9f) Remove drop shadow from loading spinner (#3910) - [`542fa634`](542fa63) Fix portaled menu anchor scaling (#3913) - [`c71816bf`](c71816b) feat(workers): add Amazon Bedrock AgentCore as a compute provider (#3884) - [`d179959c`](d179959) Make nexus registry description reusable (#3914) - [`12526241`](1252624) Make workflow details task queue a filter link (#3922) - [`3c479755`](3c47975) Polish Agents page cards, header and Integrations text (#3917) - [`e8a0d81d`](e8a0d81) chore(deps): resolve open Dependabot security alerts (#3920) - [`7a47d7ee`](7a47d7e) Remove filter button corner rounding (#3926) - [`a561ce12`](a561ce1) docs: add serverless-worker-aws skill (#3888) - [`550056b1`](550056b) Render Markdown links in Event summary (#3865) - [`5699aacd`](5699aac) Generate the render stylesheet so both routes share one source (#3905) - [`4eb3b075`](4eb3b07) Fix clipped timeline dot icons on 1x displays (#3929) - [`bff55086`](bff5508) (fix) Keep the Cloud nav toggle square when the nav is collapsed (#3930) - [`ea9ee2b4`](ea9ee2b) Add Scheduled system view and last viewed Saved Views (#3924) - [`8094a997`](8094a99) Fix last viewed saved view tracking (#3934) - [`dc4c3058`](dc4c305) Match the Cloud nav header to the Web UI's logo and title (#3933) - [`e97e6648`](e97e664) (fix) Web UI nav: toggle size, divider spacing, and version contrast (#3932) - [`4486bd76`](4486bd7) Set the markdown frame in the system font stack (#3935) - [`0e0ccedb`](0e0cced) fix(pagination): honor the url page when the store is rebuilt (FE-538) (#3875) - [`be938c70`](be938c7) Fix workflow summary iframe navigation history (#3937) - [`9c9685a3`](9c9685a) Update serverless-worker-create form for AgentCore (#3936) - [`00d02395`](00d0239) FE-734 - Add resizable columns to the configurable tables (#3925) - [`93d0fb2c`](93d0fb2) Add configurable UI extension slots (#3622) - [`80d864d1`](80d864d) Collapse common errors by default (#3921) - [`ffee0375`](ffee037) Fix multiline timeline summaries (#3944) - [`52f5a3e4`](52f5a3e) Include 1000 for pageSize (#3938) - [`5b4fff31`](5b4fff3) Color the favicon by the status of the workflow being viewed (#3900) - [`be382aa3`](be382aa) fix(auth): align cookie lifetimes with session and refresh token boundaries (#3940) - [`14f25d35`](14f25d3) fix(theme): ship the 2xs font size token to consumers (#3947) - [`737f55af`](737f55a) fix(workers): resolve worker deployment from task queue (#3883) - [`86f48ed0`](86f48ed) fix(workers): describe pollers, not slots, in the poller tooltip (#3956) - [`c1829dcf`](c1829dc) fix(copyable): round the copy button's corners (#3954) - [`9c20e7cf`](9c20e7c) Update links for agents (#3957) - [`c41a20f0`](c41a20f) Fix black area below the login page in dark mode (#3953) - [`82587bd8`](82587bd) Holographic upgrade sticker in the side nav (#3949) - [`6d27e4ce`](6d27e4c) Move Cloud Run to public preview (#3945) - [`31f5ab2f`](31f5ab2) Enable antialiasing on the body text (#3964) - [`78ef7abf`](78ef7ab) Use normal weight and primary text for worker details stats - [`a66748b8`](a66748b) Remove redundant text-primary - [`b03ba040`](b03ba04) fix(holocene): align label-to-field gap across form controls (#3968) - [`32a0273b`](32a0273) a11y(1.4.3): use text-secondary for Input and Combobox hint text (#3970) - [`838c0d25`](838c0d2) feat(activities): show updated activity options in the Pending Activity card (#3966) - [`2edc463c`](2edc463) Register render route without public path prefix (#3973)
temporal-cicd Bot
pushed a commit
that referenced
this pull request
Oct 1, 2026
Auto-generated version bump from 2.54.1 to 2.55.0 Bump type: minor Changes included: - [`79ca6514`](79ca651) Add size variants to IO badges (#3908) - [`6cc68ed0`](6cc68ed) feat(deployments): show worker deployment connection status by default (#3852) - [`c0885b3d`](c0885b3) Agents Product page (#3904) - [`8b9054d6`](8b9054d) Consistent headers (#3909) - [`4d8aa361`](4d8aa36) Fix test (#3911) - [`6d6cb9fc`](6d6cb9f) Remove drop shadow from loading spinner (#3910) - [`542fa634`](542fa63) Fix portaled menu anchor scaling (#3913) - [`c71816bf`](c71816b) feat(workers): add Amazon Bedrock AgentCore as a compute provider (#3884) - [`d179959c`](d179959) Make nexus registry description reusable (#3914) - [`12526241`](1252624) Make workflow details task queue a filter link (#3922) - [`3c479755`](3c47975) Polish Agents page cards, header and Integrations text (#3917) - [`e8a0d81d`](e8a0d81) chore(deps): resolve open Dependabot security alerts (#3920) - [`7a47d7ee`](7a47d7e) Remove filter button corner rounding (#3926) - [`a561ce12`](a561ce1) docs: add serverless-worker-aws skill (#3888) - [`550056b1`](550056b) Render Markdown links in Event summary (#3865) - [`5699aacd`](5699aac) Generate the render stylesheet so both routes share one source (#3905) - [`4eb3b075`](4eb3b07) Fix clipped timeline dot icons on 1x displays (#3929) - [`bff55086`](bff5508) (fix) Keep the Cloud nav toggle square when the nav is collapsed (#3930) - [`ea9ee2b4`](ea9ee2b) Add Scheduled system view and last viewed Saved Views (#3924) - [`8094a997`](8094a99) Fix last viewed saved view tracking (#3934) - [`dc4c3058`](dc4c305) Match the Cloud nav header to the Web UI's logo and title (#3933) - [`e97e6648`](e97e664) (fix) Web UI nav: toggle size, divider spacing, and version contrast (#3932) - [`4486bd76`](4486bd7) Set the markdown frame in the system font stack (#3935) - [`0e0ccedb`](0e0cced) fix(pagination): honor the url page when the store is rebuilt (FE-538) (#3875) - [`be938c70`](be938c7) Fix workflow summary iframe navigation history (#3937) - [`9c9685a3`](9c9685a) Update serverless-worker-create form for AgentCore (#3936) - [`00d02395`](00d0239) FE-734 - Add resizable columns to the configurable tables (#3925) - [`93d0fb2c`](93d0fb2) Add configurable UI extension slots (#3622) - [`80d864d1`](80d864d) Collapse common errors by default (#3921) - [`ffee0375`](ffee037) Fix multiline timeline summaries (#3944) - [`52f5a3e4`](52f5a3e) Include 1000 for pageSize (#3938) - [`5b4fff31`](5b4fff3) Color the favicon by the status of the workflow being viewed (#3900) - [`be382aa3`](be382aa) fix(auth): align cookie lifetimes with session and refresh token boundaries (#3940) - [`14f25d35`](14f25d3) fix(theme): ship the 2xs font size token to consumers (#3947) - [`737f55af`](737f55a) fix(workers): resolve worker deployment from task queue (#3883) - [`86f48ed0`](86f48ed) fix(workers): describe pollers, not slots, in the poller tooltip (#3956) - [`c1829dcf`](c1829dc) fix(copyable): round the copy button's corners (#3954) - [`9c20e7cf`](9c20e7c) Update links for agents (#3957) - [`c41a20f0`](c41a20f) Fix black area below the login page in dark mode (#3953) - [`82587bd8`](82587bd) Holographic upgrade sticker in the side nav (#3949) - [`6d27e4ce`](6d27e4c) Move Cloud Run to public preview (#3945) - [`31f5ab2f`](31f5ab2) Enable antialiasing on the body text (#3964) - [`78ef7abf`](78ef7ab) Use normal weight and primary text for worker details stats - [`a66748b8`](a66748b) Remove redundant text-primary - [`b03ba040`](b03ba04) fix(holocene): align label-to-field gap across form controls (#3968) - [`32a0273b`](32a0273) a11y(1.4.3): use text-secondary for Input and Combobox hint text (#3970) - [`838c0d25`](838c0d2) feat(activities): show updated activity options in the Pending Activity card (#3966) - [`2edc463c`](2edc463) Register render route without public path prefix (#3973) - [`7d564fe5`](7d564fe) Render event summaries on one line in the timeline and event history (#3972)
laurakwhit
added a commit
that referenced
this pull request
Oct 1, 2026
Auto-generated version bump from 2.54.1 to 2.55.0 Bump type: minor Changes included: - [`79ca6514`](79ca651) Add size variants to IO badges (#3908) - [`6cc68ed0`](6cc68ed) feat(deployments): show worker deployment connection status by default (#3852) - [`c0885b3d`](c0885b3) Agents Product page (#3904) - [`8b9054d6`](8b9054d) Consistent headers (#3909) - [`4d8aa361`](4d8aa36) Fix test (#3911) - [`6d6cb9fc`](6d6cb9f) Remove drop shadow from loading spinner (#3910) - [`542fa634`](542fa63) Fix portaled menu anchor scaling (#3913) - [`c71816bf`](c71816b) feat(workers): add Amazon Bedrock AgentCore as a compute provider (#3884) - [`d179959c`](d179959) Make nexus registry description reusable (#3914) - [`12526241`](1252624) Make workflow details task queue a filter link (#3922) - [`3c479755`](3c47975) Polish Agents page cards, header and Integrations text (#3917) - [`e8a0d81d`](e8a0d81) chore(deps): resolve open Dependabot security alerts (#3920) - [`7a47d7ee`](7a47d7e) Remove filter button corner rounding (#3926) - [`a561ce12`](a561ce1) docs: add serverless-worker-aws skill (#3888) - [`550056b1`](550056b) Render Markdown links in Event summary (#3865) - [`5699aacd`](5699aac) Generate the render stylesheet so both routes share one source (#3905) - [`4eb3b075`](4eb3b07) Fix clipped timeline dot icons on 1x displays (#3929) - [`bff55086`](bff5508) (fix) Keep the Cloud nav toggle square when the nav is collapsed (#3930) - [`ea9ee2b4`](ea9ee2b) Add Scheduled system view and last viewed Saved Views (#3924) - [`8094a997`](8094a99) Fix last viewed saved view tracking (#3934) - [`dc4c3058`](dc4c305) Match the Cloud nav header to the Web UI's logo and title (#3933) - [`e97e6648`](e97e664) (fix) Web UI nav: toggle size, divider spacing, and version contrast (#3932) - [`4486bd76`](4486bd7) Set the markdown frame in the system font stack (#3935) - [`0e0ccedb`](0e0cced) fix(pagination): honor the url page when the store is rebuilt (FE-538) (#3875) - [`be938c70`](be938c7) Fix workflow summary iframe navigation history (#3937) - [`9c9685a3`](9c9685a) Update serverless-worker-create form for AgentCore (#3936) - [`00d02395`](00d0239) FE-734 - Add resizable columns to the configurable tables (#3925) - [`93d0fb2c`](93d0fb2) Add configurable UI extension slots (#3622) - [`80d864d1`](80d864d) Collapse common errors by default (#3921) - [`ffee0375`](ffee037) Fix multiline timeline summaries (#3944) - [`52f5a3e4`](52f5a3e) Include 1000 for pageSize (#3938) - [`5b4fff31`](5b4fff3) Color the favicon by the status of the workflow being viewed (#3900) - [`be382aa3`](be382aa) fix(auth): align cookie lifetimes with session and refresh token boundaries (#3940) - [`14f25d35`](14f25d3) fix(theme): ship the 2xs font size token to consumers (#3947) - [`737f55af`](737f55a) fix(workers): resolve worker deployment from task queue (#3883) - [`86f48ed0`](86f48ed) fix(workers): describe pollers, not slots, in the poller tooltip (#3956) - [`c1829dcf`](c1829dc) fix(copyable): round the copy button's corners (#3954) - [`9c20e7cf`](9c20e7c) Update links for agents (#3957) - [`c41a20f0`](c41a20f) Fix black area below the login page in dark mode (#3953) - [`82587bd8`](82587bd) Holographic upgrade sticker in the side nav (#3949) - [`6d27e4ce`](6d27e4c) Move Cloud Run to public preview (#3945) - [`31f5ab2f`](31f5ab2) Enable antialiasing on the body text (#3964) - [`78ef7abf`](78ef7ab) Use normal weight and primary text for worker details stats - [`a66748b8`](a66748b) Remove redundant text-primary - [`b03ba040`](b03ba04) fix(holocene): align label-to-field gap across form controls (#3968) - [`32a0273b`](32a0273) a11y(1.4.3): use text-secondary for Input and Combobox hint text (#3970) - [`838c0d25`](838c0d2) feat(activities): show updated activity options in the Pending Activity card (#3966) - [`2edc463c`](2edc463) Register render route without public path prefix (#3973) - [`7d564fe5`](7d564fe) Render event summaries on one line in the timeline and event history (#3972) Co-authored-by: laurakwhit <15069288+laurakwhit@users.noreply.github.com>
This branch was successfully deployed
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.
Description & motivation 💭
Adds a
serverless-worker-awsskill covering the AWS side of Temporal serverless worker deployments — the piece you need standing up before the UI's Create Serverless Deployment flow does anything.It documents:
workercontroller.compute_providers.aws.require_role_and_external_iddefaults totrue)provided.al2023,bootstraphandler, 75s timeout)scripts/deploy.sh.envand the UI form —DEPLOYMENT_NAMEandBUILD_IDappear in three places and silently misbehave when they disagreelocal-temporalskillHOST_PORT, credentials exported aftermake start, timeout under 60sContent is sourced from
SETUP.mdintemporal-serverless-workerand corrected while moving: that doc still describes the old local-only ngrok workflow, alambda-worker/directory that no longer exists, and a root-leveldeploy.shthat has since moved toscripts/and now handles env vars from.env.Testing 🧪
How was this tested 👻
Docs-only change — no runtime code touched. Verified every command, path, env var, and default in the skill against the current
temporal-serverless-workersources (main.go,scripts/deploy.sh,.env.example) rather than copying the staleSETUP.mdtext. Formatted with the repo's prettier config.Steps for others to test: 🚶🏽♂️🚶🏽♀️
Ask Claude Code something like "how do I set up the Lambda for a serverless worker deployment?" in this repo and confirm the skill loads and the instructions are followable end to end.
Docs
Any docs updates needed?
SETUP.mdintemporal-serverless-workeris now largely superseded by this skill and is stale in a few places. Trimming it down to a pointer would be a good follow-up in that repo — not done here since it is a different repo.