github.com/taylorchu/nomad@v0.5.3-rc1.0.20170407200202-db11e7dd7b55/website/source/guides/cluster/federation.md (about)

     1  ---
     2  layout: "guides"
     3  page_title: "Federating a Nomad Cluster"
     4  sidebar_current: "guides-cluster-federation"
     5  description: |-
     6    Learn how to join Nomad servers across multiple regions so users can submit
     7    jobs to any server in any region using global federation.
     8  ---
     9  
    10  # Federating a Cluster
    11  
    12  Because Nomad operates at a regional level, federation is part of Nomad core.
    13  Federation enables users to submit jobs or interact with the HTTP API targeting
    14  any region, from any server, even if that server resides in a different region.
    15  
    16  Federating multiple Nomad clusters is as simple as joining servers. From any
    17  server in one region, issue a join command to a server in a remote region:
    18  
    19  ```shell
    20  $ nomad server-join 1.2.3.4:4648
    21  ```
    22  
    23  Note that only one join command is required per region. Servers across regions
    24  discover other servers in the cluster via the gossip protocol and hence it's
    25  enough to join just one known server.
    26  
    27  If bootstrapped via Consul and the Consul clusters in the Nomad regions are
    28  federated, then federation occurs automatically.