Batch-értékelés a GitHub Copilot modernizációs ügynökével

A Batch-értékelés lehetővé teszi több alkalmazás egyidejű elemzését, így átfogó képet nyújt az alkalmazások modernizációs környezetéről. Ez a cikk végigvezeti a több adattár hatékony értékelésének folyamatán.

A Batch-értékelés különösen hasznos a migrálás megtervezéséhez, mivel lehetővé teszi a különböző alkalmazások felkészültségének és követelményeinek hatékony értékelését. A batch assessment használatával egyszerre értékelhet ki különböző adattárakat, és részletes értékelési jelentéseket szerezhet be az egyes alkalmazásokhoz. Kétféle jelentést készít a migrálás megtervezésének támogatásához:

• Alkalmazásonkénti jelentés: Részletes betekintést nyújt az egyes adattárak szintjén azonosított modernizációs problémákba.
• Összesített jelentés: Az összes értékelt alkalmazás átfogó perspektíváját mutatja be, amely összefoglaló elemzéseket, javaslatokat kínál az Azure-szolgáltatásokra, a célplatformokra és a frissítési útvonalakra vonatkozóan. Az összesített jelentés emellett billentyűparancsokat is tartalmaz az egyes alkalmazásjelentésekhez való könnyű hozzáféréshez.

A Batch-értékelés a következő előnyöket nyújtja:

• Alkalmazások közötti láthatóság:

  • Összesített jelentések: Átfogó nézet lekérése az alkalmazások között.
  • Tárházközi elemzés: Azonosítsa az alkalmazások gyakori mintáit és függőségeit.
  • Rangsorolási megállapítások: Annak megismerése, hogy mely alkalmazásokra van szükség azonnali figyelmet igényel.

• Skálázás és hatékonyság:

  • Párhuzamos feldolgozás: Több adattár egyidejű feldolgozásához használjon felhőkódoló ügynököket.
  • Automatizált munkafolyamatok: Integráció CI-/CD-folyamatokkal ütemezett értékeléshez.
  • Időmegtakarítás: A teljes értékelési idő csökkentése hetekről órákra.

Előfeltételek

• A parancssori felület modernizálása.
• Hozzáférés az összes értékelni kívánt adattárhoz.
• A GitHub-hitelesítés konfigurálva van (gh auth login).

Adattárak konfigurálása

A kötegelt értékelés engedélyezéséhez hozzon létre egy .github/modernize/repos.json fájlt a munkakönyvtárban, amely felsorolja az összes értékelni kívánt adattárat.

Győződjön meg arról, hogy rendelkezik a megfelelő engedélyekkel az adattárakhoz vagy elágazásokhoz.

[
  {
    "name": "PhotoAlbum-Java",
    "url": "https://github.com/Azure-Samples/PhotoAlbum-Java.git"
  },
  {
    "name": "PhotoAlbum",
    "url": "https://github.com/Azure-Samples/PhotoAlbum.git"
  },
  {
    "name": "eShopOnWeb",
    "url": "https://github.com/dotnet-architecture/eShopOnWeb.git"
  }
]

Adattár konfigurációja

Minden bejegyzéshez a következőre van szükség:

• név: Az adattár rövid neve (a jelentésekben és irányítópultokon használatos).
• url: A Git-klón URL-címe HTTPS formátumban.

Jótanács

Különböző szervezetek adattárait is felveheti, és különböző hitelesítési módszereket használhat, amíg hozzáféréssel rendelkezik.

Fájl helye

A fájlt repos.json a következő helyre kell helyeznie: .github/modernize/repos.json.

Az ütemezési ügynök automatikusan észleli ezt a fájlt, amikor tömeges műveleteket hajt végre.

Kötegelt értékelés futtatása

Két végrehajtási mód érhető el:

• Helyi végrehajtás: A modernizálási ügynök egymás után dolgozza fel az adattárakat a helyi gépen. Ez a mód kisebb alkalmazásokhoz vagy kezdeti teszteléshez működik a legjobban.
• Cloud Coding Agent-delegálás: A modernizálási ügynök feladatokat küld a GitHub Cloud Coding Agentsnek a felhőben történő párhuzamos feldolgozáshoz. Ez a mód gyorsabb a több adattárral történő forgatókönyvekhez.

Jótanács

