Поделиться через

Краткое руководство: установка и использование агента обновления GitHub Copilot

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

Необходимые условия

  • Подписка на GitHub Copilot: Бесплатный, Pro, Pro+, Бизнес или Корпоративный план. См. планы Copilot.
  • GitHub CLI: установите GitHub CLI (gh) для аутентификации v2.45.0 или более поздней версии. См. раздел "Установка gh".

Требования платформы

  • Windows: x64 или ARM64.
  • Linux: x64 или ARM64 с glibc версией 2.27 или более поздней версии (Ubuntu 18.04 или более поздней версии, Debian 10 или более поздней версии, Fedora 29 или более поздней версии, Azure Linux 2.0 или более поздней версии).
  • macOS: Apple Silicon или Intel.

Установка агента модернизации

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

Используйте один из следующих вариантов:

Вариант 1 . Winget (рекомендуется):

winget install GitHub.Copilot.modernization.agent

Для автоматической установки без запросов:

winget install GitHub.Copilot.modernization.agent --silent

Вариант 2. Однострочная команда PowerShell:

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

Вариант 3. Установщик MSI:

Скачайте и запустите последнюю версию MSI на странице выпусков GitHub.

Замечание

После установки откройте новый терминал, чтобы modernize команда была доступна в PATH. Эти команды работают как для начальной установки, так и обновления до последней версии. В будущем выпуске будет доступна выделенная команда обновления версий.

Проверьте установку:

modernize --version

Получение примера приложения

В этом кратком руководстве по запуску используйте приложение-пример. Выберите Java или .NET:

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

Использование интерактивного режима

Самый простой способ начать работу — использовать интерактивный режим. Сначала выполните проверку подлинности с помощью интерфейса командной строки GitHub:

gh auth login

Затем запустите агент модернизации:

modernize

Откроется главное меню:

○ How would you like to modernize your Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

Шаг 1. Оценка приложения

  1. Выберите 1. Оценка приложения.
  2. Следуйте инструкциям по настройке параметров оценки (или нажмите клавишу ВВОД, чтобы использовать значения по умолчанию).
  3. Просмотрите ваши выборы и нажмите клавишу ВВОД, чтобы начать оценку.
  4. Дождитесь завершения оценки.

Результаты оценки сохраняются в каталоге вашего проекта .github\modernize\assessment\. Агент анализирует код, зависимости и конфигурацию для идентификации:

  • Устаревшие версии платформы
  • Устаревшие интерфейсы API
  • Проблемы совместимости облака
  • Возможности миграции

Шаг 2. Создание плана модернизации

После завершения оценки агент предложит создать план модернизации на основе выявленных проблем:

○ How would you like to continue?

  > 1. Create modernization plan
       Generate a plan.md file according to the identified issues
    2. Return to main menu
  1. Выберите 1. Создайте план модернизации.
  2. Введите имя плана или нажмите клавишу ВВОД, чтобы использовать имя по умолчанию.
  3. Введите цель модернизации в качестве запроса. По умолчанию запрос References the assessment summary and creates plan - это создать план на основе результатов оценки. Вы можете заменить его любым другим запросом на миграцию, например:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Нажмите клавишу ВВОД, чтобы создать план.

Агент анализирует базу кода и создает следующее:

  • Файл плана (.github/modernize/{plan-name}/plan.md): подробная стратегия и подход.
  • Список задач (.github/modernize/{plan-name}/tasks.json): Разбивка исполняемых шагов.

Подсказка

Вы можете вручную изменить plan.md, чтобы добавить уточнения или скорректировать детали. Вы также можете обновить tasks.json , изменить порядок, добавить или удалить задачи перед выполнением плана.

Шаг 3. Выполнение плана модернизации

После проверки плана убедитесь, что вы хотите выполнить план.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Выберите 1. Выполнение плана модернизации.
  2. Нажмите Enter, чтобы выполнить план.
  3. Отслеживайте ход выполнения по мере применения агентом изменений.

Агент выполняет каждую задачу в порядке:

  • Вносит изменения кода в соответствии с планом.
  • Валидирует сборки после каждого изменения.
  • Сканирует и адреса CVEs.
  • Фиксирует изменения.

Шаг 4. Просмотр результатов

После завершения выполнения можно просмотреть все изменения, внесенные агентом, прежде чем объединить их:

  1. Просмотрите изменения: проверьте изменения в текущей ветви.

    git status
git diff main

  2. Создайте pull request: если вы удовлетворены изменениями, создайте PR для проверки командой.

    gh pr create \
    --title "Modernization: migrate the app to azure" \
    --body "Automated modernization by GitHub Copilot agent"

Дальнейшие действия

Предоставьте отзыв

Мы ценим ваши входные данные! Если у вас есть отзывы об агенте модернизации, создайте проблему в репозитории github-copilot-appmod или используйте форму отзывов о модернизации GitHub Copilot.

  • Last updated on