Bagikan melalui

Penilaian batch menggunakan agen modernisasi GitHub Copilot

Penilaian batch memungkinkan Anda menganalisis beberapa aplikasi secara bersamaan, memberikan tampilan komprehensif tentang lanskap modernisasi di seluruh aplikasi Anda. Artikel ini memandu Anda melalui proses menilai beberapa repositori secara efisien.

Penilaian batch sangat berharga untuk perencanaan migrasi karena memungkinkan Anda menilai kesiapan dan persyaratan berbagai aplikasi secara efisien sekaligus. Dengan menggunakan penilaian batch, Anda dapat mengevaluasi repositori yang berbeda secara bersamaan dan mendapatkan laporan penilaian terperinci untuk setiap aplikasi. Ini menghasilkan dua jenis laporan untuk mendukung perencanaan migrasi Anda:

  • Laporan per aplikasi: Memberikan wawasan terperinci tentang semua masalah modernisasi yang diidentifikasi pada tingkat repositori individual.
  • Laporan agregat: Menyajikan perspektif keseluruhan dari semua aplikasi yang dinilai, menawarkan wawasan ringkasan, rekomendasi tentang layanan Azure, platform target, dan jalur peningkatan. Selain itu, laporan agregat menyertakan pintasan untuk akses mudah ke setiap laporan per aplikasi.

Penilaian batch memberikan manfaat berikut:

  • Visibilitas lintas aplikasi:

    • Laporan agregat: Dapatkan tampilan komprehensif di seluruh aplikasi.
    • Analisis lintas repositori: Mengidentifikasi pola dan dependensi umum di seluruh aplikasi.
    • Wawasan prioritas: Pahami aplikasi mana yang membutuhkan perhatian segera.

  • Skala dan efisiensi:

    • Pemrosesan paralel: Gunakan Cloud Coding Agents untuk memproses beberapa repositori secara bersamaan.
    • Alur kerja otomatis: Integrasikan dengan alur CI/CD untuk penilaian terjadwal.
    • Penghematan waktu: Kurangi total waktu penilaian dari minggu ke jam.

Prasyarat

  • Modernisasi CLI.
  • Akses ke semua repositori yang ingin Anda nilai.
  • Autentikasi GitHub dikonfigurasi (gh auth login).

Konfigurasikan repositori

Untuk mengaktifkan penilaian batch, buat .github/modernize/repos.json file di direktori kerja Anda yang mencantumkan semua repositori yang ingin Anda nilai.

Pastikan Anda memiliki izin yang tepat untuk repositori atau fork mereka.

[
  {
    "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"
  }
]

Konfigurasi repositori

Setiap entri memerlukan:

  • nama: Nama yang mudah diingat untuk repositori (digunakan dalam laporan dan dasbor).
  • url: URL klonIng Git dalam format HTTPS.

Petunjuk / Saran

Anda dapat menyertakan repositori dari organisasi yang berbeda dan menggunakan metode autentikasi yang berbeda selama Anda memiliki akses.

Lokasi file

Anda harus menempatkan file di repos.json.github/modernize/repos.json.

Agen modernisasi secara otomatis mendeteksi file ini saat menjalankan operasi batch.

Menjalankan penilaian kelompok

Tersedia dua mode eksekusi:

  • Eksekusi lokal: Agen modernisasi memproses repositori satu demi satu di komputer lokal Anda. Mode ini berfungsi paling baik untuk serangkaian aplikasi yang lebih kecil atau untuk pengujian awal.
  • Delegasi Cloud Coding Agent: Agen modernisasi mengirimkan tugas ke GitHub Cloud Coding Agents untuk pemrosesan paralel di cloud. Mode ini lebih cepat untuk skenario multi-repo.

Petunjuk / Saran

Dengan menggunakan delegasi Cloud Coding Agent, Anda mengaktifkan eksekusi paralel di semua repositori. Pendekatan ini secara signifikan mengurangi total waktu penilaian untuk portofolio besar.

