Краткое руководство: создание и применение собственных задач для модернизации приложений с помощью GitHub Copilot

В этом кратком руководстве показано, как создавать и применять свои задачи при использовании GitHub Copilot для модернизации приложений.

В разработке кода предприятия часто имеют различные процессы и элементы управления, чтобы соответствовать их организационным политикам и бизнес-потребностям. Это область, в которой используется Мои Задачи (Настраиваемые). Ваша собственная задача создается путем анализа коммитов кода из уже мигрированного кода. Затем задача направляет Copilot для исправления кода, следуя шаблону, установленному уже перенесенным кодом.

В следующем видео показано использование модернизации приложения GitHub Copilot для создания и применения собственной пользовательской задачи для переноса проекта Java в Azure:

Prerequisites

• Учетная запись GitHub с активной подпиской GitHub Copilot по любому тарифу.
• Одна из следующих сред разработки:
  • Последняя версия Visual Studio Code. Должен быть версии 1.101 или более поздней.
    • GitHub Copilot в Visual Studio Code. Инструкции по настройке см. в разделе "Настройка GitHub Copilot" в Visual Studio Code. Обязательно войдите в учетную запись GitHub в Visual Studio Code.
    • Модернизация приложений GitHub Copilot. Перезапустите Visual Studio Code после установки.
  • Последняя версия IntelliJ IDEA. Должен быть версии 2023.3 или более поздней.
    • GitHub Copilot. Должен быть версии 1.5.59 или более поздней. Дополнительные инструкции см. в разделе "Настройка GitHub Copilot" в IntelliJ IDEA. Обязательно войдите в учетную запись GitHub в IntelliJ IDEA.
    • Модернизация приложений GitHub Copilot. Перезапустите IntelliJ IDEA после установки. Если у вас нет GitHub Copilot, вы можете напрямую установить модернизацию приложений GitHub Copilot.
• Java 21 или более поздней версии.
• Maven или Gradle для создания проектов Java.

Замечание

Если вы используете Gradle, поддерживается только оболочка Gradle версии 5+. Язык для конкретного домена Kotlin (DSL) не поддерживается.

Функция My Tasks еще не поддерживается для IntelliJ IDEA.

Создание собственной задачи

Теперь мы поддерживаем три способа добавления ссылок: коммиты Git, внешние ссылки и текстовые файлы. Одновременно можно использовать один или несколько методов.

Используйте коммиты Git

Пример создания собственной задачи с использованием коммитов Git в качестве ссылок:

1. Клонируйте репозиторий примеров миграции Java Copilot.

2. В Visual Studio Code откройте папку rabbitmq-sender проекта из клонированного репозитория. Затем перейдите в исходную ветвь.

3. На боковой панели действия откройте область расширения модернизации приложения GitHub Copilot , наведите указатель мыши на раздел TASKS и выберите "Создать настраиваемую задачу".

   

4. Откроется task.md файл. В поле "Имя задачи" введите custom task migrate rabbitmq. В поле «Запрос задач» введите Вы — помощник разработчика Spring Boot, следуйте коммиту для миграции с RabbitMQ на ServiceBus.

   

5. Выберите "Добавить ссылки" и выберите фиксации Git во всплывающем диалоговом окне.

   

6. Выполните поиск коммита, который переносит RabbitMQ, введя migrate rabbitmq to service bus. Нажмите соответствующую фиксацию и нажмите кнопку "ОК".

   

7. Нажмите кнопку "Сохранить". Пользовательская задача для миграции rabbitmq теперь отображается в разделе Задачи – Мои задачи.

   

Использование внешних ссылок и текстовых файлов

Ниже приведен пример создания собственной задачи с помощью внешних ссылок и текстовых файлов в качестве ссылок:

1. Откройте файл task.md, следуя предопределенным шагам в расширении для модернизации приложения GitHub Copilot.

2. В открывшемся task.md файле введите следующие сведения:

   • Имя задачи: предоставить конечную точку проверки состояния с помощью Spring Boot Actuator.
   • Запрос задачи. Вы являетесь помощником разработчика Spring Boot, следуйте документации spring Boot Actuator, чтобы добавить базовые конечные точки работоспособности для развертывания приложений контейнеров Azure.

   

3. Выберите "Добавить ссылки". Во всплывающем окне выберите внешние ссылки, вставьте следующий URL-адрес https://docs.spring.io/spring-boot/reference/actuator/endpoints.html и нажмите клавишу ВВОД , чтобы подтвердить.

   

4. Создайте файл, содержащий следующее содержимое:

   In this migration, only expose the health endpoints over web, use the following property:
   management.endpoints.web.exposure.include=health
   

5. Снова нажмите кнопку "Добавить ссылки" и на этот раз выберите текстовые файлы. Найдите созданный файл и выберите команду "Выбрать файл".

6. Теперь вы увидите две ссылки: одну внешнюю ссылку и один текстовый файл. Нажмите кнопку "Сохранить", чтобы завершить работу и создать задачу.

   

Поделитесь своей задачей

Чтобы поделиться задачей с другими пользователями, выполните следующие действия.

1. Скопируйте папку, расположенную в разделе .github/appmod/custom-tasks , которая содержит созданную задачу, и поделитесь им с предполагаемым получателем.

   

2. На стороне получателя создайте каталог .github/appmod/custom-tasks в исходном пути своего проекта.

   

3. Вставьте папку задач в этот каталог и выберите "Обновить задачу " в области расширения.

   

4. Теперь задача появится в разделе "Задачи " Мои задачи ", который будет готов к использованию.

   

Примените свою собственную задачу

Чтобы применить собственную задачу, выполните следующие действия.

1. Выберите "Выполнить " в нижней части файла. Или найдите собственную задачу в разделе "Мои задачи" области модернизации приложений GitHub Copilot и запустите задачу, выбрав команду "Выполнить задачу".

   

2. Окно чата Copilot открывается в режиме агента и автоматически выполняет следующие действия:

   • Создает plan.md и progress.md.
   • Проверяет состояние системы управления версиями и выбирает новую ветвь для миграции.
   • Выполняет миграцию кода.
   • Выполняется проверка: сборка, тесты, CVE, согласованность и полнота.
   • Создает файл summary.md .

3. Если агент останавливается во время ожидания подтверждения или прерывается во время выполнения, введите "Продолжить ".

4. После завершения всех шагов просмотрите изменения кода, а затем нажмите кнопку "Сохранить ", чтобы подтвердить в окне чата.

Обновление или удаление собственной задачи

Найдите настраиваемая задача migrate rabbitmq в разделе TASKS - My Tasks, а затем щелкните правой кнопкой мыши, чтобы открыть контекстное меню и выбрать один из следующих вариантов:

• Измените, чтобы обновить задачу.
• Удалите для удаления задачи.

Следующий шаг

Предопределенные задачи для модернизации приложений GitHub Copilot