dokku/ambassador

docker-ambassador

镜像概述和主要用途

这是https://github.com/SvenDowideit/dockerfiles/tree/master/ambassador%E6%A8%A1%E5%BC%8F%E7%9A%84%E7%BB%B4%E6%8A%A4%E7%89%88%E6%9C%AC%E3%80%82%E8%AF%A5ambassador%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E4%BA%8E%E8%87%AA%E5%8A%A8%E4%BB%A3%E7%90%86%E9%93%BE%E6%8E%A5%E5%AE%B9%E5%99%A8%E7%9A%84%E6%89%80%E6%9C%89%E6%9A%B4%E9%9C%B2%E7%AB%AF%E5%8F%A3%EF%BC%8C%E6%88%96%E4%BB%A3%E7%90%86%E6%8C%87%E5%AE%9AIP%E5%9C%B0%E5%9D%80%E6%88%96%E4%B8%BB%E6%9C%BA%E5%90%8D%E7%9A%84%E7%89%B9%E5%AE%9A%E7%AB%AF%E5%8F%A3%E3%80%82

核心功能和特性

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

使用场景和适用范围

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

详细使用方法和配置说明

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

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

操作示例：

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

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

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

   shell
   # 运行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. 启动一个暴露端口的容器：

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

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

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

   shell
   # 假设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提供初始实现。