Working with Multiple Environments(使用多个环境)

Working with Multiple Environments

ASP.NET 5提高了跨多环境控制应用程序行为的支持。比如：开发，过度，生产。环境变量用来表明应用程序运行的环境，允许适当配置应用程序。

In this article(在这篇文章中主要介绍的章节如下):

• Development, Staging, Production

• Determining the environment at runtime

• Startup conventions Browse or download samples on GitHub.

Development, Staging, Production

ASP.NET 5引用特定的环境变量。ASPNET_ENV(or Hosting:Environment)描述了当前正在运行的应用程序的环境。这个变量可以设置任何值，但是按照惯例使用三个值，分别为：Development, Staging, and Production。您将发现这些值用于ASP.NET 5提高那个的样品和模板中。

当前环境设置能从ASP.NET 5检测到所使用的编程方式，此外，ASP.NET MVC6介绍了Environment Tag Helper，Environment Tag Helper允许MVC视图包括基于当前应用程序环境的某些部分。

Development

下面是开发应用程序时使用的环境。用Visual Studio 2015时，在项目的调试配置文件中指定环境设置，比如IIS Express,如下图所示：

当修改已创建项目的默认设置，更改在Properties文件夹中的launchSettings.json中被持久化，包括用到的任何环境变量。在Web配置文件改变 ASPNET_ENV (or Hosting:Environment) 变量为Staging之后，launchSettings.json文件如下所示：

{
  "iisSettings": { 
     "windowsAuthentication": false,
     "anonymousAuthentication": true,
     "iisExpress": {  
        "applicationUrl": "http://localhost:40088/", 
        "sslPort": 0 
                    } 
    }, 
  "profiles": {
     "IIS Express": { 
         "commandName": "IISExpress",
         "launchBrowser": true, 
         "environmentVariables": {
              "ASPNET_ENV": "Development" 
            }  
       }, 
     "web": { 
         "commandName": "web",
         "environmentVariables": {
               "Hosting:Environment": "Staging"
           } 
      } 
  } 
}

　　 Staging环境是预生产环境，在生产环境之前用来最终测试，理想的情况是，它的物理特性能反应项目产品，以至于任何问题在Staging环境中第一次出现时就能解决而不影响客户的使用。

Production(产品)

应用程序运行并被用户使用的环境是Procuction环境。这个环境应该被配置最大的安全性，性能和应用程序的健壮性，production环境中可能有的一些公共设置和开发时有所不同，包括以下。

Turn on caching

Ensure all client-side resources are bundled, miniﬁed, and potentially served from a CDN

Turn off diagnostic ErrorPages

Turn on friendly error pages
Enable production logging and monitoring (for example, Application Insights)

这不是一个完整的列表，最好避免在应用程序的很多部分进行分散环境检查。相反，推荐的方法是尽量在应用程序的Startup类(cs)中执行这种检查。

Determining the environment at runtime(在运行时决定使用环境)

为了正常工作，IHostingEnvironment服务提供了带有环境的核心抽象概念，ASP.NET hosting层提供了该服务并且通过依赖注入将这个服务注入到启动逻辑中。Visual Studio中的ASP.NET 5 网站模板用这种方法加载特定环境的配置文件(if present),并自定义应用程序的错误处理设置。在这2种情况下，目前指定环境通过调用 EnvironmentName 或者IsEnvironment 将IHostingEnvironment 的实例传递给适当的方法来实现这种行为的。

如果需要检查在特定的环境中，应用程序是否运行，用env.IsEnvironment("environmentname") ，它能正确地忽略大小写。

例如，可以使用以下代码在Conﬁgure方法中设置环境的具体错误操作：

if (env.IsDevelopment()) 
 { 
   app.UseBrowserLink();  
   app.UseDeveloperExceptionPage(); 
   app.UseDatabaseErrorPage(); 
  } 
 else 
 { 
   app.UseExceptionHandler("/Home/Error"); 
 }

　　如果应用程序在开发环境中正常运行，它可能BrowserLink ,开发特定的错误页，否则，配置一个标准的错误页作为对任何未处理异常的响应显示出来。

Startup conventions(启动约定)

ASP.NET 5支持基于协议的方法在当前环境中配置应用程序的启动。也可以根据环境通过编程的方式控制应用程序的执行，并允许创建和管理自己的协议。

当ASP.NET应用程序启动时，启动类启动应用程序，加载配置设置等（到ASP.NET startup了解更多）。然而，如果存在名为Startup{EnvironmentName}的类，（比如StartupDevelopment），ASPNET_ENV环境变量和这个名相匹配，使用启动类。开发时可以配置启动项，当应用程序在Production的环境中运行，将使用一个单独的StartupProduction。反之亦然。

当应用程序在Development环境中被设置成运行，以下示例项目中的StartupDevelopment将运行。

在开发期间，运行应用程序，显示欢迎屏幕，示例还包括一个StartupStaging类：

当ASPNET_ENV设置成Staging，并且应用程序运行，使用StartupStaging类，应用程序将显示字符串声明，并运行在staging 环境中。当环境没有设置成Development或者是Staging时，会运行应用程序默认的Startup类。(据推测,设置为Production,而不是仅限于这三个选项。还要注意,如果没有环境设置,运行默认启动)。

除了在当前环境下使用完全独立的Startup类，也可以重新在Startup类中配置应用。Configure[Environment]() 和 Configure[Environment]Services()中的Configure()和ConfigureServices()方法支持特定环境的版本，和Startup类本身类似。如果定义了ConfigureDevelopment方法，当环境设置为development时，它将被调用，而不是调用Configure（），同样，在同样的环境中ConfigureDevelopmentServices()方法将被调用，而不是ConfigureServices()方法。

using Microsoft.AspNet.Builder;
namespace Environments 
 { 
    public class StartupDevelopment 
     { 
         public void Configure(IApplicationBuilder app) 
          { 
            app.UseWelcomePage(); 
          } 
      } 
 }

 using Microsoft.AspNet.Builder; 
 using Microsoft.AspNet.Http; 
 
 namespace Environments 
  {
    public class StartupStaging 
      { 
        public void Configure(IApplicationBuilder app) 
          { 
            app.Run(async context => 
            { 
             context.Response.ContentType = "text/plain"; 
             await context.Response.WriteAsync("Staging environment."); 
             }); 
          } 
      } 
 }

　　总结

ASP.NET 5提供类很多特性和协议，允许开发人员在不同的环境中控制应用程序如何执行。当发布应用程序从development到staging到production。环境变量设置适当的环境，允许对应用程序调试，测试或者使用进行优化。

更多资源

Conﬁguration