Megosztás a következőn keresztül:

Rövid útmutató: A GitHub Copilot modernizációs ü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

  • GitHub Copilot-előfizetés: Ingyenes, Pro, Pro+, Üzleti vagy Nagyvállalati csomag. Lásd „Copilot-tervek”.
  • GitHub CLI: Telepítse a GitHub CLI-t (gh) hitelesítés céljából, vagy az ennél újabb verziót v2.45.0. Lásd A gh telepítése.

Platformkövetelmények

  • Windows: x64 vagy ARM64.
  • Linux: x64 vagy ARM64 2.27 vagy újabb verzióval glibc (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ási 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álassza a Java vagy a .NET lehetőséget:

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

  1. Válassza az 1 lehetőséget. Alkalmazás értékelése.
  2. Kövesse az utasításokat az értékelési beállítások konfigurálásához (vagy nyomja le az Enter billentyűt az alapértelmezett beállítások használatához).
  3. Tekintse át a kijelöléseket, és nyomja le az Enter billentyűt az értékelés elindításához.
  4. 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

Nagyra értékeljük a bemenetet! Ha visszajelzést szeretne küldeni a Modernizációs ü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 űrlapját.

  • Last updated on