Skip to content

Commit 65a3a91

Browse files
stephanosclaude
andcommitted
Show before/after failover states in the diagram
Use two cluster/namespace flowcharts: the Operation starting on the active Cluster, then the completion delivered on the new active Cluster after replication, so both the original and failover states are visible. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 628cb01 commit 65a3a91

1 file changed

Lines changed: 25 additions & 13 deletions

File tree

docs/production-deployment/self-hosted-guide/temporal-nexus.mdx

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -134,26 +134,38 @@ target an external URL (`--target-url`), which is experimental and not covered h
134134

135135
### What to expect on failover
136136

137-
Each Namespace is replicated across Clusters, and the active Cluster is set per
138-
Namespace. When the caller and handler Namespaces are active on different Clusters,
139-
the completion callback crosses Clusters:
137+
Each Namespace is a Global Namespace replicated across both Clusters, with one
138+
active Cluster per Namespace. An Operation started before a failover completes
139+
after it, on the new active Cluster.
140+
141+
**Before failover** — the Operation starts on the active Cluster:
142+
143+
```mermaid
144+
flowchart LR
145+
subgraph A["Cluster A — active"]
146+
caA["Caller Namespace"] -->|Nexus Operation| haA["Handler Namespace"]
147+
end
148+
subgraph B["Cluster B — standby"]
149+
caB["Caller Namespace"]
150+
haB["Handler Namespace"]
151+
end
152+
caA -. replicated .- caB
153+
haA -. replicated .- haB
154+
```
155+
156+
**After failover** — the completion is delivered on the new active Cluster:
140157

141158
```mermaid
142159
flowchart LR
143-
subgraph A["Cluster A"]
144-
direction TB
145-
caA["Caller Namespace<br/>active"]
146-
haA["Handler Namespace<br/>standby"]
160+
subgraph A["Cluster A — lost or standby"]
161+
caA["Caller Namespace"]
162+
haA["Handler Namespace"]
147163
end
148-
subgraph B["Cluster B"]
149-
direction TB
150-
caB["Caller Namespace<br/>standby"]
151-
haB["Handler Namespace<br/>active"]
164+
subgraph B["Cluster B — now active"]
165+
haB["Handler Namespace"] -->|completion callback| caB["Caller Namespace"]
152166
end
153167
caA -. replicated .- caB
154168
haA -. replicated .- haB
155-
caA ==>|Nexus Operation| haB
156-
haB ==>|completion callback| caA
157169
```
158170

159171
- **Callbacks are delivered internally** to the caller Namespace's active Cluster,

0 commit comments

Comments
 (0)