Merge pull request #4288 from apenney/add-warning-to-docs

Add a warning not to share consul nodes

website/source/docs/agent/configuration/consul.html.md

@@ -41,6 +41,12 @@ cluster with zero configuration. To put it another way: if you have a Consul
 agent running on the same host as the Nomad agent with the default
 configuration, Nomad will automatically connect and configure with Consul.
 
+An important requirement is that each Nomad agent talks to a unique Consul
+agent. Nomad agents should be configured to talk to Consul agents and not
+Consul servers. If you are observing flapping services, you may have have
+multiple Nomad agents talking to the same Consul agent. As such avoid
+configuring Nomad to talk to Consul via DNS such as consul.service.consul
+
 ## `consul` Parameters
 
 - `address` `(string: "127.0.0.1:8500")` - Specifies the address to the local