为Docker创建自动化nginx反向代理

翻译。原文见： http://jasonwilder.com/blog/2014/03/25/automated-nginx-reverse-proxy-for-docker/

反向代理服务器是一种通常位于web服务器之前的服务器，它可以提供web服务器本身没有的附件功能。

例如，反向代理可以提供SSL终结、负载均衡、请求路由、缓存、压缩，甚至A/B测试。

当用docker容器运行web服务时，运行一个反向代理可以简化部署。

**

为什么为docker使用反向代理？

**
docker容器被分配随机的IP和端口，这使得从客户端的角度来定位这些容器比较困难。默认地，这些IP和端口是私有的，不能从外部访问，除非它们和宿主机绑定。

把容器和宿主机绑定，会阻止运行在同一个端口上的容器。例如，每次都只能有一个docker绑定到端口80。另外，这也使得部署新版本的容器变得复杂。因为新版本只有在旧版本停止服务后，才能启动服务。

反向代理可以解决上面的这些问题，同时通过提供0宕机时间来改进可靠性。

**

产生反向代理配置

**

当容器启动和停止时，设置反向代理的配置是一件负责的事情。通常配置需要手动更新，这需要大量的时间，而且容易出错。

幸运的是，docker提供了一个远程调用API，可以观察容易，并访问容器的IP和端口，已经配置元数据。另外，docker也提供了一个实时事件API，当容器启动和停止时，可以用来发送通知。这些API可以用来自动生成反向代理配置。

docker-gen是一个小应用。它使用docker的API，把容器的元数据导入模板。生成模板后，可以用它重启服务。

使用docker-gen，可以自动生成nginx配置，并当配置发生改变时，重新加载nginx。同样的方法可以用在docker log管理上。

**

针对docker的nginx反向代理

**
下面的nginx模板例子可以用来生成docker容器的反向代理配置。这个模板使用golang。groupby模板函数被用来给运行中的容器分组，分组是基于VIRTUAL_HOST环境变量做的。这个方式简化了遍历容器，以便生成负载均衡的后台，同时也支持了0宕机的部署。

{{ range host, containers := groupBy “Env.VIRTUAL_HOST” }}  
upstream {{host }} {

{{ range index, value := containers }}  
    {{ withaddress := index value.Addresses 0 }}  
    server {{address.IP }}:{{ $address.Port }};
{{ end }}
{{ end }}

}

server {
#ssl_certificate /etc/nginx/certs/demo.pem;
#ssl_certificate_key /etc/nginx/certs/demo.key;

gzip_types text/plain text/css application/json application/x-javascript
           text/xml application/xml application/xml+rss text/javascript;

server_name {{ $host }};

location / {
    proxy_pass http://{{ $host }};
    include /etc/nginx/proxy_params;
}

}
{{ end }}

这个模板使用下面的命令运行：
docker-gen -only-exposed -watch -notify “/etc/init.d/nginx reload” templates/nginx.tmpl /etc/nginx/sites-enabled/default

-only-exposed - 仅使用暴露出端口的容器.
-watch - 运行后，观察容器的事件，并重新生成模板.
-notify "/etc/init.d/nginx reload" - 重新加载nginx.
templates/nginx.tmpl - nginx模板.
/etc/nginx/sites-enabled/default - 目标文件.

下面是配置了两个容器demo1和demo2的模板

upstream demo1.localhost {
server 172.17.0.4:5000;
server 172.17.0.3:5000;
}

server {
#ssl_certificate /etc/nginx/certs/demo.pem;
#ssl_certificate_key /etc/nginx/certs/demo.key;

gzip_types text/plain text/css application/json application/x-javascript
           text/xml application/xml application/xml+rss text/javascript;

server_name demo1.localhost;

location / {
    proxy_pass http://demo.localhost;
    include /etc/nginx/proxy_params;
}

}

upstream demo2.localhost {
server 172.17.0.5:5000;
}

server {
#ssl_certificate /etc/nginx/certs/demo.pem;
#ssl_certificate_key /etc/nginx/certs/demo.key;

gzip_types text/plain text/css application/json application/x-javascript
           text/xml application/xml application/xml+rss text/javascript;

server_name demo2.localhost;

location / {
    proxy_pass http://demo2.localhost;
    include /etc/nginx/proxy_params;
}

}

**

尝试一下

**

可以尝试一下我做好的build。 https://index.docker.io/u/jwilder/nginx-proxy/
运行nginx代理容器：
dockerrun−d−p80:80−v/var/run/docker.sock:/tmp/docker.sock−tjwilder/nginx−proxy配置VIRUTALHOST环境变量，启动你的容器： docker run -e VIRTUAL_HOST=foo.bar.com -t …

如果你使用HTTPS，想运行其他的容器，可以看看github上的项目，以得到更多的信息。

**

结论

**
为docker容器生成nginx反向代理配置，可以通过使用docker API自动的完成。这个方式可以简化部署，提供可用性。

这个方案对运行在单个host上的容器很方便。为分布式主机提供配置依赖服务发现。可以看看docker服务发现的内容，然后找到解决方案。