Skip to content

docs(temporal-proxy): add Temporal Proxy configuration page#4954

Open
pseudomuto wants to merge 1 commit into
mainfrom
temporal_proxy_overview
Open

docs(temporal-proxy): add Temporal Proxy configuration page#4954
pseudomuto wants to merge 1 commit into
mainfrom
temporal_proxy_overview

Conversation

@pseudomuto

@pseudomuto pseudomuto commented Jul 24, 2026

Copy link
Copy Markdown

Add a deploy-to-production page for the Temporal Proxy, the gRPC proxy that routes SDK Client and Worker traffic to one or more upstream Temporal Services (local, self-hosted, or Temporal Cloud) while handling Namespace translation, TLS, and credentials.

The proxy is pre-release, so the page leads with that caveat and links to the repository, the Cloud example, and the Helm chart for the definitive, still-evolving schema. Lives under production-deployment as a directory (index.mdx) to leave room for future pages; the slug is pinned so the URL is stable regardless of file location.

┆Attachments: EDU-6796 docs(temporal-proxy): add Temporal Proxy configuration page

@pseudomuto
pseudomuto requested a review from a team as a code owner July 24, 2026 15:06
@vercel

vercel Bot commented Jul 24, 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, Comment Jul 26, 2026 12:56pm

Request Review

Credentials require TLS to the upstream. If you set `credentials` without a `tls` block, the configuration fails to
load.

### Configure TLS

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] reported by reviewdog 🐶
[Temporal.Headings] 'Configure TLS' should use sentence-style capitalization.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

I don't think this applies here since TLS is an acronym

@github-actions

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

@Duncanma

Copy link
Copy Markdown
Contributor

@flippedcoder should we remove that slug, following our new guidance? And should this use the release note header to communicate the pre-release status?

Add a deploy to production page for the Temporal Proxy, the gRPC proxy
that routes SDK Client and Worker traffic to one or more upstream
Temporal Services (local, self-hosted, or Temporal Cloud) while handling
Namespace translation, TLS, and credentials.

The proxy is pre-release, so the page leads with that caveat and links
to the repository, the Cloud example, and the Helm chart for the
definitive, still-evolving schema. Lives under production-deployment as
a directory (index.mdx) to leave room for future pages; the slug is
pinned so the URL is stable regardless of file location.
@pseudomuto
pseudomuto force-pushed the temporal_proxy_overview branch from 89f1a69 to 64878a2 Compare July 26, 2026 12:53
host. Grant that identity only the permission to encrypt and decrypt with the specific key, as shown for each provider
below.

#### AWS KMS

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] reported by reviewdog 🐶
[Temporal.Headings] 'AWS KMS' should use sentence-style capitalization.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

KMS is an acronym, and how AWS refers to the product

renewBefore: 15m
```

#### Azure Key Vault

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] reported by reviewdog 🐶
[Temporal.Headings] 'Azure Key Vault' should use sentence-style capitalization.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

maybe 😄 Azure docs also use sentence-style titles, but refer to Key Vault (likely because it's a product). ref

renewBefore: 15m
```

#### Google Cloud KMS

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] reported by reviewdog 🐶
[Temporal.Headings] 'Google Cloud KMS' should use sentence-style capitalization.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

We use Google Cloud in other places ref, and KMS is an acronym.

ServiceAccount by name, so set `serviceAccount.name` in your values to keep it stable and matching what you bind on the
cloud side.

### AWS IRSA and Pod Identity

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] reported by reviewdog 🐶
[Temporal.Headings] 'AWS IRSA and Pod Identity' should use sentence-style capitalization.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Same comment as Azure Key Vault. IRSA is an acronym, and Pod Identity is a product/feature name ref

an association between the role and the ServiceAccount with `aws eks create-pod-identity-association`, and no annotation
is required.

### Azure Workload Identity

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] reported by reviewdog 🐶
[Temporal.Headings] 'Azure Workload Identity' should use sentence-style capitalization.

azure.workload.identity/use: 'true'
```

### GCP Workload Identity

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] reported by reviewdog 🐶
[Temporal.Headings] 'GCP Workload Identity' should use sentence-style capitalization.

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