From c6f869b04b69151ac416b3c4d148641afe2edc6a Mon Sep 17 00:00:00 2001 From: Rob Genova Date: Sat, 19 Aug 2017 00:13:26 +0000 Subject: [PATCH] reword for clarity; note that data is not replicated between regions --- .../source/docs/internals/architecture.html.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/website/source/docs/internals/architecture.html.md b/website/source/docs/internals/architecture.html.md index 8d5864dab..e9d5013f5 100644 --- a/website/source/docs/internals/architecture.html.md +++ b/website/source/docs/internals/architecture.html.md @@ -60,13 +60,14 @@ clarify what is being discussed: The servers replicate data between each other and perform leader election to ensure high availability. Servers federate across regions to make Nomad globally aware. -* **Regions and Datacenters** - Nomad models infrastructure as regions and datacenters. - Regions may contain multiple datacenters. For example, you may have a `US` region with the - `us-east-1` and `us-west-1` datacenters, connected to the `EU` region with the `eu-fr-1` and - `eu-uk-1` datacenters. Servers are assigned to regions and manage all state for the region and - make scheduling decisions within that region. When multiple regions are federated together, - requests that are made between them are forwarded to the appropriate servers. Data is _not_ - replicated between regions. +* **Regions and Datacenters** - Nomad models infrastructure as regions and + datacenters. Regions may contain multiple datacenters. Servers are assigned to + a specific region, managing state and making scheduling decisions within that + region. Multiple regions can be federated together. For example, you may + have a `US` region with the `us-east-1` and `us-west-1` datacenters, + connected to the `EU` region with the `eu-fr-1` and `eu-uk-1` datacenters. + Requests that are made between regions are forwarded to the appropriate servers. + Data is _not_ replicated between regions. * **Bin Packing** - Bin Packing is the process of filling bins with items in a way that maximizes the utilization of bins. This extends to Nomad, where the clients are "bins" @@ -93,7 +94,8 @@ At a high level, this setup looks like this: Regions are fully independent from each other, and do not share jobs, clients, or state. They are loosely-coupled using a gossip protocol, which allows users to submit jobs to any region or query the state of any region transparently. Requests -are forwarded to the appropriate server to be processed and the results returned. +are forwarded to the appropriate server to be processed and the results returned. +Data is _not_ replicated between regions. The servers in each region are all part of a single consensus group. This means that they work together to elect a single leader which has extra duties. The leader