翻譯自docker官方文檔，原文：https://docs.docker.com/network/overlay/

overlay（覆蓋）式網(wǎng)絡(luò)會(huì)在多個(gè)docker守護(hù)進(jìn)程所在的主機(jī)之間創(chuàng)建一個(gè)分布式的網(wǎng)絡(luò)。這個(gè)網(wǎng)絡(luò)會(huì)覆蓋宿主機(jī)特有的網(wǎng)絡(luò)，并允許容器連接它（包括集群服務(wù)中的容器）來安全通信。顯然，docker會(huì)處理docker守護(hù)進(jìn)程源容器和目標(biāo)容器之間的數(shù)據(jù)報(bào)的路由。

當(dāng)你初始化一個(gè)集群（swarm）或把一個(gè)docker宿主機(jī)加入一個(gè)已經(jīng)存在的集群時(shí)，宿主機(jī)上會(huì)新建兩個(gè)網(wǎng)絡(luò)：

一個(gè)叫ingress的overlay式網(wǎng)絡(luò)，用來處理和集群服務(wù)相關(guān)的控制和數(shù)據(jù)傳輸。當(dāng)你創(chuàng)建一個(gè)集群服務(wù)而且沒有把它連到用戶定義的overlay式網(wǎng)絡(luò)時(shí)，它默認(rèn)會(huì)連到ingress網(wǎng)絡(luò)。

一個(gè)叫docker_gwbridge的bridge式網(wǎng)絡(luò)。用來連接本docker守護(hù)進(jìn)程和集群中的其他守護(hù)進(jìn)程。

你可以用docker network create命令創(chuàng)建用戶定義的overlay式網(wǎng)絡(luò)，就和你創(chuàng)建用戶定義的bridge式網(wǎng)絡(luò)一樣。服務(wù)和容器可以同時(shí)連到多個(gè)網(wǎng)絡(luò)。服務(wù)和容器只能和它所在的網(wǎng)絡(luò)中的其他對象通信。

雖然集群服務(wù)和單獨(dú)的容器都能連到overlay式網(wǎng)絡(luò)，但默認(rèn)的表現(xiàn)和配置兩者都是不同的。因此，本主題后面的內(nèi)容會(huì)分成三部分：應(yīng)用于所有overlay式網(wǎng)絡(luò)的；應(yīng)用于集群服務(wù)中的網(wǎng)絡(luò)的；應(yīng)用于單獨(dú)的容器使用的overlay式網(wǎng)絡(luò)的。

適用于所有overlay網(wǎng)絡(luò)的操作

創(chuàng)建一個(gè)overlay網(wǎng)絡(luò)

✅先決條件

使用overlay網(wǎng)絡(luò)的docker守護(hù)進(jìn)程需要的防火墻規(guī)則

要讓一個(gè)overlay網(wǎng)絡(luò)中的docker主機(jī)能夠相互通信，你需要打開下面的端口：

1.TCP端口2377，用來集群管理相關(guān)的通信

2.TCP和UDP端口7946，用來進(jìn)行節(jié)點(diǎn)之間的通信

3.UDP端口4789，用來進(jìn)行進(jìn)行overlay網(wǎng)絡(luò)上的數(shù)據(jù)傳輸

在你能創(chuàng)建一個(gè)overlay網(wǎng)絡(luò)之前，你要么要通過docker swarm init把你的docker守護(hù)進(jìn)程初始化成一個(gè)集群管理者（swarm manager），要么要通過docker swarm join把它加入到一個(gè)已存在的集群中。

不管哪種方式，默認(rèn)創(chuàng)建并使用的都是叫做ingress的overlay式網(wǎng)絡(luò)。即使你不打算使用集群服務(wù)，也要這么做。

以后你可以創(chuàng)建用戶定義的overlay式網(wǎng)絡(luò)。

要?jiǎng)?chuàng)建一個(gè)用在集群服務(wù)中的overlay式網(wǎng)絡(luò)，用下面所示的命令：

$ docker network create -d overlay my-overlay

要?jiǎng)?chuàng)建一個(gè)既能用于集群服務(wù)，又能用于單獨(dú)的容器來和其他docker守護(hù)進(jìn)程中的單獨(dú)的容器進(jìn)行通信的網(wǎng)絡(luò)，加上--attachable標(biāo)記：

$ docker network create -d overlay --attachable my-attachable-overlay

你可以指定IP地址范圍，子網(wǎng)，網(wǎng)關(guān)和其他選項(xiàng)。細(xì)節(jié)請查看docker network create --help。

overlay網(wǎng)絡(luò)上的加密傳輸

所有的服務(wù)管理相關(guān)的傳輸都默認(rèn)用GCM模式的AES算法加密。集群中的管理節(jié)點(diǎn)每12個(gè)小時(shí)輪換加密用的鍵（key）。

如果要加密應(yīng)用數(shù)據(jù)，在創(chuàng)建網(wǎng)絡(luò)時(shí)加上--opt encrypted。這個(gè)參數(shù)支持在vxlan級別的IPSEC加密。這個(gè)操作會(huì)導(dǎo)致不可忽略的性能下降，所以在應(yīng)用到生產(chǎn)環(huán)境前要先測試。

當(dāng)你開啟overlay加密后，docker會(huì)在所有網(wǎng)絡(luò)中服務(wù)被調(diào)度到的節(jié)點(diǎn)上創(chuàng)建IPSEC 隧道。這些隧道也會(huì)使用GCM模式的AES算法加密，并且每12個(gè)小時(shí)自動(dòng)輪換加密用的鍵（key）。

