Быстрый старт: Установка и использование агента обновления GitHub Copilot

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

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

  • подписка GitHub Copilot: бесплатный, Pro, Pro+, Бизнес или Корпоративный план. См. планы Copilot.
  • GitHub CLI. Установите интерфейс командной строки GitHub (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

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

○ What would you like to do?

  > Assess        Analyze your source application and generate an assessment report
    Plan          Create a modernization plan based on assessment findings
    Execute       Run tasks defined in your modernization plan
  ──────────────
    Upgrade       Upgrade your runtime and frameworks to the latest versions

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

  1. Выберите "Оценка " в главном меню.
  2. Выберите способ указания целевых репозиториев. Вы можете выбрать текущую папку для использования текущего каталога, ввода вручную для ввода локальных путей или удаленных URL-адресов Git или из файла конфигурации для загрузки репозиториев из файла конфигурации JSON. В рамках этого краткого руководства выберите текущую папку.
  3. Выберите режим выполнения. Выберите "Оценка локально", чтобы запустить оценку на компьютере или делегировать облачным агентам , чтобы агенты облака выполняли оценку параллельно. В этом быстром запуске выберите Оценить локально.
  4. Выберите области оценки, такие как обновление Java и Cloud Readiness, и нажмите клавишу Enter.
  5. Просмотрите параметры конфигурации оценки, такие как покрытие анализа и целевая среда выполнения. Нажмите Enter, чтобы принять рекомендуемые значения по умолчанию, или отрегулируйте отдельные параметры по необходимости.
  6. Примите путь вывода по умолчанию или введите пользовательский, а затем нажмите клавишу ВВОД , чтобы начать оценку.
  7. Дождитесь завершения оценки.

Результаты оценки сохраняются в каталоге вашего проекта .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/c1.

  • Last updated on