本文介绍如何在 GitHub Copilot 应用现代化中使用评估功能,以最大化应用程序现代化过程的价值。
概述
应用程序评估是现代化过程中的关键第一步。 本文介绍如何为不同的方案配置评估、使用评估报告以及在整个现代化过程中管理评估数据。
在运行评估之前进行配置
可以在项目中打开 .appmod/.appcat/assessment-config.json 该文件以编辑应用程序评估的配置,以指定目标 Azure 服务(如果存在)。 对于评估的第一次运行,将自动生成配置文件。
配置属性
可以编辑此文件以配置应用程序评估。 下次运行评估时,将应用保存到此文件的任何更改。
可配置参数:
目标:要运行应用的 Azure 计算服务。 如果您尚未决定使用哪个选项,可以选择任意,之后在评估报告中进行选择和比较。 默认情况下,它设置为 Any。
| 目标 | Description |
|---|---|
| 任意 | 在这里查找所有支持目标的相关问题。 |
| AKS.Windows | Azure Kubernetes 服务(Windows)的最佳做法。 |
| AKS。Linux | Azure Kubernetes 服务(Linux)的最佳做法。 |
| AppService.Windows | Azure 应用服务(Windows)的最佳做法。 |
| AppService.Linux | Azure 应用服务(Linux)的最佳做法。 |
| AppServiceContainer.Windows | Azure 应用服务容器(Windows)的最佳做法。 |
| AppServiceContainer.Linux | Azure 应用服务容器(Linux)的最佳做法。 |
| AppServiceManagedInstance.Windows | Azure 应用服务托管实例(Windows)的最佳做法。 |
| ACA | Azure 容器应用的最佳做法。 |
例子
下面提供了两个正确配置的示例:
- 示例一:想要将应用迁移到 Azure,但尚未确定目标计算服务
{
"appcat": {
"target": "Any"
}
}
- 示例二:想要将应用迁移到应用服务 Linux,并想要了解需要修复的问题。
{
"appcat": {
"target": "AppService.Linux"
}
}
评估运行后,交互式仪表板会自动打开以提供全面的分析结果。 配置目标 Azure 服务 Any时,可以在它们之间切换,以比较迁移方法并查看特定于服务的建议。 如果配置特定的目标 Azure 服务,则只能在下拉列表中看到一个 Azure 服务。
解读评估报告
评估报告提供全面的分析结果,可帮助你了解应用程序的 Azure 迁移和现代化准备情况。 本部分将指导你完成报表结构,并帮助你解释结果以做出明智的迁移决策。
报表结构概述
评估报告由几个关键部分组成:
- 应用程序信息:有关应用程序的基本信息,包括项目编号、框架、生成工具和目标 Azure 服务。
- 问题摘要:按具有关键百分比的域分类的迁移问题的概述。
- 问题:提供需要注意的所有问题的简明摘要。
问题
“问题”部分提供了云就绪情况的各个方面的分类列表,这些方面需要解决以成功将应用程序迁移到 Azure。 以下表格描述了Domain和Criticality的值:
| 域名 | Description |
|---|---|
| 云就绪情况 | 评估应用依赖项以建议 Azure 服务并确保云原生就绪。 |
| 重要性 | Description |
|---|---|
| 必需 | 迁移到 Azure 时必须修复的问题。 |
| 潜在 | 可能影响迁移和需要评审的问题。 |
| 可选 | 影响较低的问题。 建议修复它们,但可选。 |
有关详细信息,可以通过选择标题来扩展每个报告的问题。 该报告提供以下信息:
- 事件发生的文件列表,以及受影响的代码行数。 如果该文件是 .NET 源文件,则选择文件行号会将你定向到相应的源报表。
- 问题的详细说明。 此说明概述了问题,提供了任何已知解决方案,并引用了有关问题或解决方法的支持文档。
执行评估报告
有效的报表管理能够促进协作、保持评估历史记录,并与现有工作流进行集成。
导入评估报告
除了直接在 GitHub Copilot 应用现代化中运行评估,还可以导入评估报告。 报表可能来自 .NET AppCAT CLI 结果、GitHub Copilot 应用现代化导出报表或 Dr.Migrate 中的应用上下文文件。
在进入 Modernize 代理时,可以在聊天中键入“导入报告”来触发导入操作,或者在 Import 报告仪表板中选择按钮,从文件资源管理器中导入报告。
导出评估报告
在评估仪表板中,可以查看 AppCAT 检测到的问题并选择迁移解决方案。 可以导出报表并将其与他人共享。 这样,其他人就不需要自行运行评估,并且可以导入报表来直接查看评估和迁移决策。
可以选择 Export 评估仪表板中的按钮,将报表导出到文件资源管理器。