From e9fa5935624bec82da5ed3936551ea5b4082e293 Mon Sep 17 00:00:00 2001 From: Misty Stanley-Jones Date: Thu, 2 Nov 2017 14:59:43 -0700 Subject: [PATCH] Add info about network size limits for swarm mode --- engine/swarm/networking.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/engine/swarm/networking.md b/engine/swarm/networking.md index f69184bb5c..f57a421ee5 100644 --- a/engine/swarm/networking.md +++ b/engine/swarm/networking.md @@ -192,6 +192,17 @@ $ docker network create \ my-network ``` +##### Overlay network size limitations + +You should create overlay networks with `/24` blocks (the default), which limits +you to 256 IP addresses, when you create networks using the default VIP-based +endpoint-mode. This recommendation addresses +[limitations with swarm mode](https://github.com/moby/moby/issues/30820). If you +need more than 256 IP addresses, do not increase the IP block size. You can either +use `dnsrr` endpoint mode with an external load balancer, or use multiple smaller +overlay networks. See [Configure service discovery](#configure-service-discovery) +for more information about different endpoint modes. + #### Configure encryption of application data Management and control plane data related to a swarm is always encrypted.