快速入门：使用适用于 .NET 的 GitHub Copilot 应用现代化评估并迁移 .NET 项目

在本快速入门中，你将使用适用于 .NET 的 GitHub Copilot 应用现代化来评估和迁移 .NET 项目。 你将完成以下任务：

• 评估示例项目（Contoso University）
• 启动迁移过程

Prerequisites

• Windows 操作系统

• Visual Studio 2022 版本 17.14.16 或更高版本。

• 启用了以下可选组件的 .NET 桌面开发工作负载：

  • GitHub Copilot
  • 适用于 .NET 的 GitHub Copilot 应用现代化

• Copilot 许可证和支持的订阅计划：

  使用具有 Copilot 访问权限的 GitHub 帐户 登录 Visual Studio。

  支持的订阅计划：

  • Copilot Pro
  • Copilot Pro+
  • Copilot Business
  • Copilot Enterprise

  重要

  如果更改订阅，则必须重启 Visual Studio。

• 代码必须用 C# 编写。

评估应用就绪情况

用于 .NET 评估的 GitHub Copilot 应用现代化有助于查找应用准备挑战、了解其影响，并查看建议的迁移任务。 每个迁移任务都包含对设置 Azure 资源、添加配置和进行代码更改的引用。 按照以下步骤开始迁移：

1. 将 .NET 迁移助手示例 存储库克隆到计算机。

2. 在 Visual Studio 中，从示例存储库打开 Contoso University 解决方案。

3. 在解决方案资源管理器中，右键单击解决方案节点并选择 “现代化”。

   

4. GitHub Copilot 聊天窗口随即打开，其中包含欢迎消息和预定义选项。 从可用选项中选择 “迁移到 Azure ”并将其发送到 Copilot。

   

   Tip

   可以直接打开 GitHub Copilot Chat 并发送 @Modernize Migrate to Azure 以启动评估和迁移流，而不是步骤 3 和步骤 4。

5. 此时会打开一个新的 Copilot 聊天会话，并显示欢迎消息。 评估会自动启动，并分析项目以进行迁移准备。

   

6. 评估完成后，会在聊天窗口中看到全面的评估报告 UI 页面和迁移任务列表。

   

应用迁移

适用于 .NET 的 GitHub Copilot 应用现代化包括常见迁移方案的 预定义任务 ，并遵循Microsoft的最佳做法。

启动迁移任务

通过以下方式之一启动迁移任务：

选项 1. 从评估报告中运行

从上一步中选择评估报告中的 “运行任务 ”按钮以启动迁移任务。

选项 2. 在 Copilot 聊天中发送消息

在聊天中发送迁移任务编号（例如 1.1）或其名称。

计划和进度跟踪器生成

• 开始迁移时，GitHub Copilot 会在代理模式下启动一个名为“应用现代化：从 <source technology> 中 <target technology>迁移到”的会话，其中包含预定义的提示。
• 该工具在 .appmod/.migration 文件夹中创建两个文件：
  • plan.md - 总体迁移计划
  • progress.md - 进度跟踪器;GitHub Copilot 在完成任务时标记项
• 在继续之前编辑这些文件以自定义迁移。

启动代码修正

• 如果对计划和进度跟踪器感到满意，请输入启动迁移的提示，例如：

  The plan and progress tracker look good to me. Go ahead with the migration.
  

• GitHub Copilot 启动迁移过程，并可能要求你的批准在模型上下文协议 （MCP） 服务器中使用知识库工具。 出现提示时授予权限。

• Copilot 遵循计划和进度跟踪器以：

  • 管理依赖项
  • 应用配置更改
  • 更改代码
  • 生成解决方案，修复所有编译和配置错误，并确保生成成功
  • 修复安全漏洞

默认聊天消息

适用于 .NET 的 GitHub Copilot 应用现代化提供了用于简化工作流的默认聊天消息选项。

可以选择其中一个预定义选项并在聊天中发送它：

• 运行现代化评估：开始对应用程序进行新的评估，以确定迁移准备问题和 Azure 兼容性挑战。
• 查看评估报告：打开以前的评估报告，并显示基于结果的迁移任务的摘要。 如果不存在以前的评估，则首先运行新的评估。
• 浏览顶级迁移任务：显示建议的迁移任务和常见现代化方案，而不考虑任何特定的评估结果。

后续步骤

• 预定义任务
• 常见问题解答