Docker 17
引擎: 管理员指南 | Engine: Admin Guide

通过大使容器链接(引擎) | Link via an ambassador container (Engine)

通过大使容器链接

Docker没有硬编码服务使用者和提供者之间的网络链接,而是鼓励服务可移植性,例如:

(consumer) --> (redis)

需要重新启动consumer将它附加到另一个redis服务,您可以添加大使:

(consumer) --> (redis-ambassador) --> (redis)

(consumer) --> (redis-ambassador) ---network---> (redis-ambassador) --> (redis)

当您需要重新连接您的使用者以与另一台Redis服务器对话时,您可以重新启动redis-ambassador连接到的容器。

此模式还允许您透明地将Redis服务器移动到与使用者不同的停靠主机。

使用svendowideit/ambassador容器,则链接布线完全由docker run参数。

两个主机示例

在一个Docker主机上启动实际的Redis服务器

big-server $ docker run -d --name redis crosbymichael/redis

然后添加链接到Redis服务器的大使,将端口映射到外部世界。

big-server $ docker run -d --link redis:redis --name redis_ambassador -p 6379:6379 svendowideit/ambassador

在另一个主机上,您可以为我们要代理的每个远程端口设置另一个大使设置环境变量。big-server

client-server $ docker run -d --name redis_ambassador --expose 6379 -e REDIS_PORT_6379_TCP=tcp://192.168.1.52:6379 svendowideit/ambassador

然后在client-server主机,您可以使用Redis客户端容器与远程Redis服务器对话,只需链接到本地Redis大使即可。

client-server $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli redis 172.17.0.160:6379> ping PONG

它是如何工作的

下面的示例显示了svendowideit/ambassador容器自动执行%28,只需少量的sed%29

在Docker主机%28192.168.1.52%29上,Redis将在其上运行:

# start actual redis server $ docker run -d --name redis crosbymichael/redis # get a redis-cli image for connection testing $ docker pull relateiq/redis-cli # test the redis server by talking to it directly $ docker run -t -i --rm --link redis:redis relateiq/redis-cli redis 172.17.0.136:6379> ping PONG ^D # add redis ambassador $ docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 alpine:3.2 sh

redis_ambassador容器,您可以看到链接的Redis容器。env*

/ # env REDIS_PORT=tcp://172.17.0.136:6379 REDIS_PORT_6379_TCP_ADDR=172.17.0.136 REDIS_NAME=/redis_ambassador/redis HOSTNAME=19d7adf4705e SHLVL=1 HOME=/root REDIS_PORT_6379_TCP_PORT=6379 REDIS_PORT_6379_TCP_PROTO=tcp REDIS_PORT_6379_TCP=tcp://172.17.0.136:6379 TERM=xterm PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin PWD=/ / # exit

这个环境由大使使用。socat脚本将Redis公开给世界%28通过-p 6379:6379端口映射%29:

$ docker rm redis_ambassador $ CMD="apk update && apk add socat && sh" $ docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 alpine:3.2 sh -c "$CMD" [...] / # socat -t 100000000 TCP4-LISTEN:6379,fork,reuseaddr TCP4:172.17.0.136:6379

现在通过大使平Redis服务器:

现在转到另一个服务器:

$ CMD="apk update && apk add socat && sh" $ docker run -t -i --expose 6379 --name redis_ambassador alpine:3.2 sh -c "$CMD" [...] / # socat -t 100000000 TCP4-LISTEN:6379,fork,reuseaddr TCP4:192.168.1.52:6379

得到redis-cli这样我们就可以在大使桥上谈了。

$ docker pull relateiq/redis-cli $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli redis 172.17.0.160:6379> ping PONG

商业银行/大使文件

svendowideit/ambassador图像是基于alpine:3.2图像socat安装好了。启动容器时,它使用一个小的sed脚本来解析%28,可能是多个%29链接环境变量来设置端口转发。在远程主机上,需要使用-e命令行选项。

--expose 1234 -e REDIS_PORT_1234_TCP=tcp://192.168.1.52:6379

将当地1234到远程IP和端口的端口,在本例中192.168.1.52:6379...

# # do # docker build -t svendowideit/ambassador . # then to run it (on the host that has the real backend on it) # docker run -t -i -link redis:redis -name redis_ambassador -p 6379:6379 svendowideit/ambassador # on the remote host, you can set up another ambassador # docker run -t -i -name redis_ambassador -expose 6379 -e REDIS_PORT_6379_TCP=tcp://192.168.1.52:6379 svendowideit/ambassador sh # you can read more about this process at https://docs.docker.com/articles/ambassador_pattern_linking/ # use alpine because its a minimal image with a package manager. # prettymuch all that is needed is a container that has a functioning env and socat (or equivalent) FROM alpine:3.2 RUN apk update && \ apk add socat && \ rm -r /var/cache/ CMD env | grep _TCP= | (sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat -t 100000000 TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \&/' && echo wait) | sh

示例用法链接docker文档示例名称名称容器命名