为 Azure 应用服务配置 ASP.NET 应用

  • 项目

注意

对于 ASP.NET Core，请参阅为 Azure 应用服务配置 ASP.NET Core 应用。 如果 ASP.NET 应用在自定义 Windows 或 Linux 容器中运行，请参阅为 Azure 应用服务配置自定义容器。

必须将 ASP.NET 应用作为编译的二进制文件部署到 Azure 应用服务。 Visual Studio 发布工具先构建解决方案，然后直接部署已编译的二进制文件，而应用服务部署引擎则先部署代码存储库，然后编译二进制文件。

本指南为 ASP.NET 开发者提供了重要概念和说明。 如果你从未使用过 Azure 应用服务，则应首先按照 ASP.NET 快速入门和将 ASP.NET 与 SQL 数据库配合使用教程进行操作。

显示受支持的 .NET Framework 运行时版本

在应用服务中，Windows 实例已安装了所有受支持的 .NET Framework 版本。 若要显示可供使用的 .NET Framework 运行时和 SDK 版本，请导航到 https://<app-name>.scm.chinacloudsites.cn/DebugConsole 并在基于浏览器的控制台中运行相应的命令：

对于 CLR 4 运行时版本（.NET Framework 4 及更高版本）：

ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework"

最新 .NET Framework 版本可能不会立即可用。

对于 CLR 2 运行时版本（.NET Framework 3.5 及更低版本）：

ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework"

显示当前的 .NET Framework 运行时版本

在 Cloud Shell 中运行以下命令：

az webapp config show --resource-group <resource-group-name> --name <app-name> --query netFrameworkVersion

值为 v4.0 表示使用的是最新的 CLR 4 版本 (.NET Framework 4.x)。 值为 v2.0 表示使用的是 CLR 2 版本 (.NET Framework 3.5)。

设置 .NET Framework 运行时版本

默认情况下，应用服务使用受支持的最新 .NET Framework 版本来运行 ASP.NET 应用。 若要改用 .NET Framework 3.5 来运行应用，请在 Cloud Shell 中运行以下命令（v2.0 表示 CLR 2）：

az webapp config set --resource-group <resource-group-name> --name <app-name> --net-framework-version v2.0

访问环境变量

在应用服务中，可以在应用代码外部设置应用设置和连接字符串。 然后，你可以使用标准 ASP.NET 模式在任何类中访问它们：

using System.Configuration;
...
// Get an app setting
ConfigurationManager.AppSettings["MySetting"];
// Get a connection string
ConfigurationManager.ConnectionStrings["MyConnection"];
}

如果你在应用服务中和 web.config 中配置了具有相同名称的应用设置，则应用服务值将优先于 web.config 值。 本地 web.config 值允许你在本地调试应用，但应用服务值允许你使用生产设置在生产中运行应用。 连接字符串的使用方式与此相同。 这样，你可以将应用程序机密保存在代码存储库外部，无需更改代码便可访问相应的值。

部署多项目解决方案

如果 Visual Studio 解决方案包含多个项目，则说明 Visual Studio 发布过程已包括选择要部署的项目的操作。 当你使用 Git 或启用了生成自动化的 ZIP 部署等部署到应用服务部署引擎时，则应用服务部署引擎会选取它发现的第一个网站或 Web 应用项目作为应用服务应用。 你可以通过指定 PROJECT 应用设置来指定应用服务应当使用哪个项目。 例如，在 Cloud Shell 中运行以下命令：

az webapp config appsettings set --resource-group <resource-group-name> --name <app-name> --settings PROJECT="<project-name>/<project-name>.csproj"

获取详细的异常页面

当 ASP.NET 应用在 Visual Studio 调试器中生成异常时，浏览器会显示一个详细的异常页面，但在应用服务中，该页面被常规错误消息替换。 若要在应用服务中显示详细的异常页面，请打开 Web.config 文件，在 <system.web> 元素下添加 <customErrors mode="Off"/> 元素。 例如：

<system.web>
    <customErrors mode="Off"/>
</system.web>

使用更新后的 Web.config 重新部署你的应用。你现在应会看到相同的详细异常页面。

访问诊断日志

你可以使用 System.Diagnostics.Trace 在应用程序代码中添加诊断消息。 例如：

Trace.TraceError("Record not found!"); // Error trace
Trace.TraceWarning("Possible data loss"); // Warning trace
Trace.TraceInformation("GET /Home/Index"); // Information trace

若要访问应用服务中的应用程序代码内生成的控制台日志，请在 Azure CLI 中运行以下命令以打开诊断日志记录：

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

--level 的可能值为：Error、Warning、Info 和 Verbose。 每个后续级别包括上一个级别。 例如：Error 仅包含错误消息，Verbose 则包含所有消息。

启用诊断日志记录功能以后，请运行以下命令来查看日志流：

az webapp log tail --resource-group <resource-group-name> --name <app-name>

如果没有立即看到控制台日志，请在 30 秒后重新查看。

注意

也可通过浏览器在 https://<app-name>.scm.chinacloudsites.cn/api/logs/docker 中检查日志文件。

若要随时停止日志流式处理，请键入 Ctrl+C。

更多资源