IBM® Bluemix 上运行ASP.NET Core

IBM® Bluemix® 上的“ASP.NET 核心”运行时采用“ASP.NET 核心”buildpack 技术。“ASP.NET 核心”是用于构建 .NET Web 应用程序的模块化开放式源代码框架。“.Net 核心”是跨平台的小型运行时，可由“ASP.NET 核心”应用程序实现。将它们相结合可实现基于云的先进 Web 应用程序。

检测

如果应用程序中的任何位置存在一个或多个包含 project.json 文件和至少一个 .cs 文件的文件夹，或者应用程序是从 dotnet publish 命令的输出目录进行推送，那么将使用 Bluemix 的“ASP.NET 核心”buildpack。

入门模板应用程序

IBM® Bluemix® 提供了“ASP.NET 核心”入门模板应用程序。“ASP.NET 核心”入门模板应用程序是一个简单的应用程序，它提供了一个可供您使用的模板。您可以体验该入门模板应用程序，对其进行更改并将更改推送到 Bluemix 环境。有关使用入门模板应用程序的帮助，请参阅使用入门模板应用程序。

运行时版本

指定 .NET CLI 版本

使用应用程序根目录中的可选 global.json 来控制 .NET CLI 版本。例如：

   {      "projects": [ "src" ],      "sdk": {        "version": "1.0.0-preview1-002702"      }   }

如果未指定，将使用稳定的最新候选发布版本。

定制 NuGet 数据包源

在应用程序根目录中的 NuGet.Config 文件中控制应用程序依赖项的下载来源位置。例如：

   <?xml version="1.0" encoding="utf-8"?>   <configuration>   <packageSources>      <add key="NuGet.org" value="https://api.nuget.org/v3/index.json"/>   </packageSources>   </configuration>

在本地开发应用程序

有关在本地运行“ASP.NET 核心”应用程序的更多信息，请参阅 ASP.NET 入门。要尽量匹配应用程序在 Bluemix 中的运行方式，请遵循 Linux 中有关“.NET 核心”的指示信息，但无需在 Linux 上开发应用程序。

使用 Yeoman 工具可生成新的项目模板，如 Building Projects with Yeoman 中所述。

推送发布的应用程序

如果想要在应用程序中包含其需要的所有二进制文件，以使 buildpack 无需下载任何外部二进制文件，您可以推送发布的自包含应用程序。请参阅 Types of portability in .Net Core，以获取有关自包含应用程序的更多信息。

要发布应用程序，请发出类似如下命令：

dotnet publish -r ubuntu.14.04-x64

然后即可从

  bin/<Debug|Release>/<framework>/<runtime>/publish

目录推送应用程序。

另请注意，如果在应用程序中使用 manifest.yml 文件，您可以在 manifest.ymle 中指定发布输出文件夹的路径。之后在推送应用程序时，您无需位于该文件夹中。

部署包含多个项目的应用程序

要部署包含多个项目的应用程序，您需要指定希望 buildpack 将哪个项目作为主要项目运行。在解决方案的根文件夹中创建 .deployment 文件来设置主要项目的路径即可完成此操作。您可以将主要项目的路径指定为项目文件夹或项目文件（.xproj 或 .csproj）。

例如，如果解决方案的 src 文件夹中包含 MyApp.DAL、MyApp.Services 和 MyApp.Web 这三个项目，其中 MyApp.Web 是主要项目，那么 .deployment 文件的格式应如下所示：

   [config]  project = src/MyApp.Web

在此示例中，如果在 project.json 文件中将 MyApp.DAL 和 MyApp.Services 项目列为 MyApp.Web 的依赖项，那么 buildpack 会自动编译这两个项目，但 buildpack 只会尝试使用 dotnet run -p src/MyApp.Web 执行主要项目 MyApp.Web。假定 MyApp.Web 为 xproj 项目，那么此项目的路径还可指定为

project = src/MyApp.Web/MyApp.Web.xproj

使用 cli 样本存储库中的样本以及 Visual Studio 模板

buildpack 将使用 dotnet run 命令运行您的应用程序，并传递以下内容之后的命令行自变量

--server.urls http://0.0.0.0:${PORT}

应用程序需要将此自变量传递到 kestrel，以确保 kestrel 侦听正确的端口。

要实现此自变量的传递，需要对 cli 样本存储库中提供的样本以及 Visual Studio 提供的模板稍作修改，然后再部署到 Bluemix。

您需要根据以下示例中的注释对 Main 方法进行修改：

public static void Main(string[] args)  { 
 var config = new ConfigurationBuilder() //ADD THESE 3 LINES AT THE TOP OF THE MAIN METHOD        .AddCommandLine(args)        .Build();    var host = new WebHostBuilder()        .UseKestrel()        .UseConfiguration(config) //ADD THIS LINE BEFORE 'UseStartup'        .UseStartup<Startup>()          .Build();    host.Run(); }