A Cloud Coding Agent delegálásával minden adattárban engedélyezi a párhuzamos végrehajtást. Ez a megközelítés jelentősen csökkenti a nagy portfóliók teljes értékelési idejét.

Interaktív mód (helyi értékelés)

1. Futtassa a modernizálási ügynököt:

   modernize
   

2. Az ügynök észleli a repos.json fájlt, és megjeleníti az adattár listáját:

   

3. Válassza ki az értékelendő adattárakat, és nyomja Enter le a kívánt kijelölés megerősítéséhez.

   • Nyomja meg Ctrl+A az összes adattár kiválasztásához.
   • A nyílbillentyűkkel navigálhat és lenyomhatja Space az egyes adattárak kiválasztását.

4. Válassza az 1 lehetőséget. Alkalmazás értékelése a főmenüből.

   

5. Az értékelés futtatásához válassza a helyi értékelés vagy a felhőkódoló ügynökök delegálása lehetőséget. Válassza az 1 lehetőséget. Helyi értékelés.

   

6. Az ügynök automatikusan:

   • Klónozza az összes kijelölt adattárat.

   • Egyenként futtatja az értékelést az egyes adattárakon.

   • Egyéni értékelési jelentéseket hoz létre.

     

   • Összesített jelentést hoz létre.

     

7. Amikor az értékelés befejeződik, az ügynök automatikusan megnyitja az összesített jelentést.

   

Interaktív mód (felhőkódoló ügynökökre való delegálás)

Először konfigurálja a felhőkódoló ügynököket az egyes alkalmazás-adattárakban. A Cloud Coding Agents konfigurálásához forkold a példatárolókat.

.NET-alkalmazások konfigurálása

Konfigurálás Windows for .NET Framework-alkalmazásokon való futtatásra

A Copilot Kódolási ügynök alapértelmezés szerint Ubuntu Linux-környezetben fut. A .NET-keretrendszer-alkalmazásokhoz Windows-környezetre van szükség. Az engedélyezéshez konfigurálja a .github/workflows/copilot-setup-steps.yaml-t az alkalmazás-adattár main ágában az alábbi példában látható módon.

# Windows-based Copilot Setup Steps for .NET tasks
# Note: Windows runners have firewall limitations that may affect some network operations
# Use this workflow for .NET projects that require Windows-specific tooling

name: "Copilot Setup Step (Windows)"

on:
  workflow_dispatch:

jobs:
  copilot-setup-steps:
    runs-on: windows-latest
    permissions:
      contents: read
    steps:
      - name: Checkout code
        uses: actions/checkout@v5

További információ: A Copilot fejlesztési környezetének testreszabása a Copilot beállítási lépéseivel

Tűzfal letiltása

Tiltsa le a Copilot kódolási ügynök integrált tűzfalát az adattár beállításaiban az alábbi képen látható módon:

Java-alkalmazások konfigurálása

Konfigurálja a GitHub Copilot Modernizálási MCP-kiszolgálót az adattár beállításainak Cloud Coding Agent szakaszában, ahogyan az alábbi példában látható:

{
  "mcpServers": {
    "app-modernization": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "-y",
        "@microsoft/github-copilot-app-modernization-mcp-server"
      ]
    }
  }
}

Lépések

1. Futtassa a modernizálási ügynököt:

   modernize
   

2. Az ügynök észleli a repos.json fájlt, és megjeleníti az adattár listáját:

   

3. Válassza ki az értékelendő adattárakat, és nyomja Enter le a kívánt kijelölés megerősítéséhez.

   • Nyomja meg Ctrl+A az összes adattár kiválasztásához.
   • A nyílbillentyűkkel navigálhat és lenyomhatja Space az egyes adattárak kiválasztását.

4. Válassza az 1 lehetőséget. Alkalmazások értékelése a főmenüből.

   

5. Az értékelés futtatásához válassza a 2. Átruházás a felhőkódolási ügynökökre.

   

6. Az ügynök automatikusan delegálja az egyes adattárak értékelési feladatait a Cloud Coding Agentsnek, és párhuzamosan hajtja végre őket a felhőben.

   

   Az ügynök ezután visszahívja az alkalmazásonkénti értékelés eredményeit a helyire, és helyileg hozza létre az összesített jelentést.

   

7. Amikor az értékelés befejeződik, az ügynök automatikusan megnyitja az összesített jelentést.

