Быстрый старт: Установка и использование агента обновления 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.

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

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

Windows
Linux или macOS

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

Вариант 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. Эти команды работают как для начальной установки, так и обновления до последней версии. В будущем выпуске будет доступна выделенная команда обновления версий.

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

Вариант 1 . Homebrew:

brew tap microsoft/modernize https://github.com/microsoft/modernize-cli
brew install modernize

Вариант 2. Сценарий оболочки:

curl -fsSL https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.sh | bash

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

modernize --version

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

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

Java
.NET

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

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

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

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

gh auth login

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

modernize

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

○ How would you like to modernize your app?

  > Assess
    Analyze modernization readiness across one or multiple applications
    Plan
    Generate a structured plan to guide the agent
    Execute
    Run the tasks defined in the modernization plan

  Or select a quick-start scenario:

    Upgrade
    Upgrade runtimes and frameworks across one or multiple applications

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

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

Результаты оценки сохраняются в каталоге вашего проекта .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. Отправьте в облачный агент , чтобы создать его. Вариант 2 является экспериментальным.
Созданный отчет об оценке выбирается по умолчанию для создания плана. Выберите 1. Нет отчета , если вы хотите описать конкретные требования.
Введите имя плана или нажмите клавишу ВВОД, чтобы использовать имя по умолчанию.
Введите цель модернизации в качестве запроса. По умолчанию запрос Based on the assessment report, upgrade the project and migrate to Azure - это создать план на основе результатов оценки. Вы можете заменить его любым другим запросом на миграцию, например:
- migrate the database to Azure PostgreSQL
- upgrade to Spring Boot 3
- deploy to Azure Container Apps
Нажмите клавишу ВВОД, чтобы создать план.
Агент анализирует базу кода и просит уточнить запрос. Вы можете выбрать предлагаемый ответ или ввести свой собственный.

Агент объединяет все сведения и создает:

Файл плана (.github/modernize/{plan-name}/plan.md): подробная стратегия и подход.

Подсказка

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

Шаг 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. Выполнение плана модернизации.
Нажмите Enter, чтобы выполнить план.
Отслеживайте ход выполнения по мере применения агентом изменений.

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

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

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

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

Просмотрите изменения: проверьте изменения в текущей ветви.
```
git status
git diff main
```
Создайте pull request: если вы удовлетворены изменениями, создайте PR для проверки командой.
```
gh pr create \
    --title "Modernization: migrate the app to azure" \
    --body "Automated modernization by GitHub Copilot agent"
```

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

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

Ваши отзывы помогают улучшить работу агента модернизации. Чтобы отправить отзыв в интерфейсе Modernize TUI, нажмите F.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

Вы также можете создать проблему в репозитории github-copilot-appmod или использовать форму обратной связи о модернизации GitHub Copilot.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-06-02