Skip to content

Commit a35e848

Browse files
shayne-fletchermeta-codesync[bot]
authored andcommitted
bootstrapping overview: add an image (#1902)
Summary: Pull Request resolved: #1902 feedback from yesterday's presentation says we need more of this sort of thing so making a start here: add a figure to the bootstrapping-overview page. Reviewed By: johnwhumphreys Differential Revision: D87146992 fbshipit-source-id: 1bdd68a1c525b5cd7f63eea1709135f1c5b5443c
1 parent a1e5e4c commit a35e848

File tree

2 files changed

+25
-6
lines changed

2 files changed

+25
-6
lines changed
Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,29 @@
11
# Bootstrapping Overview
22

3-
This section explains one concrete, working way to bring up a mesh — the shape shown in the unit test `bootstrap_cannonical_simple`. The later pages break it into layers:
3+
*One sentence:* the controller boots remote hosts, then spawns procs (**1 proc = 1 OS process**). Each host runs one **HostMeshAgent**; **every proc runs its own ProcMeshAgent** supervising that proc’s user/service actors.
44

5-
1. get a proc + instance (control endpoint)
6-
2. use the v0 process allocator and bootstrap handshake to get remote runtimes
7-
3. turn those runtimes into real hosts
8-
4. then spawn procs and actors on those hosts
5+
<figure id="fig-arch" style="text-align:center;">
6+
<img src="image/mesh-elements.png"
7+
alt="High-level architecture"
8+
style="width:60%; display:block; margin:0 auto;">
9+
<figcaption><strong>Figure 1.</strong> High-level architecture of the host, procs, and agents.</figcaption>
10+
<p style="text-align:center; margin-top:0.25rem;">
11+
Legend: ◻︎ = proc · ○ = actor (service or user).
12+
</p>
13+
</figure>
914

10-
For the full, runnable test, see the appendix.
15+
## What you’re looking at
16+
17+
- **Controller process** (left): owns orchestration APIs and kicks off bootstrapping.
18+
- **HostMeshAgent** (one per host): manages host-local resources and the service proc.
19+
- **ProcMeshAgent** (one per proc): supervises that proc’s actors (service + user).
20+
- **Procs** (squares): runtime containers; *1 proc = 1 OS process*.
21+
22+
## Boot sequence (10k-ft)
23+
24+
1. Obtain a **proc + instance** (control endpoint).
25+
2. Use the **v0 process allocator** and **bootstrap handshake** to get remote runtimes.
26+
3. Promote those runtimes into real **hosts** (start HostMeshAgent).
27+
4. **Spawn procs and actors** on those hosts (start proc/ProcMeshAgent, spawn actors).
28+
29+
_For the full, runnable test (see `bootstrap_cannonical_simple`), see the appendix._
87.6 KB
Loading

0 commit comments

Comments
 (0)