Mode interaktif (menilai secara lokal)

  1. Jalankan agen modernisasi:

    modernize

  2. Agen mendeteksi repos.json file dan menampilkan daftar repositori:

    Cuplikan layar Modernisasi CLI yang memperlihatkan daftar repositori di terminal.

  3. Pilih repositori untuk dinilai, dan tekan Enter untuk mengonfirmasi pilihan Anda.

    • Tekan Ctrl+A untuk memilih semua repositori.
    • Gunakan tombol panah untuk menavigasi dan menekan Space untuk memilih repositori individual.

  4. Pilih 1. Menilai aplikasi dari menu utama.

    Cuplikan layar Modernisasi CLI yang memperlihatkan menu modernisasi di terminal.

  5. Untuk menjalankan penilaian, pilih untuk menilai secara lokal atau mendelegasikan ke agen pengodean cloud. Pilih 1. Menilai secara lokal.

    Cuplikan layar Modernisasi CLI yang memperlihatkan menu penilaian di terminal.

  6. Agen secara otomatis:

    • Mengkloning semua repositori yang dipilih.

    • Menjalankan penilaian pada setiap repositori satu per satu.

    • Menghasilkan laporan penilaian individual.

      Cuplikan layar Modernisasi CLI yang menunjukkan output pembuatan laporan penilaian individual di terminal.

    • Membuat laporan agregat.

      Cuplikan layar Modernisasi CLI yang menunjukkan output pembuatan laporan agregat di terminal.

  7. Setelah penilaian selesai, agen secara otomatis membuka laporan agregat.

    Cuplikan layar Modernisasi CLI yang memperlihatkan konten laporan agregat.

Mode interaktif (mendelegasikan ke Agen Pengkodean Cloud)

Pertama, konfigurasikan Cloud Coding Agents di setiap repositori aplikasi. Untuk mengonfigurasi Cloud Coding Agents, fork repositori sampel.

Konfigurasi untuk aplikasi .NET

Mengonfigurasi untuk berjalan pada Windows untuk aplikasi .NET Framework

Secara default, Copilot Coding Agent berjalan di lingkungan Linux Ubuntu. Untuk aplikasi .NET Framework, Anda memerlukan lingkungan Windows. Untuk mengaktifkannya, konfigurasikan .github/workflows/copilot-setup-steps.yamlmain di cabang repositori aplikasi Anda seperti yang ditunjukkan dalam contoh berikut:

# 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

Pelajari lebih lanjut dari: Menyesuaikan lingkungan pengembangan Copilot dengan langkah-langkah penyiapan Copilot

Nonaktifkan firewall

Nonaktifkan firewall terintegrasi agen coding Copilot di pengaturan repositori Anda seperti yang ditunjukkan pada gambar berikut:

Cuplikan layar GitHub yang memperlihatkan pengaturan repositori dengan pengaturan Aktifkan firewall diatur ke Nonaktif.

Konfigurasi untuk aplikasi Java

Konfigurasikan GitHub Copilot Modernization MCP Server di bagian Cloud Coding Agent dari pengaturan repositori Anda seperti yang ditunjukkan dalam contoh berikut:

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

Cuplikan layar GitHub yang memperlihatkan pengaturan agen Coding repositori dengan bagian konfigurasi MCP disorot.

Steps

  1. Jalankan agen modernisasi:

    modernize

  2. Agen mendeteksi repos.json file dan menampilkan daftar repositori:

    Cuplikan layar Modernisasi CLI yang memperlihatkan daftar repositori di terminal.

  3. Pilih repositori untuk dinilai, dan tekan Enter untuk mengonfirmasi pilihan Anda.

    • Tekan Ctrl+A untuk memilih semua repositori.
    • Gunakan tombol panah untuk menavigasi dan menekan Space untuk memilih repositori individual.

  4. Pilih 1. Menilai aplikasi dari menu utama.

    Cuplikan layar Modernisasi CLI yang memperlihatkan menu modernisasi di terminal.

  5. Untuk menjalankan penilaian, pilih 2. Delegasikan ke Agen Pengkodean Cloud.

    Cuplikan layar Modernize CLI yang memperlihatkan menu assess dengan opsi Delegasikan ke Agen Pengkodean Cloud dipilih.

  6. Agen secara otomatis mendelegasikan tugas penilaian untuk setiap repositori ke Cloud Coding Agents dan menjalankannya di cloud secara paralel.

    Cuplikan layar Modernisasi CLI yang menunjukkan output kemajuan pendelegasian penilaian ke Agen Pengodean Cloud di terminal.

    Agen kemudian menarik hasil penilaian per aplikasi kembali ke lokal dan menghasilkan laporan agregat secara lokal.

    Cuplikan layar Modernisasi CLI yang memperlihatkan Laporan Penilaian Agregat di terminal.

  7. Setelah penilaian selesai, agen secara otomatis membuka laporan agregat.

