clarify networking docs

This commit is contained in:
Alex Dadgar 2018-03-16 16:12:02 -07:00
parent b8607ad6d6
commit 3963492977
1 changed files with 11 additions and 8 deletions

View File

@ -37,13 +37,12 @@ Here is an example Nomad agent configuration that runs in both client and server
mode.
```hcl
bind_addr = "0.0.0.0" # the default
data_dir = "/var/lib/nomad"
bind_addr = "0.0.0.0" # the default
advertise {
# Defaults to the node's hostname. If the hostname resolves to a loopback
# address you must manually configure advertise addresses.
# Defaults to the first private IP address.
http = "1.2.3.4"
rpc = "1.2.3.4"
serf = "1.2.3.4:5648" # non-default ports may be specified
@ -97,7 +96,9 @@ testing.
configurations such as NAT. This configuration is optional, and defaults to
the bind address of the specific network service if it is not provided. Any
values configured in this stanza take precedence over the default
[bind_addr](#bind_addr). If the bind address is `0.0.0.0` then the first
[bind_addr](#bind_addr).
If the bind address is `0.0.0.0` then the address
private IP found is advertised. You may advertise an alternate port as well.
The values support [go-sockaddr/template format][go-sockaddr/template].
@ -105,12 +106,14 @@ testing.
reachable by all the nodes from which end users are going to use the Nomad
CLI tools.
- `rpc` - The address to advertise for the RPC interface. This address should
be reachable by all of the agents in the cluster.
- `rpc` - The address advertised to Nomad client nodes. This allows
advertising a different RPC address than is used by Nomad Servers such that
the clients can connect to the Nomad servers if they are behind a NAT.
- `serf` - The address advertised for the gossip layer. This address must be
reachable from all server nodes. It is not required that clients can reach
this address.
this address. Nomad servers will communicate to each other over RPC using
the advertised Serf IP and advertised RPC Port.
- `bind_addr` `(string: "0.0.0.0")` - Specifies which address the Nomad
agent should bind to for network services, including the HTTP interface as