Skip to content

docs: add serverless-worker-aws skill - #3888

Merged
rossnelson merged 3 commits into
mainfrom
rossnelson/serverless-worker-aws-skill
Sep 16, 2026
Merged

rossnelson merged 3 commits into
mainfrom
rossnelson/serverless-worker-aws-skill

Conversation

@rossnelson

Copy link
Copy Markdown
Collaborator

Description & motivation 💭

Adds a serverless-worker-aws skill 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:

  • The IAM role, trust policy, and external ID the Worker Controller assumes (the external ID is required — workercontroller.compute_providers.aws.require_role_and_external_id defaults to true)
  • Lambda function settings (provided.al2023, bootstrap handler, 75s timeout)
  • Deploying the Go worker from temporalio/temporal-serverless-worker via its scripts/deploy.sh
  • Which values must match between that repo's .env and the UI form — DEPLOYMENT_NAME and BUILD_ID appear in three places and silently misbehave when they disagree
  • Staging (Temporal Cloud, base64 mTLS certs) as the default path, with local Temporal + ngrok as a secondary one that links out to the existing local-temporal skill
  • A symptom → cause table for the failures that actually happen: architecture mismatch, stale ngrok HOST_PORT, credentials exported after make start, timeout under 60s

Content is sourced from SETUP.md in temporal-serverless-worker and corrected while moving: that doc still describes the old local-only ngrok workflow, a lambda-worker/ directory that no longer exists, and a root-level deploy.sh that has since moved to scripts/ and now handles env vars from .env.

Testing 🧪

How was this tested 👻

  • Manual testing

Docs-only change — no runtime code touched. Verified every command, path, env var, and default in the skill against the current temporal-serverless-worker sources (main.go, scripts/deploy.sh, .env.example) rather than copying the stale SETUP.md text. 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.md in temporal-serverless-worker is 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.

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.
@rossnelson
rossnelson requested a review from a team as a code owner September 8, 2026 21:10
@vercel

vercel Bot commented Sep 8, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
holocene Ready Ready Preview Sep 16, 2026 12:50pm UTC

Request Review

@andrewzamojc andrewzamojc 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.

LGTM

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.
@rossnelson

Copy link
Copy Markdown
Collaborator Author

Heads up: this PR was blocked because the "Require tests to pass" ruleset needs unit-tests, integration-tests and e2e-tests, but both workflows that produce them had a paths-ignore for **.md. A docs-only PR never ran the required checks, so it could never go green. I dropped that filter from lint-and-test.yml and playwright.yml in e540e24 so the checks run on every PR. Happy to split that into its own PR if you would rather keep this one docs-only.

@rossnelson
rossnelson merged commit a561ce1 into main Sep 16, 2026
17 checks passed
@rossnelson
rossnelson deleted the rossnelson/serverless-worker-aws-skill branch September 16, 2026 15:29
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

1 active deployment
Preview — e540e24e Deployed Sep 16, 2026 by vercel[bot]
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