Skip to content

Commit 2ef671e

Browse files
committed
Updating the HA DNS resolution docs
1 parent ee23425 commit 2ef671e

2 files changed

Lines changed: 12 additions & 11 deletions

File tree

docs/cloud/connectivity/ip-addresses.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,9 @@ If you have to allowlist IP ranges, you must allowlist the entire cloud provider
3737
- [GCP IP address ranges](https://www.gstatic.com/ipranges/cloud.json)
3838

3939
:::
40+
41+
:::note Don't depend on DNS resolution behavior
42+
43+
Take a dependency on Temporal's published endpoints (the hostnames themselves), not on what they resolve to. The underlying IP addresses, CNAME chains, and resolution behavior can change at any time without notice. The **only** exception is the Namespace Endpoint for a Namespace with [High Availability features](/cloud/high-availability), which deterministically CNAMEs to its active region's regional record — see [Connectivity for High Availability](/cloud/high-availability/ha-connectivity) for details.
44+
45+
:::

docs/cloud/high-availability/ha-connectivity.mdx

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,12 @@ Temporal Cloud expresses the active replica through DNS:
9898

9999
Namespace DNS records have a 15-second TTL. Clients should converge to the new region within roughly 30 seconds (about twice the TTL) once their resolver cache expires.
100100

101+
:::note Deterministic DNS behavior is unique to HA Namespace Endpoints
102+
103+
This is the **only** place in Temporal Cloud where you can depend on Temporal-managed DNS to behave in a specific, deterministic way — a Namespace Endpoint on an HA Namespace CNAMEing to its active region's regional record. Everywhere else, take a dependency on Temporal's published endpoints (the hostnames themselves), not on what they resolve to. The underlying IP addresses, CNAME chains, and resolution behavior of non-HA endpoints can change at any time without notice.
104+
105+
:::
106+
101107
For private connectivity, your job is to make sure that:
102108

103109
- Override the Regional Endpoint's DNS zone to resolve to a VPC Endpoint.
@@ -183,17 +189,6 @@ If you run Workers on Alpine and use multi-cloud HA, either:
183189

184190
:::
185191

186-
To set up the DNS override, configure specific regions to target the internal VPC Endpoint IP addresses.
187-
For example, you might set `aws-us-west-1.region.tmprl.cloud` to target `192.168.1.2`.
188-
In AWS, this can be done using a Route 53 private hosted zone for `region.tmprl.cloud`.
189-
Link that private zone to the VPCs you use for Workers.
190-
191-
A reasonable validation plan:
192-
193-
Consider how you'll configure Workers for this setup.
194-
You can either have Workers run in both regions continuously or establish connectivity between regions using Transit Gateway or VPC Peering.
195-
Either approach ensures Workers can access the newly activated region once failover occurs.
196-
197192
### Available regions, PrivateLink endpoints, and DNS record overrides
198193

199194
:::caution

0 commit comments

Comments
 (0)