❌不要把Windows節(jié)點(diǎn)加入到加密通信的overlay網(wǎng)絡(luò)中。

overlay網(wǎng)絡(luò)上的加密通信不支持Windows。如果Windows節(jié)點(diǎn)試圖連接到加密通信的overlay網(wǎng)絡(luò)，不會(huì)報(bào)錯(cuò)，但這個(gè)節(jié)點(diǎn)會(huì)不能和其他節(jié)點(diǎn)通信。

集群模式的overlay網(wǎng)絡(luò)和單獨(dú)的容器

你可以用--opt encrypted --attachable或把沒有被管理的容器加入到網(wǎng)絡(luò)的方式來使用overlay網(wǎng)絡(luò)特性。

$ docker network create --opt encrypted --driver overlay --attachable my-attachable-multi-host-network

修改默認(rèn)的ingress網(wǎng)絡(luò)

大多數(shù)用戶不需要配置ingress網(wǎng)絡(luò)。但docker17.05以及更高版本允許你這么做。如果自動(dòng)選擇的子網(wǎng)段和你網(wǎng)絡(luò)中已存在的網(wǎng)絡(luò)沖突了，或你需要修改其他底層的網(wǎng)絡(luò)設(shè)置比如MTU的時(shí)候，這個(gè)功能就很有用了。

修改ingress網(wǎng)絡(luò)需要?jiǎng)h除再創(chuàng)建它。這就要求你在集群中創(chuàng)建服務(wù)之前完成修改。如果有發(fā)布端口的服務(wù)，在你刪除ingress網(wǎng)絡(luò)之前要先刪除這些服務(wù)。

在ingress網(wǎng)絡(luò)不存在的時(shí)候，已存在的沒有發(fā)布端口的服務(wù)能繼續(xù)提供服務(wù)，但沒有負(fù)載均衡功能。那些發(fā)布端口的服務(wù)比如發(fā)布80端口的WordPress服務(wù)會(huì)受影響。

用docker network inspect ingress檢查ingress網(wǎng)絡(luò)，然后刪除所有所在容器連到ingress的服務(wù)。這些服務(wù)是發(fā)布端口的服務(wù)比如發(fā)布80端口的WordPress服務(wù)。如果所有這些服務(wù)沒有停掉，下一步會(huì)失敗。

刪除ingress網(wǎng)絡(luò)。

$ docker network rm ingress

WARNING! Before removing the routing-mesh network, make sure all the nodes in your swarm run the same docker engine version. Otherwise, removal may not be effective and functionality of newly created ingress networks will be impaired.

Are you sure you want to continue? [y/N]

3.用ingress標(biāo)記創(chuàng)建新的overlay網(wǎng)絡(luò)，加上你想要的配置。下面的例子把MTU配置成1200，把子網(wǎng)設(shè)置成10.11.0.0/16，并把網(wǎng)關(guān)設(shè)成10.11.0.2。

$ docker network create \

 --driver overlay \

 --ingress \

 --subnet=10.11.0.0/16 \

 --gateway=10.11.0.2 \

 --opt com.docker.network.mtu=1200 \

 my-ingress

注意：你也可以把ingerss網(wǎng)絡(luò)命名成其他名字，但只能有一個(gè)。如果你試圖創(chuàng)建第二個(gè)，會(huì)失敗。

4.重啟你在第一步停掉的服務(wù)。

修改docker_gwbridge接口

docker_gwbridge是一個(gè)虛擬網(wǎng)橋，用來連接overlay網(wǎng)絡(luò)（包括ingress網(wǎng)絡(luò)）和一個(gè)特定的docker守護(hù)進(jìn)程的物理網(wǎng)絡(luò)。當(dāng)你初始化一個(gè)集群或把一個(gè)docker宿主機(jī)加入到一個(gè)集群時(shí)，docker會(huì)自動(dòng)創(chuàng)建它，但它不是一個(gè)docker設(shè)備。它存在于docker宿主機(jī)的內(nèi)核中。如果你要修改它的配置，你必須在把宿主機(jī)加入集群前完成，或暫時(shí)把宿主機(jī)從集群中脫離。

停掉docker

刪除docker_gwbridge接口

$ sudo ip link set docker_gwbridge down

$ sudo ip link del name docker_gwbridge

3.啟動(dòng)docker，不要加入或初始化集群

4.用docker network create命令手動(dòng)創(chuàng)建或重新創(chuàng)建docker_gwbridge網(wǎng)橋，加上你自定義的設(shè)置。下面的例子使用10.11.0.0/16子網(wǎng)。

$ docker network create \

--subnet 10.11.0.0/16 \

--opt com.docker.network.bridge.name=docker_gwbridge \

--opt com.docker.network.bridge.enable_icc=false \

--opt com.docker.network.bridge.enable_ip_masquerade=true \

docker_gwbridge

5.初始化或加入集群。由于網(wǎng)橋已經(jīng)存在，docker不會(huì)再用默認(rèn)配置創(chuàng)建它了。

集群服務(wù)中的操作

在overlay網(wǎng)絡(luò)上發(fā)布端口

連到同一個(gè)overlay網(wǎng)絡(luò)的集群服務(wù)會(huì)互相暴露所有端口。如果一個(gè)端口要從服務(wù)外部可訪問到，必須在docker service create或docker service update中用-p或--publish來發(fā)布。

遺留的冒號(hào)分割的語法和新的逗號(hào)分割的語法都是支持的。

更長的語法更好，因?yàn)槟撤N意義上它是自解釋的。