Dávkový plán s agentem GitHub Copilot pro modernizaci

Plán Batch umožňuje generovat plány modernizace pro více úložišť pomocí jednoho pracovního postupu a sdíleného cíle modernizace. V tomto článku se dozvíte, jak vytvořit konzistentní plány napříč více aplikacemi, než začnete spouštět.

Pomocí dávkového plánu můžete:

  • Vytvořte plány pro více aplikací v jednom průvodci.
  • Použijte konzistentní cíl modernizace napříč úložišti.
  • Zjištění posouzení použijte jako kontext ke zlepšení kvality plánu.
  • Před spuštěním zkontrolujte plány a rozhodněte se, která úložiště se mají nejprve modernizovat.

Plán Batch nabízí následující výhody:

  • Konzistence a řízení:

    • Sdílený záměr: Začněte s jedním pokynem k modernizaci napříč repozitáři.
    • Porovnatelné výstupy: Porovnejte plány vedle sebe, než je spustíte.
    • Flexibilní upřesnění: Upravte každý vygenerovaný plán tak, aby odrážel potřeby specifické pro úložiště.

  • Plánování ve velkém měřítku:

    • Viditelnost portfolia: Zjistěte, jak se stejná žádost vztahuje napříč aplikacemi.
    • Opakovaně použitelná příprava: Opakovaně použijte stejný seznam úložišť a výstupy hodnocení z dřívějších fází.
    • Rychlejší rozhodování: Nejprve vygenerujte plány a pak spusťte pouze úložiště, která schválíte.

Předpoklady

Tip

Dávkové hodnocení není povinné, ale obvykle vytváří přesnější a akční plány, protože agent může odkazovat na zjištěné problémy a příležitosti k migraci.

Konfigurace úložišť

Agent modernizace podporuje několik způsobů, jak určit úložiště, která chcete naplánovat:

  • Aktuální složka: Vytvořte plán projektu v aktuálním pracovním adresáři.
  • Ruční vstup: Zadejte cesty k místnímu adresáři nebo vzdálené adresy URL Gitu přímo.
  • Konfigurační soubor úložiště: Použijte konfigurační soubor JSON, který obsahuje seznam všech úložišť.

Konfigurační soubor úložiště

Pro dávkové operace v mnoha úložištích vytvořte konfigurační soubor JSON pro výpis všech úložišť. Můžete ho například vytvořit v .github/modernize/repos.json pracovním adresáři nebo zadat vlastní cestu.

Formát (pole úložišť):

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

Každá položka úložiště podporuje následující pole:

Obor Description Povinné
name Přátelský název úložiště (používaný v sestavách a řídicích panelech) Ano
url Adresa URL pro klonování v Gitu ve formátu HTTPS nebo SSH Jedna z url nebo path

Tip

Stejný repos.json soubor můžete použít v pracovních postupech pro dávkové hodnocení, plánování dávek a upgrade dávek.

Agent modernizace automaticky rozpozná soubor repos.json na .github/modernize/repos.json, když vyberete možnost Z konfiguračního souboru v interaktivním režimu. Můžete také zadat vlastní cestu.

Jak dávkové plánování funguje

Pracovní postup dávkového plánování:

  1. Výběr úložiště: Zvolte úložiště, která chcete zahrnout.
  2. Výběr kontextu: Volitelně můžete jako vstup použít dostupné sestavy posouzení.
  3. Definice promptu: Jednou popište svůj cíl modernizace a použijte jej napříč repozitáři.
  4. Vysvětlení: Odpovězte na všechny následné otázky od agenta.
  5. Generování plánu: Agent vytvoří plán pro každé vybrané úložiště.

Každý vygenerovaný plán se uloží do cílového úložiště a před spuštěním ho můžete zkontrolovat nebo upravit.

Spustit dávkový plán

Po nakonfigurování úložišť spusťte pracovní postup dávkového plánování.

Interaktivní režim

  1. Spusťte agenta modernizace:

    modernize

  2. V hlavní nabídce vyberte Plán .

    ○ 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. Zvolte, jak zadat cílová úložiště. Vyberte Z konfiguračního souboru pro použití souboru repos.json.

    ○ 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

    Tip

    Můžete také vybrat ruční vstup a zadat místní cesty nebo vzdálené adresy URL Gitu přímo nebo aktuální složku pro plánování projektu v aktuálním adresáři.

  4. repos.json Pokud je soubor zjištěn ve výchozím umístění, agent ho automaticky vyplní. V opačném případě zadejte cestu ke konfiguračnímu souboru a stiskněte Enter.

  5. Ve výchozím nastavení jsou vybraná všechna úložiště. Zrušte výběr všech úložišť, která chcete přeskočit, a stisknutím klávesy Enter potvrďte výběr.

    • Pomocí kláves se šipkami můžete procházet a stisknutím mezerník přepínat jednotlivá úložiště.

  6. Vyberte 1. Zachovat plán lokálně pro generování plánů na vašem počítači nebo zvolte 2. Odeslat cloudovému agentovi pro jejich vygenerování cloudovým agentem. Možnost 2 je experimentální.

  7. Zadejte název plánu nebo stiskněte Enter a použijte výchozí nastavení.

  8. Zadejte svůj cíl modernizace jako podnět. Příklad:

    • 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. Stisknutím klávesy Enter vygenerujte plány.

  10. Agent automaticky:

    • Naklonuje každé vybrané úložiště nebo odešle úlohu cloudovému agentu pro každé úložiště.
    • Vygeneruje pro každé úložiště buď plán lokálně, nebo pull request s plánem v daném úložišti.

Další kroky

Po dokončení dávkového plánu zkontrolujte plány a spusťte je pomocí execute příkazu:

Poskytnout zpětnou vazbu

Pokud máte zpětnou vazbu k dávkovému plánu nebo agentovi modernizace, vytvořte problém v úložišti github-copilot-appmod nebo použijte formulář zpětné vazby k modernizaci GitHub Copilot.

  • Last updated on