快速入门:为 GitHub Copilot 应用现代化创建并应用自己的任务

本快速入门介绍如何在使用 GitHub Copilot 应用现代化时创建和应用自己的任务。

在代码开发中,企业通常有不同的流程和控制措施,以遵守其组织策略和业务需求。 此区域是 “我的任务”(自定义) 出现的地方。 通过分析已迁移代码中的代码提交来生成你自己的任务。 然后,该任务指导 Copilot 按照已迁移的代码建立的模式修正代码。

以下视频演示如何使用 GitHub Copilot 应用现代化来创建并应用自己的自定义任务,将 Java 项目迁移到 Azure:


Prerequisites

注释

如果使用 Gradle,则仅支持 Gradle 包装器版本 5+ 。 不支持 Kotlin 域特定语言(DSL)。

IntelliJ IDEA 尚不支持该函数 My Tasks

创建自己的任务

我们现在支持添加引用的三种方法:Git 提交、外部链接和文本文件。 一次可以使用一个或多个方法。

使用 Git 提交

以下步骤提供了使用 Git 提交作为引用创建自己的任务的示例:

  1. 克隆 Java 迁移助手示例 存储库。

  2. 在 Visual Studio Code 中,从克隆的存储库中打开 rabbitmq-sender 项目文件夹。 然后,切换到 分支。

  3. “活动 ”边栏中,打开 GitHub Copilot 应用现代化 扩展窗格,将鼠标悬停在 “任务 ”部分上,然后选择“ 创建自定义任务”。

    Visual Studio Code 的屏幕截图,其中显示了 GitHub Copilot 应用现代化任务窗格,其中突出显示了“创建自定义任务”按钮。

  4. 此时会打开一个 task.md 文件。 在 “任务名称” 字段中,输入 自定义任务迁移 rabbitmq。 在 “任务提示” 字段中,输入 “作为 Spring Boot 开发人员助手,请根据提交内容从 RabbitMQ 迁移到 ServiceBus。”

    Visual Studio Code 的屏幕截图,显示了迁移 rabbitmq 任务,并突出显示了任务名称和任务提示字段。

  5. 选择 “添加引用 ”,然后在弹出对话框中选择 “Git 提交 ”。

    Visual Studio Code 的屏幕截图,其中显示了“选择源类型”下拉列表,其中突出显示了“Git 提交”选项。

  6. 键入 migrate rabbitmq to service bus,搜索迁移 RabbitMQ 的提交。 选择相应的提交,然后选择“ 确定”。

    Visual Studio Code 对话框的屏幕截图,标题为“选择提交记录作为源”。

  7. 选择“保存”。 用于迁移 rabbitmq 的自定义任务现在显示在 “任务 - 我的任务 ”部分中。

    Visual Studio Code 的屏幕截图,其中显示了 task.md 文件,其中突出显示了“保存”按钮。

以下步骤演示了使用外部链接和文本文件作为引用创建自己的任务的示例:

  1. 按照 GitHub Copilot 应用现代化插件中的预定义步骤打开task.md文件。

  2. 在打开 task.md 的文件中,输入以下信息:

    • 任务名称通过 Spring Boot 执行器公开运行状况终结点
    • 任务提示:你是 Spring Boot 开发人员助理,请按照 Spring Boot Actuator 文档为 Azure 容器应用部署添加基本健康检查端点。

    Visual Studio Code 的屏幕截图,其中显示了任务名称和任务提示字段突出显示的暴露运行状况终结点任务。

  3. 选择 “添加引用”。 在弹出窗口中,选择 “外部链接”,然后粘贴以下 URL: https://docs.spring.io/spring-boot/reference/actuator/endpoints.html 然后按 Enter 进行确认。

    Visual Studio Code 的屏幕截图,其中显示了 task.md 文件,其中突出显示了外部链接字段。

  4. 创建包含以下内容的文件:

    In this migration, only expose the health endpoints over web, use the following property:
    management.endpoints.web.exposure.include=health
    
  5. 再次选择 “添加引用 ”,这次选择“ 文本文件”。 找到已创建的文件,然后选择“ 选择文件”。

  6. 现在应会看到添加两个引用:一个外部链接和一个文本文件。 选择 “保存 ”以完成并创建任务。

    Visual Studio Code 的屏幕截图,其中显示了 task.md 文件,其中突出显示了“名称”列,其中包含添加的引用。

分享你自己的任务

使用以下步骤与他人共享任务:

  1. 复制位于包含已创建任务的 .github/appmod/custom-tasks 下的文件夹,并将其与预期收件人共享。

    显示复制自定义文件夹的 Visual Studio Code 的屏幕截图。

  2. 在收件人端,在其项目的源路径中创建 一个 .github/appmod/custom-tasks 目录。

    显示创建自定义文件夹的 Visual Studio Code 的屏幕截图。

  3. 将任务文件夹粘贴到此目录中,然后在扩展窗格中选择“ 刷新任务 ”。

    显示刷新任务的 Visual Studio Code 的屏幕截图。

  4. 任务现在显示在 “任务 - 我的任务 ”部分,可供使用。

    显示已刷新任务的 Visual Studio Code 的屏幕截图。

应用自己的任务

使用以下步骤执行您自己的任务:

  1. 选择文件底部的 “运行 ”。 或在“任务 - GitHub Copilot 应用现代化”窗格的“我的任务”部分找到自己的任务,并通过选择“运行任务”来运行任务。

    Visual Studio Code 的屏幕截图,其中显示了“任务”部分,其中突出显示了“运行任务”和“运行”按钮。

  2. Copilot 聊天窗口在代理模式下打开,并自动执行以下步骤:

    • 创建 plan.mdprogress.md
    • 检查版本控制状态并签出新的迁移分支。
    • 执行代码迁移。
    • 运行验证:生成、测试、CVE、一致性和完整性。
    • 生成 summary.md 文件。
  3. 如果代理在等待确认时停止或在执行期间中断,请输入 “继续” 继续。

  4. 完成所有步骤后,请查看代码更改,然后选择 “保留 ”以确认在聊天窗口中。

更新或删除自己的任务

“任务 - 我的任务”部分中找到“自定义任务迁移 rabbitmq”,然后右键单击以打开上下文菜单并选择以下选项之一:

  • 编辑 以更新任务。
  • 删除 以删除任务。

显示编辑或删除自定义任务的 Visual Studio Code 的屏幕截图。

后续步骤

GitHub Copilot 应用现代化的预定义任务