本文讲的是结合Docker Compose，将Nginx反向代理和负载均衡使用于ASP.NET 5应用，【编者的话】该文章描述了Nginx在ASP.NET 5中的使用，它提供了一个运行在本地的负载均衡机制，并使用Docker Compose技术。
ASP.NET 5，对于不同的操作系统，以及不同的Web服务，如IIS，有多种不同的宿主选择。Filip W有大量的博客帖子，都是运行在基于IIS服务的ASP.NET 5网站上。在此，我主要描述了NGINX在ASP.NET 5中的使用，它提供了一个运行在本地的负载均衡机制，并使用Docker Compose技术。
太好啦！#aspnet5 + #nginx + #docker + #docker compose，组成简单的负载均衡 :)https://t.co/YnJamDubIS pic.twitter.com/pBOWDDnVHR我们得出的结果如下图所示，我把实例放在此处：
— Tugberk Ugurlu (@tourismgeek) 2016.1.26
在之前的.NET网页开发中，我们不曾有这些选择。举个例子，你可以很熟练的在Mono项目中使用ASP.NET Web API应用，并暴露在Nginx的下层。但是，ASP.NET 5使这些选项可以真正的直接被采用。
在RC1上的APS.NET 5应用
我有一个非常简单的APS.NET 5应用，输出一个Hello信息，列出该主机上的环境变量。该项目结构如下：tugberk@ubuntu:~/apps/aspnet-5-samples/nginx-lb-sample$ tree . ├── docker-compose.yml ├── docker-nginx.dockerfile ├── docker-webapp.dockerfile ├── global.json ├── nginx.conf ├── NuGet.Config ├── README.md └── WebApp ├── hosting.json ├── project.json └── Startup.cs
我没有把源码放在这里，但是你可以在这里找到，。但是，我必须强调一点，通过Kestrel暴露给ASP.NET 5应用的Server URL应该是多少。为了Docker使用，我们需要配置“0.0.0.0”，而不是localhost或者127.0.0.1。Mark Rendle有很多描述来说明这个问题，我给出的如下文件hosting.json也同样覆盖了这个问题：
{
"server": "Microsoft.AspNet.Server.Kestrel",
"server.urls": "http://0.0.0.0:5090"
}
Docker在ASP.NET 5应用中的应用
下一步是在Docker下运行ASP.NET 5应用。在Docker Hub资源库中有ASP.NET 5 Docker镜像，特别的简单。另外，Mark Rendle有三篇很有洞察力的关于ASP.NET 5，Docker和Linux混合使用的文章，Part1， Part2和Part3 。强烈建议大家阅读下这些文章。我有个实例，其Dockerfile（指向该文件）如下：FROM microsoft/aspnet:1.0.0-rc1-update1 COPY ./WebApp/project.json /app/WebApp/ COPY ./NuGet.Config /app/ COPY ./global.json /app/ WORKDIR /app/WebApp RUN ["dnu", "restore"] ADD ./WebApp /app/WebApp/ EXPOSE 5090 ENTRYPOINT ["dnx", "run"]
这就是Docker下面运行ASP.NET 5的简单的Dockerfile文件，下面生成Docker镜像并运行该镜像：
docker build -f docker-webapp.dockerfile -t hellowebapp . docker run -d -p 5090:5090 hellowebapp
该容器现在是以分离模式运行，你可以从主机访问HTTP终端。
现在，你可以对这个Container做任何你想要做的事情。重新编译，停止，移除，等等。
Nginx 和 Docker Compose
该篇章的最后一部分是Nginx和Docker Compose。对于还不了解Nginx的人员，Nginx是一个免费、开源的，高性能的HTTP服务器和反向代理。在实际开发环境中，你并不想把Kestrel直接暴露给外部。相反，你可以把Kestrel放在一个成熟的Web服务器后面，如Nginx，IIS或者Apache Web Server。有两个很好的录像，你可以看下有关Kerstrel和Linux主机。从视频中可以知道为什么把Kestrel放在一个Web服务器后面。我强烈建议你在Linux中使用这些应用之前看下这些视频录像。Docker Compose，从不同角度看是一个完全不同的工具类型，定义并运行多容器的Docker应用。使用Compose，你可以使用一个Compose文件去配置自己的应用服务。这对于我们在此想要实现的项目是一个完美的结合，因为我们至少要三个运行的容器：
- ASP.NET 5 应用1： ASP.NET 5应用的一个实例
- ASP.NET 5 应用2：另一个ASP.NET 5应用的实例
- Nginx容器：一个Nginx进程，代理请求到ASP.NET 5应用
首先开始配置Nginx，让其可以在Docker下运行。Nginx镜像在Docker Hub已经存在。我们将会使用该镜像，并使用如下的Nginx配置：
worker_processes 4;
events { worker_connections 1024; }
http {
upstream web-app {
server webapp1:5090;
server webapp2:5090;
}
server {
listen 80;
location / {
proxy_pass http://web-app;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
}
该配置文件中除了些通用的配置，重要的是负载均衡和反向代理的配置。在该配置文件中，Nginx服务器接收来自80端口的请求，然后代理这些请求给webapp1:5090和webapp2:5090。了解更多有关NGINX反向代理和负载均衡的信息，从中可以知道如何配置代理和负载均衡，上面的例子也足以说明。
在NGINX配置中，还有一个重要的部分。Kestrel在RC1中有一个很让人头疼的问题，该问题在RC2中已经解决了。为了临时解决这个问题，你需要设置“Connection: keep-alive”头，这就是为什么我们在NGINX配置中做"proxy_set_header Connection keep-alive;"说明。下面就是Nginx的Dockerfile文件（Github中地址）：
FROM nginx COPY ./nginx.conf /etc/nginx/nginx.conf
到此，你也许会问webapp1和webapp2（我们在Nginx配置中已经说明）映射到什么变量。这些是为运行ASP.NET 5应用的容器做的DNS引用，当我们在Docker Compose文件中引用webapp1和webapp2，该DNS映射将会自动生效。最后，下面就是组织出的Docker Compose文件内容（Github中地址）：
webapp1: build: . dockerfile: docker-webapp.dockerfile container_name: hasample_webapp1 ports: - "5091:5090" webapp2: build: . dockerfile: docker-webapp.dockerfile container_name: hasample_webapp2 ports: - "5092:5090" nginx: build: . dockerfile: docker-nginx.dockerfile container_name: hasample_nginx ports: - "5000:80" links: - webapp1 - webapp2
你可以看到第三个容器的定义，我们链接之前定义的两个容器到Nginx容器。或者，你也许想要在Docker的上下文中查看Service Discovery来替换链接。
现在，我们都已经准备完毕，只需要运行两个docker-compose命令（在Docker Compose文件的目录下面）去启动该应用并运行：
docker-compose build docker-compose up
到目前，我们可以看到三个正在运行的容器，也可以从主机终端访问localhost:5000，可以看到负载被分发到两台ASP.NET 5应用的容器上。
棒极了！但是，这只是演示的一个简单例子，目的是说明在本地运行一个像这样的应用是很容易的。这可能对所有的容器运行在一个盒子中的场景不提供性能保障。我的下一步是融入HAProxy，让它做负载均衡。
原文链接：NGINX Reverse Proxy and Load Balancing for ASP.NET 5 Applications with Docker Compose（翻译：史跃珍）
原文发布时间为：2016-01-27
本文作者：梦中鹤
本文来自云栖社区合作伙伴DockerOne，了解相关信息可以关注DockerOne。
原文标题：结合Docker Compose，将Nginx反向代理和负载均衡使用于ASP.NET 5应用