将 ASP.NET Core 应用部署到 Azure 应用服务

Azure 应用服务是一个用于托管 Web 应用(包括 ASP.NET Core)的 Microsoft 云计算平台服务

有用资源

Azure 应用文档、教程、示例、操作指南和其他资源由应用服务文档提供。 两个有关托管 ASP.NET Core 应用的重要教程为:

在 Azure 中创建 ASP.NET Core Web 应用
使用 Visual Studio 创建 ASP.NET Core Web 应用,并将其部署到 Windows 上的 Azure 应用服务。

在 Linux 上的应用服务中创建 ASP.NET Core 应用
使用命令行创建 ASP.NET Core Web 应用,并将其部署到 Linux 上的 Azure 应用服务。

有关 Azure 应用服务上可用的 ASP.NET Core 版本,请参阅应用服务仪表板上的 ASP.NET Core

订阅应用服务公告存储库并监视问题。 应用服务团队会定期发布应用服务中的公告和方案。

ASP.NET Core 文档中提供以下文章:

使用 Visual Studio 将 ASP.NET Core 应用发布到 Azure
了解如何使用 Visual Studio 将 ASP.NET Core 应用发布到 Azure 应用服务。

<xref:host-and-deploy/azure-apps/azure-continuous-deployment>
了解如何使用 Visual Studio 创建 ASP.NET Core Web 应用并使用 Git 将它部署到 Azure 应用服务以实现持续部署。

创建第一个管道
为 ASP.NET Core 应用设置 CI 生成,然后创建针对 Azure 应用服务的持续部署发布。

Azure Web 应用沙盒
探索 Azure Apps 平台强制实施的 Azure 应用服务运行时执行限制。

ASP.NET Core 项目故障排除和调试
理解 ASP.NET Core 项目的警告和错误,并对其进行故障排除。

应用程序配置

Platform

对于在 A 系列计算(基本)上或更高级托管层上托管的应用,可在 Azure 门户中的应用设置中设置应用服务应用的平台体系结构 (x86/x64)。 请确认应用的发布设置(例如 Visual Studio 中的发布配置文件 (.pubxml))与 Azure 门户中应用的服务配置设置匹配。

64 位 (x64) 和 32 位 (x86) 应用的运行时存在于 Azure 应用服务上。 应用服务上提供的 .NET Core SDK 为 32 位,但可使用 Kudu 控制台或通过 Visual Studio 中的发布流程来部署本地构建的 64 位应用。 有关详细信息,请参阅发布和部署应用部分。

对于具有本机依赖项的应用,32 位 (x86) 应用的运行时存在于 Azure 应用服务上。 应用服务上提供的 .NET Core SDK 为 32 位。

要详细了解 .NET Core 框架组件和分发方法(例如有关 .NET Core 运行时和 .NET Core SDK 的信息),请参阅关于 .NET Core:撰写

package

包含以下 NuGet 包,以便为部署到 Azure 应用服务的应用提供自动日志记录功能:

Microsoft.AspNetCore.App 元包中不提供前述包。 面向 .NET Framework 或引用 Microsoft.AspNetCore.App 元包的应用必须显式引用应用的项目文件中的各个包。

使用 Azure 门户重写应用配置

Azure 门户中的应用设置允许为应用设置环境变量。 可以通过环境变量配置提供程序来使用环境变量。

在 Azure 门户中创建或修改应用设置并选择“保存”按钮时,Azure 应用将重启****。 服务重启后,应用即可使用环境变量。

当应用使用一般主机时,在调用 CreateDefaultBuilder 来构建主机时,环境变量将加载到应用程序的配置中。 有关详细信息,请参阅 ASP.NET Core 中的 .NET 通用主机环境变量配置提供程序

Azure 门户中的应用设置允许为应用设置环境变量。 可以通过环境变量配置提供程序来使用环境变量。

在 Azure 门户中创建或修改应用设置并选择“保存”按钮时,Azure 应用将重启****。 服务重启后,应用即可使用环境变量。

当应用使用 Web 主机时,在调用 CreateDefaultBuilder 来构建主机时,环境变量将加载到应用程序的配置中。 有关详细信息,请参阅 ASP.NET Core Web 主机环境变量配置提供程序

代理服务器和负载均衡器方案

托管在进程外时配置转接头中间件的 IIS 集成中间件和 ASP.NET Core 模块将配置为转发方案 (HTTP/HTTPS) 和发出请求的远程 IP 地址。 对于托管在其他代理服务器和负载均衡器后方的应用,可能需要附加配置。 有关详细信息,请参阅配置 ASP.NET Core 以使用代理服务器和负载均衡器

监视和日志记录

部署到应用服务的 ASP.NET Core 应用会自动接收“ASP.NET Core 记录集成”这一应用服务扩展****。 借助该扩展,可记录 Azure 应用服务上针对 ASP.NET Core 应用的集成。

