通过大使容器链接（引擎） | 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，文档，示例，名称，名称，容器命名