Skip to content
This repository was archived by the owner on Jun 20, 2024. It is now read-only.

Commit

Permalink
clarify role of IP allocator range
Browse files Browse the repository at this point in the history
Part of #1035.
  • Loading branch information
rade committed Jul 8, 2015
1 parent df31454 commit 26c1bcf
Showing 1 changed file with 8 additions and 8 deletions.
16 changes: 8 additions & 8 deletions site/ipam.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,14 @@ range. This can be overridden with the `-iprange` option, e.g.

and must be the same on every host.

> The specified range is for *exclusive* use by the IP allocator. In
> particular, when starting containers with manually assigned IP
> addresses, these must be outside the IP allocator's range. If, in
> our example, you subsequently executed `docker run -e
> WEAVE_CIDR=10.2.3.1/24 -ti ubuntu`, the IP allocator might assign
> the same address to another container, which will break IP routing
> for the containers sharing an address.
The range parameter is written in
[CIDR notation](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) -
in this example "/16" means the first 16 bits of the address form the
Expand All @@ -108,14 +116,6 @@ the rest (a partition), they can continue to work with the address
ranges they had before isolation, and can subsequently be re-connected
to the rest of the network without any conflicts arising.

Once you have given a range of addresses to the IP allocator, you must
not use any addresses in that range for anything else. If, in our
example, you subsequently executed `docker run -e WEAVE_CIDR=10.2.3.1/24 -ti ubuntu`,
you run the risk that the IP allocator will assign the same address to
another container, which will make network traffic delivery
intermittent or non-existent for the containers that share the same IP
address.

## <a name="subnets"></a>Automatic allocation across multiple subnets

When
Expand Down

0 comments on commit 26c1bcf

Please sign in to comment.