部署到应用服务的 ASP.NET Core 应用自动接收应用服务扩展“ASP.NET Core 日志记录扩展”****。 借助该扩展,可记录 Azure 应用服务上针对 ASP.NET Core 应用的集成。

有关监视、日志记录和故障排除的信息,请参阅以下文章:

监视 Azure 应用服务中的应用
了解如何查看应用和应用服务计划的配额和指标。

在 Azure 应用服务中为应用启用诊断日志记录
了解如何启用和访问 HTTP 状态代码、失败请求和 Web 服务器活动的诊断日志记录。

处理 ASP.NET Core 中的错误
了解在 ASP.NET Core 应用中处理错误的常见方法。

对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除
了解如何使用 ASP.NET Core 应用诊断 Azure 应用服务部署问题。

Azure 应用服务和 IIS 上 ASP.NET Core 的常见错误参考
使用故障排除建议查看 Azure 应用服务/IIS 托管的应用的常见部署配置错误。

数据保护密钥环和部署槽位

数据保护密钥保存在 %HOME%\ASP.NET\DataProtection-Keys 文件夹中**。 此文件夹由网络存储提供支持,并跨托管应用的所有计算机同步。 密钥不是静态保护的。 此文件夹向单个部署槽位中应用的所有实例提供密钥环。 各部署槽位(例如过渡槽和生成槽)不共享密钥环。

在部署槽位之间交换时,使用数据保护的任意系统都无法使用之前槽位中的密钥环来解密存储的数据。 ASP.NET Cookie 中间件使用数据保护来保护其 cookie。 这导致用户注销使用标准 ASP.NET Cookie 中间件的应用。 对于独立于槽位的密钥环解决方案,请使用外部密钥环提供程序,例如:

  • Azure Blob 存储
  • Azure Key Vault
  • SQL 存储
  • Redis 缓存

有关详细信息,请参阅 ASP.NET Core 中的密钥存储提供程序

部署使用 .NET Core 预览的 ASP.NET Core 应用

若要部署使用 .NET Core 预览版本的应用,请参阅以下资源。 当运行时可用,但 SDK 尚未安装在 Azure 应用服务上时,也可以使用这些方法。

有关 Azure 应用服务上可用的 ASP.NET Core 版本,请参阅应用服务仪表板上的 ASP.NET Core

使用 Azure Pipelines 指定 .NET Core SDK 版本

使用 Azure 应用服务 CI/CD 方案设置与 Azure DevOps 的持续集成版本。 创建 Azure DevOps 版本后,配置版本以使用特定的 SDK 版本(可选)。

指定 .NET Core SDK 版本

使用应用服务部署中心创建 Azure DevOps 版本时,默认版本管道包含 RestoreBuildTestPublish 的步骤。 若要指定 SDK 版本,请在“代理作业”列表中选择“添加 (+)”**** 按钮以添加新步骤。 在搜索栏中搜索“.NET Core SDK”****。

添加 .NET Core SDK 步骤

将该步骤移至版本中的第一个位置,使其后面的步骤使用 .NET Core SDK 的指定版本。 指定 .NET Core SDK 版本。 在本示例中,SDK 被设置为 3.0.100

完成的 SDK 步骤

若要发布独立部署 (SCD),请在 Publish 步骤中配置 SCD 并提供运行时标识符 (RID)

独立发布

部署独立式预览版应用

针对预览运行时的自包含部署 (SCD)在部署中承载预览运行时。

部署自包含应用时:

按照部署独立式应用部分中的指南操作。

对用于容器的 Web 应用使用 Docker

Docker 中心包含最新的预览 Docker 映像。 这些映像可以用作基础映像。 按常规方法使用映像并部署到用于容器的 Web 应用。

安装预览站点扩展

如果无法使用预览版站点扩展,请提出 dotnet/AspNetCore 问题

  1. 从 Azure 门户导航到“应用服务”。
  2. 选择 Web 应用。
  3. 在搜索框中键入“ex”以筛选“扩展”,或向下滚动管理工具列表。
  4. 选择“扩展”。
  5. 选择“添加” 。
  6. 从列表选择“ASP.NET Core {X.Y} ({x64|x86}) 运行时”**** 扩展,其中 {X.Y} 是 ASP.NET Core 预览版本,并且 {x64|x86} 指定平台。
  7. 选择“确定”以接受法律条款。
  8. 选择“确定”安装扩展****。

操作完成时,即表示已安装最新的 .NET Core 预览版。 验证安装:

  1. 选择“高级工具”****。

  2. 选择“高级工具”**** 中的“Go”****。

  3. 选择“调试控制台”**** > “PowerShell”**** 菜单项。

  4. 从 PowerShell 命令提示符处执行以下命令。 在以下命令中,将 ASP.NET Core 运行时版本替换为 {X.Y},并将平台替换为 {PLATFORM}

    Test-Path D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.{PLATFORM}\
    

    如果安装 x64 预览版运行时,该命令将返回True

