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ü:

○ 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. 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 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.
  4. 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.
  5. 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.
  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. Adjon meg egy tervnevet, vagy nyomja le az Enter billentyűt az alapértelmezett név használatához.
  3. Adja meg a modernizációs célt. Alapértelmezés szerint a kérés References the assessment summary and creates plan 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
  4. A terv létrehozásához nyomja le az Enter billentyűt.

Az ügynök elemzi a kódbázist, és létrehozza a következőt:

  • Tervfájl (.github/modernize/{plan-name}/plan.md): Részletes stratégia és megközelítés.
  • Feladatlista (.github/modernize/{plan-name}/tasks.json): Végrehajtható lépések lebontása.

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. A terv végrehajtása előtt frissítheti a tasks.json-t a feladatok módosításához, átrendezéséhez, hozzáadásához vagy eltávolításához.

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

Fontos a bemenete! Ha visszajelzést szeretne küldeni a Modernizálási ügynökről, hozzon létre egy problémát a github-copilot-appmod adattárban vagy használja a GitHub Copilot modernizációs visszajelzési űrlapot.

  • Last updated on