在 Visual Studio 中调试 Azure 云服务（外延支持）服务

Visual Studio 提供了不同的选项来调试 Azure 云服务（外延支持）和虚拟机。

先决条件

• Visual Studio（请参阅 [Visual Studio 下载] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)），其中安装了 Azure 开发工作负荷，并安装了单个组件 .NET Framework 项目和项模板。 请参阅修改 Visual Studio。
• 一个 Azure 帐户。 如果没有 Azure 帐户，请激活你的 Visual Studio 订阅者 Azure 权益或注册免费试用版。

在本地计算机上调试云服务

使用 Azure 计算模拟器在本地计算机上调试云服务可以节省时间和金钱。 部署某个服务之前在本地对其进行调试可以提高可靠性和性能，且不会产生计算时间的相关费用。 但是，仅在 Azure 自身中运行云服务时，某些错误才可能会出现。 如果在发布服务时启用远程调试，然后将调试器附加到角色实例，则可以调试这些错误。

该模拟器模拟 Azure 计算服务并在本地环境中运行，使你可以在部署云服务之前对其进行测试和调试。 该模拟器将处理角色实例的生命周期，并提供对所模拟资源（如本地存储）的访问。 从 Visual Studio 调试或运行服务时，Visual Studio 会自动将模拟器作为后台应用程序启动，然后将服务部署到模拟器。 当模拟器在本地环境中运行时，可以使用它来查看服务。 可以运行完整版或速成版的模拟器。 请参阅使用 Emulator Express 在本地运行和调试云服务。

在本地计算机上调试云服务

1. 在菜单栏上，选择调试>开始调试，以运行 Azure 云服务（外延支持）项目。 或者，可以按 F5。 你会看到一条消息，指明计算模拟器正在启动。 当该模拟器启动时，系统托盘图标会对其进行确认。

   

2. 打开通知区域中的 Azure 图标快捷菜单，并选择“显示计算模拟器 UI”，从而显示计算模拟器的用户界面。

   UI 的左窗格显示了当前部署到计算模拟器的服务以及每项服务正在运行的角色实例。 可选择服务或角色，以便在右窗格中显示生命周期、日志记录和诊断信息。 如果将焦点置于包括窗口的上边距中，则该窗口将展开以填写右侧窗格。

3. 通过选择调试菜单上的命令并设置代码中的断点来单步执行应用程序。 在调试器中单步执行应用程序时，窗格会随着应用程序的当前状态而更新。 当停止调试时，将删除应用程序部署。 如果应用程序包含 Web 角色，并且已将启动操作属性设置为启动 Web 浏览器，Visual Studio 会在浏览器中启动 Web 应用程序。 如果更改服务配置中某个角色的实例数，则必须停止云服务，然后重新启动调试，以便可以调试该角色的这些新实例。

   注意

   停止运行或调试服务时，不会停止本地计算模拟器和存储模拟器。 必须从通知区域显式将其停止。

在 Azure 中调试云服务

如果使用本节介绍的过程为云服务启用远程调试，则不会导致性能下降或费用增加。 请勿在生产服务上使用远程调试，因为使用该服务的客户端可能会受到不利影响。

为云服务（外延支持）启用远程调试

1. 将终结点添加到默认 msvsmon 端口的 ServiceDefinition.csdef。 对于 Visual Studio 2022，请添加到端口 4026；对于 Visual Studio 2019，则添加到端口 4024。

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   注意

   其他版本的 Visual Studio 具有不同的端口，请参阅远程调试器端口分配。

2. 如果以 .NET 4.8 为目标，请确保在发布云服务（扩展支持）时打开 ServiceConfiguration.Cloud.cscfg 文件并检查 ServiceConfiguration 元素上的 osFamily 属性值。 对于 .NET 4.8 项目，请使用 osFamily="7"。

3. 打开 Azure 项目的快捷菜单，并选择“发布”。

4. 选择“过渡”环境和“调试”配置。

   这些内容仅供指导。 可以选择在生产环境中运行测试环境。 但是，如果在生产环境中启用远程调试，则可能会对用户造成不利影响。 可以选择“发布”配置，但是，“调试”配置能使调试变得更轻松。

   

5. 按照云服务（外延支持）中所述的常规步骤操作，但选中为所有角色启用远程桌面复选框。

   系统将要求你为远程桌面用户创建用户名和密码，稍后登录到该虚拟机时需要用到这些信息。

6. 转到下一个屏幕，查看设置，准备就绪后，单击发布并等待部署完成。

7. 登录到 Azure 门户并导航到要调试的云服务（外延支持）。

8. 在左侧窗格中选择角色和实例，然后选择要进行远程调试的角色。

9. 单击右侧角色实例弹出窗口中的连接，然后选择连接按钮下载一个远程桌面文件，该文件可让你登录到虚拟机。 使用在上一步中启用远程桌面时创建的凭据登录。

   

10. 在远程 Azure 虚拟机上，按照远程调试中所述安装 Visual Studio 2022 远程工具。

11. 在虚拟机上的桌面上，在 Common7\IDE\Remote Debugger\x64 下的 Visual Studio 安装文件夹中执行命令 msvsmon.exe。 确保以管理员身份运行。

12. 接受提示以允许通过防火墙进行访问。 你应会看到一条消息，指示 msvsmon.exe 已开始侦听连接。

    

13. 在 Azure 门户中，打开资源组，获取云服务（外延支持）的公共 IP 地址。

    

将调试器附加到 Azure 云服务（外延支持）

注意

应尽可能使用发布过程中选择的调试配置进行调试，但如果要调试发布配置，则在 Visual Studio 中，使用 Ctrl+Q 搜索“仅我的代码”，并取消选中工具>选项>调试器>常规中的启用仅我的代码。 发布版本已优化，因此不被视为“我的代码”。

1. 依次选择调试>附加到进程（或按 Ctrl+Alt+P）。

2. 将连接类型保留为默认。

3. 使用 IP 地址和端口 {ipaddress}:4026 输入连接目标。

4. 将附加到设置为自动。

5. 使用与远程桌面用户相同的凭据登录。

6. 选择显示所有用户的进程。 如果要调试辅助角色，请附加到 WaWorkerHost.exe；如果要调试 Web 角色，请附加到 w3wp.exe 进程；对于 Web API 角色，请附加到 WaIISHost.exe。

7. 设置断点（导航到行，然后按 F9），访问站点的公共 URL，并重现要调试的场景。

调试 Azure 应用服务

可以使用 Visual Studio 中的“附加到进程”对话框调试 Azure 应用服务中运行的程序。

注意

这仅适用于从 Visual Studio 2022 17.1 开始的 Azure 应用服务。

调试 Windows Azure 应用服务

1. 在调试下，选择附加到进程。

2. 将连接类型更改为 Microsoft Azure 应用服务，然后选择查找...。

3. 在打开的对话框中，选择“订阅名称”。

   

   注意

   需要登录到 Microsoft 帐户，才能访问包含 Azure 应用服务的订阅。

4. 按资源组或资源类型筛选视图，或按名称搜索。

5. 接下来，选择要调试的应用服务，然后选择确定。

   这将在应用服务上启用远程调试，并显示要附加到的可用进程列表。

   

6. 选择要附加到的进程，然后选择“附加”以开始调试。

相关内容

• 使用 Azure 诊断记录 Azure 中角色内运行的代码的详细信息。 请参阅使用 Azure 诊断收集日志记录数据。

• 有关其他远程调试方案，请参阅远程调试。