Kötegelt terv a GitHub Copilot modernizációs ügynökével

A Batch-terv lehetővé teszi, hogy egy munkafolyamat és egy közös modernizálási cél használatával modernizálási terveket hozzon létre több adattárhoz. Ez a cikk bemutatja, hogyan hozhat létre egységes csomagokat több alkalmazásban a végrehajtás megkezdése előtt.

A Batch-csomag használatával a következőkre van lehetőség:

  • Több alkalmazás terveinek létrehozása egy irányított munkafolyamatban.
  • Konzisztens modernizációs cél alkalmazása az adattárakban.
  • A tervminőség javítása érdekében használja az értékelési megállapításokat kontextusként.
  • Tekintse át a terveket a végrehajtás előtt , és döntse el, hogy mely adattárakat modernizálja először.

A Batch-csomag a következő előnyöket biztosítja:

  • Konzisztencia és vezérlés:

    • Közös szándék: Kezdje egy modernizációs kérésből az adattárak között.
    • Összehasonlítható kimenetek: A végrehajtás előtt tekintse át egymás mellett a terveket.
    • Rugalmas pontosítás: Módosítsa az egyes létrehozott terveket az adattárspecifikus igényeknek megfelelően.
  • Tervezés nagy léptékben:

    • Portfolió láthatósága: Ismerje meg, hogy ugyanez a kérés hogyan vonatkozik az alkalmazásokra.
    • Újrafelhasználható előkészítés: Használja újra ugyanazt az adattárlistát és kiértékelési kimenetet a korábbi szakaszokból.
    • Gyorsabb döntéshozatal: Először hozzon létre terveket, majd csak a jóváhagyott adattárakat hajtsa végre.

Prerequisites

  • A parancssori felület modernizálása.
  • Hozzáférés az összes tervezni kívánt adattárhoz.
  • GitHub-hitelesítés konfigurálva (gh auth login).
  • Befejezett kötegértékelés (ajánlott), ha azt szeretné, hogy az ügynök tervezési környezetként használja az értékelési megállapításokat.

Jótanács

A Batch-felmérés nem szükséges, de általában pontosabb és végrehajthatóbb terveket hoz létre, mivel az ügynök hivatkozhat az észlelt problémákra és a migrálási lehetőségekre.

Adattárak konfigurálása

A modernizálási ügynök több módszert is támogat a tervezni kívánt adattárak megadására:

  • Aktuális mappa: Hozzon létre egy tervet a projekthez az aktuális munkakönyvtárban.
  • Manuális bevitel: Adja meg közvetlenül a helyi címtár elérési útjait vagy a távoli Git URL-címeket.
  • Adattár konfigurációs fájlja: Használjon egy JSON konfigurációs fájlt, amely felsorolja az összes adattárat.

Adattár konfigurációs fájlja

Több adattárban végzett kötegelt műveletekhez hozzon létre egy JSON-konfigurációs fájlt az összes adattár listázásához. Létrehozhatja például a .github/modernize/repos.json munkakönyvtárban, vagy megadhat egy egyéni elérési utat.

Formátum (tárolók tömbje):

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

Minden adattárbejegyzés a következő mezőket támogatja:

Field Leírás Szükséges
name Az adattár rövid neve (a jelentésekben és irányítópultokon használatos). Igen
url Git-klón URL HTTPS vagy SSH formátumban. Az egyik a következők közül: url vagy path

Jótanács

Ugyanazt repos.json a fájlt használhatja a batch assessment, a batch plan és a batch upgrade munkafolyamatokban.

A modernizációs ügynök automatikusan észleli a repos.json fájlt a .github/modernize/repos.json helyen, amikor az Konfigurációs fájlból lehetőséget választja interaktív módban. Egyéni elérési utat is megadhat.

A batch-csomag működése

A kötegtervezési munkafolyamat:

  1. Tárház kiválasztása: Válassza ki a felvenni kívánt adattárakat.
  2. Környezet kiválasztása: Igény szerint használhatja a rendelkezésre álló értékelési jelentéseket bemenetként.
  3. Gyors definíció: Írja le egyszer a modernizációs célt, és alkalmazza azt az adattárakban.
  4. Pontosítás: Válaszoljon az ügynöktől érkező további kérdésekre.
  5. Terv létrehozása: Az ügynök minden kiválasztott adattárhoz létrehoz egy tervet.

Minden létrehozott terv a céladattárba kerül, és a végrehajtás előtt áttekinthető vagy szerkeszthető.

Kötegelt terv futtatása

Az adattárak konfigurálása után indítsa el a kötegtervezési munkafolyamatot.

Interaktív mód

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

    modernize
    
  2. Válassza a Terv lehetőséget a főmenüben.

    ○ 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
    
  3. Adja meg a céladattárak megadásának módját. Válassza a Konfigurációs fájlból lehetőséget egy repos.json fájl használatához.

    ○ Choose target repositories
    
        1. Current folder
          /Users/username/project
        2. Manual input
          Enter local path or remote URL
      > 3. From a config file
          /path/to/.github/modernize/repos.json
    

    Jótanács

    A Manuális bemenet lehetőséget választva közvetlenül megadhatja a helyi elérési utakat vagy távoli Git URL-címeket, vagy az Aktuális mappát, hogy megtervezze a projektet az aktuális könyvtárban.

  4. Ha a repos.json fájl az alapértelmezett helyen van észlelve, az ügynök automatikusan kitölti azt. Ellenkező esetben adja meg a konfigurációs fájl elérési útját, és nyomja le az Enter billentyűt.

  5. Alapértelmezés szerint minden adattár ki van jelölve. Törölje a kihagyni kívánt adattárak kijelölését, majd nyomja le az Enter billentyűt a kijelölés megerősítéséhez.

    • A nyílbillentyűkkel navigálhat, és a Szóköz billentyűt lenyomva válthat az egyes adattárak között.
  6. Válassza a 1. lehetőséget: Tartsa helyben a tervet, hogy a gépén hozzon létre terveket, vagy válassza a 2. lehetőséget: Küldje be a Cloud Agentnek, hogy egy felhőalapú ügynök hozza létre azokat. A 2. lehetőség kísérleti.

  7. Adja meg a terv nevét, vagy nyomja le az Enter billentyűt az alapértelmezett beállítás használatához.

  8. Adja meg a modernizációs célt. Például:

    • upgrade to Spring Boot 3 and prepare for Azure deployment
    • migrate the database to Azure PostgreSQL
    • containerize the application and deploy to Azure Container Apps
  9. A tervek létrehozásához nyomja le az Enter billentyűt .

  10. Az ügynök automatikusan:

    • Klónozza az egyes kijelölt adattárakat, vagy elküld egy feladatot egy felhőügynöknek az egyes adattárakhoz.
    • Helyben létrehoz egy tervet minden egyes tárházhoz, vagy minden egyes tárházban egy, a tervet tartalmazó lekéréses kérelmet hoz létre.

Következő lépések

A kötegcsomag befejezése után tekintse át a terveket, és hajtsa végre őket a execute következő paranccsal:

Visszajelzés küldése

Ha visszajelzést szeretne küldeni a batch-tervről vagy 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.