Краткое руководство. Оценка и перенос проекта Java с помощью модернизации приложений GitHub Copilot

В этом кратком руководстве показано, как использовать модернизацию приложений GitHub Copilot для оценки и переноса проекта Java. В этом кратком руководстве показано, как установить и настроить расширение, а затем оценить и перенести пример проекта. Например, вы используете предопределенную задачу для обновления подключения к базе данных SQL Azure, чтобы использовать управляемое удостоверение Azure вместо имени пользователя и пароля.

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

Prerequisites

• Учетная запись Azure с активной подпиской. Создайте его бесплатно.

• Учетная запись 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.

Обновление версий JDK и зависимостей

Существует два способа обновления версии JDK. Оба способа используют область модернизации приложений GitHub Copilot в Visual Studio Code, доступ к которой можно получить с боковой панели.

Одним из способов обновления версии JDK является выбор среды выполнения обновления и платформ в разделе QUICKSTART . Другим способом является запуск задачи "Обновленная среда выполнения Java" в разделе "ЗАДАЧИ — обновление задач ". Дополнительные сведения см. в кратком руководстве по обновлению проекта Java с помощью модернизации приложений GitHub Copilot.

Чтобы обновить платформу Spring или стороннюю зависимость, выполните задачу Upgrade Java Framework в разделе "ЗАДАЧИ — задачи обновления ". Дополнительные сведения см. в статье Об обновлении платформы Java или сторонних зависимостей с помощью модернизации приложений GitHub Copilot.

Оценка готовности облака

Выполните следующие действия, чтобы начать процесс миграции с помощью оценки решений. Эта оценка помогает понять, какие проблемы готовности к работе в облаке и насколько они влияют. Он также предоставляет рекомендуемые решения. Рекомендация по решению содержит ссылки на настройку ресурсов Azure, добавление конфигураций и внесение изменений в код.

1. Клонируйте репозиторий примеров миграции копилота Java и затем переключитесь на ветку source.

2. В Visual Studio Code откройте папку проекта mi-sql-public-demo в репозитории примеров.

3. На боковой панели выберите область модернизации приложений GitHub Copilot , где можно выбрать "Миграция в Azure " или "Выполнить оценку " в разделе "ОЦЕНКА ".

   

4. Окно чата GitHub Copilot с режимом агента открывается для вызова оценщика модернизации для выполнения оценки модернизации приложения. Нажмите кнопку "Продолжить ", чтобы подтвердить.

5. Теперь средство оценки модернизации открывает appcat.log. В этом файле показаны журналы для запуска AppCAT, который выполняет оценку приложения. Нажмите кнопку "Продолжить", чтобы подтвердить еще раз.

6. Специалист по модернизации сначала проверяет вашу локальную среду. Если приложение AppCAT и его зависимости не установлены, агент помогает установить их. После установки агент вызывает AppCAT для оценки текущего проекта. Этот шаг может занять несколько минут.

7. По завершении анализа оценщик модернизации представляет классифицированное представление о проблемах готовности к облаку в открытом отчете об оценке.

   

8. При просмотре сводного отчета можно выбрать "Миграция в базу данных SQL Azure" (Spring) из списка решений в разделе о миграции базы данных (Microsoft SQL). Затем нажмите кнопку "Выполнить задачу ", чтобы перейти к этапу исправления кода.

   

Применение предопределенной задачи

Для миграции Copilot предоставляет предопределенные задачи для распространенных сценариев миграции, которые могут возникнуть при миграции в Azure. Например, с примером mi-sql-public-demo задача "Миграция баз данных ( Microsoft SQL) изменяет подключение к базе данных SQL Azure, чтобы использовать управляемое удостоверение Azure вместо имени пользователя и пароля.

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

1. В отчете об оценке выберите "Выполнить задачу". Откроется окно чата Copilot с выбранным режимом агента.

2. Агент Copilot использует различные средства для модернизации приложений, и каждому инструменту может потребоваться подтверждение для продолжения. plan.md и progress.md создаются сначала, и при необходимости можно просмотреть plan.md и внести изменения.

3. Вручную введите continue для подтверждения и начала процесса миграции.

4. Прежде чем вносить изменения в код, агент проверяет состояние системы управления версиями и проверяет новую ветвь для миграции.

5. Повторно выберите Продолжить или введите эту команду, чтобы подтвердить использование инструментов или команд и дождитесь завершения изменений кода.

Итерация проверки

После завершения изменения кода вручную введите continue, чтобы продолжить проверку и исправления в цикле итерации. Этот цикл включает следующие пять частей:

• Примените средство Validate-CVEs. Это средство пытается обнаружить распространенные уязвимости и уязвимости (CVEs) в текущих зависимостях и исправляет их.
• Примените средство Build-Project. Это средство пытается устранить ошибки сборки.
• Примените средство Consistency-Validation. Это средство анализирует коды для функциональной согласованности.
• Примените средство Run-Test. Это средство анализирует проект для сбоев модульного теста и автоматически создает план их устранения. Средство Run-Test итеративно выполняет модульные тесты и исправляет все ошибки.
• Примените средство Completeness-Validation. Это средство перехватывает элементы миграции, пропущенные при первоначальной миграции кода, и исправляет их.

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

Создание вариантов модульного теста

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

1. На боковой панели выберите область модернизации приложений GitHub Copilot .

2. В разделе "ЗАДАЧИ" откройте "Задачи качества" и "Безопасность", а затем выберите "Создать модульные тестовые случаи".

Агент создает модульные тесты и создает TestReport для отображения результатов теста до и после создания. Дополнительные сведения см. в кратком руководстве по созданию модульных тестов с помощью модернизации приложений GitHub Copilot.

Дальнейшие шаги

• Работа с инструментами оценки
• Краткое руководство: создание и применение собственных задач