Skip to content

Commit 0853333

Browse files
stephanosclaude
andcommitted
Use a sequence diagram with Cluster boxes for failover
Group the caller and handler Namespaces into Cluster A and Cluster B boxes, and show the Operation starting while Cluster A is active, replication, failover, and completion once Cluster B is active. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 65a3a91 commit 0853333

1 file changed

Lines changed: 16 additions & 26 deletions

File tree

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

Lines changed: 16 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -136,36 +136,26 @@ target an external URL (`--target-url`), which is experimental and not covered h
136136

137137
Each Namespace is a Global Namespace replicated across both Clusters, with one
138138
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:
139+
after it, on the new active Cluster:
157140

158141
```mermaid
159-
flowchart LR
160-
subgraph A["Cluster A — lost or standby"]
161-
caA["Caller Namespace"]
162-
haA["Handler Namespace"]
142+
sequenceDiagram
143+
box Cluster A
144+
participant caA as Caller ns
145+
participant haA as Handler ns
163146
end
164-
subgraph B["Cluster B — now active"]
165-
haB["Handler Namespace"] -->|completion callback| caB["Caller Namespace"]
147+
box Cluster B
148+
participant caB as Caller ns
149+
participant haB as Handler ns
166150
end
167-
caA -. replicated .- caB
168-
haA -. replicated .- haB
151+
Note over caA,haA: Cluster A active
152+
caA->>haA: start Nexus Operation
153+
haA-->>caA: Operation started, token returned
154+
Note over caA,haB: Namespace state replicates A to B
155+
Note over caA,haB: failover, active moves to Cluster B
156+
Note over caB,haB: Cluster B active
157+
haB->>caB: completion delivered (callback)
158+
Note over caB: Caller Workflow completes
169159
```
170160

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

0 commit comments

Comments
 (0)