docker-ambassador

镜像概述和主要用途

这是ambassador链接模式的维护版本。该ambassador镜像可用于自动代理链接容器的所有暴露端口，或代理指定IP地址或主机名的特定端口。

核心功能和特性

• 自动代理通过--link参数链接的容器的所有暴露端口
• 支持链接多个容器（当暴露端口无重复时）
• 允许在容器创建后动态指定主机和端口进行映射

使用场景和适用范围

• 需要动态代理一个或多个容器暴露端口的场景
• 链接多个容器并暴露其端口（确保无端口冲突）
• 容器创建后需要动态映射端口以允许外部访问

详细使用方法和配置说明

使用Docker链接自动代理所有暴露端口

通过Docker的--link参数，可让ambassador容器自动代理链接容器的所有暴露端口。

操作示例：

1. 启动一个暴露端口的容器：

   # 启动一个暴露端口的容器
   docker run --rm --name nginx.1 nginx
   

2. 运行ambassador容器并链接到上述容器：

   # 运行ambassador容器
   docker run --rm -ti --link nginx.1 -p 9999:80 -p 8888:443 dokku/ambassador
   

运行ambassador容器将产生如下输出：

Connecting to 172.17.0.4:80 172.17.0.4:443...
2016/01/12 13:03:14 socat[19] E connect(5, AF=2 172.17.0.4:443, 16): Connection refused

注意：可通过多个--link参数链接多个容器，但仅当这些容器的暴露端口没有重复时才支持。

指定主机和端口

此方式允许在容器创建后动态映射其端口。

操作示例：

1. 启动一个暴露端口的容器：

   # 启动一个暴露端口的容器
   docker run --rm --name nginx.1 nginx
   

在上述示例中，nginx容器正在运行，但外部无法直接访问。通过运行以下命令：

2. 指定容器IP和端口进行映射：

   # 假设nginx.1容器的IP为`172.17.0.4`
   docker run --rm -p 9999:80 dokku/ambassador 172.17.0.4 80
   

现在可以通过http://localhost:9999访问web服务器。

致谢

感谢Sven Dowideit提供初始实现。