备注

对于在 A 系列计算(基本)上或更高级托管层上托管的应用,可在 Azure 门户中的应用设置中设置应用服务应用的平台体系结构 (x86/x64)。 请确认应用的发布设置(例如 Visual Studio 中的发布配置文件 (.pubxml))与 Azure 门户中应用的服务配置设置匹配。

如果应用在进程内模式下运行并且平台体系结构配置为 64 位 (x64),则 ASP.NET Core 模块会使用 64 位预览版运行时(如存在)。 使用 Azure 门户安装“ASP.NET Core {X.Y} (x64) 运行时”**** 扩展。

安装 x64 预览版运行时后,在 Azure Kudu PowerShell 命令窗口中运行以下命令以验证该安装。 在以下命令中,将 ASP.NET Core 运行时版本替换为 {X.Y}

Test-Path D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.x64\

如果安装 x64 预览版运行时,该命令将返回True

备注

ASP.NET Core 扩展**** 可为 Azure 应用服务上的 ASP.NET Core 启用附加功能,例如启用 Azure 日志记录。 从 Visual Studio 进行部署时,将自动安装该扩展。 如果未安装该扩展,请为应用安装它。

通过 ARM 模板使用预览站点扩展

如果使用 ARM 模板创建和部署应用,则可使用 siteextensions 资源类型将站点扩展添加到 Web 应用。 例如:

{
    ...
    "parameters": {
        "site_name": {
            "defaultValue": "{SITE NAME}",
            "type": "String"
        },
        ...
    },       
    ...
    "resources": [
        ...
        {
            "type": "Microsoft.Web/sites/siteextensions",
            "apiVersion": "2018-11-01",
            "name": "[concat(parameters('site_name'), '/AspNetCoreRuntime.5.0.x64')]",
            "location": "[resourceGroup().location]",
            "dependsOn": [
                "[resourceId('Microsoft.Web/sites', parameters('site_name'))]"
            ]
        }
    ]
}
    

发布和部署应用

对于 64 位部署:

  • 使用 64 位 .NET Core SDK 部署 64 位的应用。
  • 在应用服务的“配置” > “常规”l“设置”中将“平台”设置为“64 位”**** **** **** ****。 应用必须使用基本服务计划或更高级别的服务计划才能选择平台位数。

部署依赖框架的应用

  1. 从 Visual Studio 工具栏中选择“构建” > “发布 {应用程序名称}”,或者在解决方案资源管理器中右键单击项目,并选择“发布”**** **** **** ****。
  2. 在“选择发布目标”对话框中,确认已选中“应用服务”**** ****。
  3. 选择“高级”。 随即会打开“发布”对话框****。
  4. 在“发布”对话框中:
    • 确认已选中“发布”配置****。
    • 打开“部署模式”下拉列表,然后选择“依赖框架”**** ****。
    • 选择“可移植”作为目标运行时**** ****。
    • 如果需要在部署时删除其他文件,请打开“文件发布选项”,然后选中复选框以删除目标位置的其他文件****。
    • 选择“保存”。
  5. 按照发布向导的其余提示创建新站点或更新现有站点。

部署自包含应用

独立式部署 (SCD) 使用 Visual Studio 或 .NET Core CLI。

  1. 从 Visual Studio 工具栏中选择“构建” > “发布 {应用程序名称}”,或者在解决方案资源管理器中右键单击项目,并选择“发布”**** **** **** ****。
  2. 在“选择发布目标”对话框中,确认已选中“应用服务”**** ****。
  3. 选择“高级”。 随即会打开“发布”对话框****。
  4. 在“发布”对话框中:
    • 确认已选中“发布”配置****。
    • 打开“部署模式”下拉列表,然后选择“自包含”**** ****。
    • 从“目标运行时”下拉列表中选择目标运行时****。 默认值为 win-x86
    • 如果需要在部署时删除其他文件,请打开“文件发布选项”,然后选中复选框以删除目标位置的其他文件****。
    • 选择“保存”。
  5. 按照发布向导的其余提示创建新站点或更新现有站点。

协议设置 (HTTPS)

借助安全的协议绑定,可在通过 HTTPS 响应请求时指定要使用的证书。 若要绑定,需要一个为特定主机名颁发的有效专用证书 ( .pfx)。 有关详细信息,请参阅教程:将现有自定义 SSL 证书绑定到 Azure 应用服务

转换 web.config

如果需要在发布时转换 web.config(例如,基于配置、配置文件或环境设置环境变量),请参阅 转换 web.config

其他资源

Windows Server 上的 Azure 应用服务使用 Internet Information Services (IIS)。 以下是基础 IIS 技术的相关主题: