Rövid útmutató: A GitHub Copilot modernizálási ügynök telepítése és használata

Ez a rövid útmutató végigvezeti a GitHub Copilot modernizálási ügynök telepítésén és egy mintaalkalmazás modernizálásán.

Előfeltételek

  • A GitHub Copilot előfizetés: Ingyenes, Pro, Pro+, Üzleti vagy Nagyvállalati csomag. Tekintse meg a(z) Copilot terveket.
  • GitHub CLI: A GitHub parancssori felület (gh) telepítése hitelesítéshez, v2.45.0 vagy újabb verzióhoz. Lásd A gh telepítése.

Platformkövetelmények

  • Windows: x64 vagy ARM64.
  • Linux: x64 vagy ARM64 glibc 2.27 vagy újabb verzióval (Ubuntu 18.04 vagy újabb, Debian 10 vagy újabb, Fedora 29 vagy újabb, Azure Linux 2.0 vagy újabb).
  • macOS: Apple Silicon vagy Intel.

A modernizálási ügynök telepítése

Az alábbi parancsokkal telepítheti a modernizálási ügynököt, vagy frissíthet a legújabb verzióra.

Használja az alábbi lehetőségek egyikét:

1. lehetőség – Winget (ajánlott):

winget install GitHub.Copilot.modernization.agent

Csendes telepítés esetén, amely nem igényel felhasználói beavatkozást:

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

2. lehetőség – PowerShell egysoros:

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

3. lehetőség – MSI-telepítő:

Töltse le és futtassa a legújabb MSI-t a GitHub kiadások oldaláról.

Megjegyzés:

A telepítés után nyisson meg egy új terminált, modernize a parancs elérhető lesz a PATH-on. Ezek a parancsok a kezdeti telepítéshez és a legújabb verzióra való frissítéshez is működnek. Egy dedikált verziófrissítési parancs egy későbbi kiadásban lesz elérhető.

Ellenőrizze a telepítést:

modernize --version

Mintaalkalmazás lekérése

Ehhez a rövid útmutatóhoz használjon egy mintaalkalmazást. Válasszon Java vagy .NET:

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

Az interaktív mód használata

Az első lépések legegyszerűbb módja az interaktív mód használata. Először hitelesítés a GitHub parancssori felületével:

gh auth login

Ezután futtassa a modernizálási ügynököt:

modernize

Megjelenik a főmenü:

○ 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. lépés: Az alkalmazás értékelése

  1. Válassza az Értékelés lehetőséget a főmenüben.
  2. Adja meg a céladattárak megadásának módját. Az Aktuális mappa lehetőséget választva használhatja az aktuális könyvtárat, a manuális bemenetet a helyi elérési utak vagy távoli Git URL-címek megadásához, vagy egy konfigurációs fájlból az adattárak JSON-konfigurációs fájlból való betöltéséhez. Ebben a rövid útmutatóban válassza az Aktuális mappát.
  3. Válassza ki az értékelési tartományokat, például Java frissítés és Cloud-készültség, majd nyomja le a Enter billentyűt.
  4. Tekintse át az értékelési konfigurációs beállításokat, például az elemzési lefedettséget és a cél futtatókörnyezetet. Az Enterbillentyűt lenyomva fogadja el az ajánlott alapértelmezett beállításokat, vagy szükség szerint módosítsa az egyes beállításokat.
  5. Válassza ki a végrehajtási módot. Válassza a Helyi értékelés lehetőséget az értékelés futtatásához a számítógépen, vagy a Delegálás felhőügynököknek lehetőséget, hogy a felhőügynökök párhuzamosan futtatják az értékelést. Ebben a rövid útmutatóban válassza a Helyi értékelés lehetőséget.
  6. Fogadja el az alapértelmezett kimeneti útvonalat, vagy adjon meg egy egyénit, majd nyomja le az Enter billentyűt az értékelés elindításához.
  7. Várja meg, amíg az értékelés befejeződik.

Az értékelési eredmények elmentve a .github\modernize\assessment\ fájlba a projektkönyvtárban. Az ügynök elemzi a kódot, a függőségeket és a konfigurációt az alábbiak azonosításához:

  • Elavult keretrendszerverziók
  • Elavult API-k
  • Felhőkompatibilitási problémák
  • Migrálási lehetőségek

2. lépés: Modernizálási terv létrehozása

Az értékelés befejezése után az ügynök megkéri, hogy hozzon létre egy modernizációs tervet az azonosított problémák alapján:

○ 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. Válassza az 1 lehetőséget. Modernizációs terv létrehozása.
  2. Válassza az 1 lehetőséget. Tartsa a tervet helyiként a terv létrehozásához a számítógépen, vagy válassza a 2 lehetőséget. Küldje el a Felhőügynöknek , hogy létrehozhassa azt egy felhőügynökkel. A 2. lehetőség kísérleti.
  3. Az újonnan létrehozott értékelő jelentés alapértelmezés szerint ki van választva a terv létrehozásához. Válassza az 1 lehetőséget. Nincs jelentés , ha inkább a konkrét követelményeket szeretné leírni.
  4. Adjon meg egy tervnevet, vagy nyomja le az Enter billentyűt az alapértelmezett név használatához.
  5. Adja meg a modernizációs célt. Alapértelmezés szerint a kérés Based on the assessment report, upgrade the project and migrate to Azure egy terv létrehozása az értékelési eredmények alapján. Lecserélheti bármely más áttelepítési kérésre, például:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  6. A terv létrehozásához nyomja le az Enter billentyűt.
  7. Az ügynök elemzi a kódbázist, és megkéri, hogy tisztázza a kérést. Választhat egy javasolt választ, vagy beírhatja a sajátját.

Az ügynök összesíti az összes információt, és létrehozza a következőt:

  • Tervfájl (.github/modernize/{plan-name}/plan.md): Részletes stratégia és megközelítés.

Jótanács

Manuálisan szerkesztheti plan.md a pontosítások hozzáadása vagy a részletek módosítása érdekében.

3. lépés: A modernizálási terv végrehajtása

A terv ellenőrzése után győződjön meg arról, hogy végre szeretné hajtani a tervet.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Válassza az 1 lehetőséget. Modernizációs terv végrehajtása.
  2. A terv végrehajtásához nyomja le az Enter billentyűt.
  3. Figyelje az előrehaladást, ahogy az ügynök módosításokat alkalmaz.

Az ügynök az egyes feladatokat a következő sorrendben hajtja végre:

  • A tervnek megfelelően módosítja a kódokat.
  • Minden módosítás után ellenőrzi a buildeket.
  • A CVE-k keresése és kezelése.
  • Véglegesíti a módosításokat.

4. lépés: Az eredmények áttekintése

A végrehajtás befejezése után áttekintheti az ügynök által az egyesítés előtt végrehajtott összes módosítást:

  1. Módosítások áttekintése: Ellenőrizze az aktuális ág módosításait.

    git status
git diff main

  2. Pull kérés létrehozása: Ha elégedett a módosításokkal, hozzon létre egy pull kérést a csapat áttekintéséhez.

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

Következő lépések

Visszajelzés küldése

Az Ön visszajelzései segítenek a modernizálási ügynök fejlesztésében. Ha visszajelzést szeretne küldeni a Modernize TUI-ból, nyomja meg az F billentyűt.

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

A github-copilot-appmod adattárban is létrehozhat problémákat vagy használhatja a GitHub Copilot modernizációs visszajelzési űrlapot.

  • Last updated on