Nem interaktív mód (CLI)

A nem interaktív módot parancsargumentumok közvetlen megadásával is használhatja. Használja a modernize assess parancsot:

Helyi értékelés:

modernize assess --multi-repo

Értékelés a felhőkódoló ügynökökre való delegálással:

modernize assess --delegate cloud

További információ: értékelés – CLI-parancsok.

Az összesített jelentés ismertetése

Az összesített jelentés átfogó áttekintést nyújt a kiértékelt alkalmazásokról az alábbiak szerint:

irányítópult

• Pillanatkép a portfólió állapotáról: az összes alkalmazás, a szükséges frissítések száma, valamint a blokkolók és a problémák száma.
• Technológiaterjesztés: milyen keretrendszerek vannak használatban, és hány alkalmazás osztja meg őket.
• Munkaerő-elosztás: hogy a teljes migrálás kis- vagy nagyszabású feladat.

Ajánlások

• Azure-szolgáltatások: az aktuális függőségeket az ajánlott Azure-megfelelőkre képezi le. Az alkalmazások közötti megosztott függőségek egyszer lesznek meghatározva, így elkerülheti az alkalmazásonkénti átdolgozásokat.
• Célplatform: útmutatást ad a hoszting választásában, például a Container Apps és az AKS tekintetében, és rámutat a konszolidációs lehetőségekre.
• Frissítési útvonal: azonosítja, hogy mely alkalmazásoknak kell előfeltételként keretrendszerfrissítéseket végeznie, és elkülöníti a frissítési munkát a migrálási munkától.
• Migrálási hullámok: az alkalmazásokat készenlét és kockázat szerint szakaszokba rendezi. Ez a megközelítés lehetővé teszi a korai nyeréseket, míg a nehezebb alkalmazásokat párhuzamosan készítik elő.

Alkalmazásértékelési mátrix

• Gyors áttekintés az egyes alkalmazásokról a keretrendszer, a célplatform, a frissítési javaslat, a problémák lebontása (Kötelező, Lehetséges, Nem kötelező), a munkamennyiség méretezése stb.
• Szükség esetén az egyes alkalmazásjelentésekre mutató hivatkozások részletezéshez.

Kötegértékelés hibaelhárítása

Gyakori problémák

Tárház hozzáférési hibái:

• A GitHub-hitelesítés ellenőrzése gh auth status használatával.
• Győződjön meg arról, hogy rendelkezik hozzáféréssel a listában felsorolt összes adattárhoz repos.json.

Klónozási hibák:

• Ellenőrizze, hogy az repos.json adattár URL-címei helyesek-e és elérhetők-e.
• Győződjön meg arról, hogy minden adattárhoz megfelelő hozzáférési engedélyekkel rendelkezik.
• Ellenőrizze a hálózati kapcsolatot és a VPN-beállításokat.

Értékelési hibák:

• Ellenőrizze, hogy az adattár érvényes Java- vagy .NET-projekteket tartalmaz-e.
• Ellenőrizze, hogy léteznek-e buildfájlok, például pom.xml, build.gradle, *.csprojvagy *.sln.
• Tekintse át a konzol kimenetében megjelenő hibaüzeneteket.

Cloud Coding Agent delegálási problémák:

• Győződjön meg arról, hogy megfelelő engedélyekkel rendelkezik a GitHub Actions-munkafolyamatok létrehozásához.
• Ellenőrizze a GitHub Actions engedélyeit és a szervezet kvótakorlátait.
• A .NET-keretrendszer alkalmazásai esetében győződjön meg arról, hogy a Windows futókonfigurációja megfelelően van beállítva.
• Ellenőrizze az MCP-kiszolgáló konfigurációját.

Következő lépések

A kötegelt értékelés elvégzése után a következőkre van lehetőség:

Folytassa a modernizálási munkafolyamatot:

• Kötegelt frissítés futtatása az adattárakban – Konzisztens frissítések alkalmazása az értékelési eredmények alapján.

További információk:

• Egyéni képességek létrehozása szervezetspecifikus mintákhoz.
• További információ a parancssori felület parancsairól.

Visszajelzés küldése

Nagyra értékeljük a bemenetet! Ha visszajelzést szeretne küldeni a kötegelt értékelésről vagy 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.