Mode non-interaktif (CLI)

Anda juga dapat menggunakan mode non-interaktif dengan menentukan argumen perintah secara langsung. Gunakan perintah modernize assess:

Menilai secara lokal:

modernize assess --multi-repo

Evaluasi dengan mendelegasikan kepada Agen Pengkodean Cloud:

modernize assess --delegate cloud

Untuk informasi selengkapnya, lihat menilai - perintah CLI.

Memahami laporan agregat

Laporan agregat memberikan tampilan komprehensif di seluruh aplikasi yang dinilai sebagai berikut:

Dasbor

  • Gambaran kondisi portofolio: total aplikasi, berapa banyak yang perlu ditingkatkan, dan jumlah penghambat serta masalah secara agregat.
  • Distribusi teknologi: kerangka kerja apa yang digunakan dan berapa banyak aplikasi yang membagikannya.
  • Distribusi upaya: apakah migrasi keseluruhan adalah usaha kecil atau besar.

Recommendations

  • Layanan Azure: memetakan dependensi saat ini ke setara Azure yang direkomendasikan. Dependensi bersama di seluruh aplikasi diputuskan sekali, sehingga Anda menghindari pengerjaan ulang per aplikasi.
  • Platform Target: memandu pilihan hosting, seperti Container Apps versus AKS, dan menampilkan peluang konsolidasi.
  • Jalur Peningkatan: mengidentifikasi aplikasi mana yang memerlukan peningkatan kerangka kerja sebagai prasyarat, memisahkan pekerjaan peningkatan dari pekerjaan migrasi.
  • Gelombang Migrasi: urutan aplikasi berdasarkan kesiapan dan risiko ke dalam fase. Pendekatan ini memungkinkan kemenangan awal sementara aplikasi yang lebih keras disiapkan secara paralel.

Matriks Penilaian Aplikasi

  • Gambaran umum cepat untuk setiap aplikasi tentang aspek kerangka kerja, platform target, rekomendasi peningkatan, perincian masalah (Wajib, Potensial, Opsional), ukuran upaya, dan banyak lagi.
  • Tautan ke laporan aplikasi individual untuk menelusuri paling detail saat diperlukan.

Pemecahan masalah teknis penilaian batch

Masalah umum

Kesalahan akses repositori:

  • Verifikasi autentikasi GitHub dengan menggunakan gh auth status.
  • Pastikan Anda memiliki akses ke semua repositori yang tercantum di repos.json.

Kegagalan kloning:

  • Verifikasi URL repositori di repos.json sudah benar dan dapat diakses.
  • Pastikan Anda memiliki izin akses yang tepat untuk semua repositori.
  • Periksa konektivitas jaringan dan pengaturan VPN Anda.

Kegagalan penilaian:

  • Periksa apakah repositori berisi proyek Java atau .NET yang valid.
  • Verifikasi bahwa file build ada, seperti pom.xml, , build.gradle*.csproj, atau *.sln.
  • Tinjau pesan kesalahan di output konsol.

Masalah delegasi Cloud Coding Agent:

  • Pastikan Anda memiliki izin yang tepat untuk membuat alur kerja GitHub Actions.
  • Periksa izin Tindakan GitHub dan batas kuota untuk organisasi Anda.
  • Untuk aplikasi .NET Framework, pastikan konfigurasi runner Windows diatur dengan benar.
  • Periksa konfigurasi server MCP Anda.

Langkah berikutnya

Setelah menyelesaikan penilaian kelompok, Anda dapat:

Lanjutkan alur kerja modernisasi:

Pelajari selengkapnya:

Berikan umpan balik

Kami menghargai input Anda! Jika Anda memiliki umpan balik tentang penilaian batch atau agen Modernisasi, buat laporan di repositori github-copilot-appmod atau gunakan formulir umpan balik modernisasi GitHub Copilot.

  • Last updated on