|
1 | 1 | # Bootstrapping Overview |
2 | 2 |
|
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. |
4 | 4 |
|
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> |
9 | 14 |
|
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._ |
0 commit comments