Mulai cepat: Menginstal dan menggunakan agen modernisasi GitHub Copilot

Panduan cepat ini memandu Anda untuk menginstal agen modernisasi GitHub Copilot dan menggunakannya untuk memodernisasi aplikasi contoh.

Prasyarat

  • langganan A GitHub Copilot: Paket Gratis, Pro, Pro+, Bisnis, atau Perusahaan. Lihat rencana Copilot.
  • GitHub CLI: Instal CLI GitHub (gh) untuk autentikasi, versi v2.45.0 atau yang lebih baru. Lihat Menginstal gh.

Persyaratan platform

  • Windows: x64 atau ARM64.
  • Linux: x64 atau ARM64 dengan glibc 2.27 atau yang lebih baru (Ubuntu 18.04 atau yang lebih baru, Debian 10 atau yang lebih baru, Fedora 29 atau yang lebih baru, Azure Linux 2.0 atau yang lebih baru).
  • macOS: Apple Silicon atau Intel.

Menginstal agen modernisasi

Gunakan perintah berikut untuk menginstal agen modernisasi atau memperbarui ke versi terbaru.

Gunakan salah satu opsi berikut:

Opsi 1 - Winget (disarankan):

winget install GitHub.Copilot.modernization.agent

Untuk penginstalan senyap tanpa perintah:

winget install GitHub.Copilot.modernization.agent --silent

Opsi 2 - Skrip PowerShell satu baris:

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

Opsi 3 - Penginstal MSI:

Unduh dan jalankan MSI terbaru dari halaman rilis GitHub.

Nota

Setelah penginstalan, buka terminal baru agar modernize perintah tersedia di PATH Anda. Perintah ini berfungsi untuk penginstalan awal dan memperbarui ke versi terbaru. Perintah pembaruan versi khusus akan tersedia dalam rilis mendatang.

Verifikasi penginstalan:

modernize --version

Dapatkan aplikasi contoh

Untuk panduan cepat ini, gunakan aplikasi sampel. Pilih Java atau .NET:

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

Menggunakan mode interaktif

Cara term mudah untuk memulai adalah dengan menggunakan mode interaktif. Pertama, autentikasi dengan menggunakan CLI GitHub:

gh auth login

Kemudian, jalankan agen modernisasi:

modernize

Menu utama muncul:

○ 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

Langkah 1: Menilai aplikasi

  1. Pilih Evaluasi dari menu utama.
  2. Pilih cara menentukan repositori target Anda. Anda dapat memilih Folder saat ini untuk menggunakan direktori Anda saat ini, Input manual untuk memasukkan jalur lokal atau URL Git jarak jauh, atau Dari file konfigurasi untuk memuat repositori dari file konfigurasi JSON. Untuk panduan memulai cepat ini, pilih Folder saat ini.
  3. Pilih domain penilaian, seperti peningkatan Java dan Kesiapan Cloud, dan tekan Enter.
  4. Tinjau opsi konfigurasi penilaian, seperti Cakupan Analisis dan Waktu Jalan Target. Tekan Enter pada Lanjutkan untuk menerima default yang direkomendasikan, atau sesuaikan pengaturan individual sesuai kebutuhan.
  5. Pilih mode eksekusi. Pilih Nilai secara lokal untuk menjalankan penilaian di komputer Anda, atau Delegasikan ke Agen Cloud untuk memungkinkan agen cloud menjalankan penilaian secara paralel. Untuk panduan cepat ini, pilih Nilai secara lokal.
  6. Terima jalur output default atau masukkan jalur kustom, lalu tekan Enter untuk memulai penilaian.
  7. Tunggu hingga penilaian selesai.

Hasil penilaian disimpan ke .github\modernize\assessment\ dalam direktori proyek Anda. Agen menganalisis kode, dependensi, dan konfigurasi Anda untuk mengidentifikasi:

  • Versi kerangka kerja yang kedaluarsa
  • API yang tidak digunakan lagi
  • Masalah kompatibilitas cloud
  • Peluang migrasi

Langkah 2: Membuat rencana modernisasi

Setelah penilaian selesai, agen meminta Anda untuk membuat rencana modernisasi berdasarkan masalah yang diidentifikasi:

○ 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. Pilih 1. Buat rencana modernisasi.
  2. Pilih 1. Simpan rencana secara lokal untuk membuat rencana di komputer Anda, atau pilih 2. Kirim ke Agen Cloud agar agen cloud membuat rencana tersebut. Opsi 2 bersifat eksperimental.
  3. Laporan penilaian yang baru dibuat dipilih secara bawaan untuk menghasilkan rencana. Pilih 1. Tidak ada laporan jika Anda ingin menjelaskan persyaratan spesifik Anda sebagai gantinya.
  4. Masukkan nama paket atau tekan Enter untuk menggunakan nama default.
  5. Masukkan tujuan modernisasi Anda dalam bentuk prompt. Secara default, perintahnya adalah Based on the assessment report, upgrade the project and migrate to Azure membuat rencana berdasarkan temuan penilaian. Anda dapat menggantinya dengan permintaan migrasi lainnya, misalnya:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  6. Tekan Enter untuk menghasilkan rencana.
  7. Agen menganalisis basis kode Anda dan meminta Anda untuk mengklarifikasi permintaan. Anda dapat memilih jawaban yang disarankan atau mengetik jawaban Anda sendiri.

Agen menggabungkan semua informasi dan menghasilkan:

  • File rencana (.github/modernize/{plan-name}/plan.md): Strategi dan pendekatan yang terperinci.

Petunjuk / Saran

Anda dapat mengedit plan.md secara manual untuk menambahkan klarifikasi atau menyesuaikan detail.

Langkah 3: Jalankan rencana modernisasi

Setelah Anda memverifikasi rencananya, konfirmasikan bahwa Anda ingin menjalankan rencana tersebut.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Pilih 1. Jalankan rencana modernisasi.
  2. Tekan Enter untuk menjalankan rencana.
  3. Pantau kemajuan saat agen menerapkan perubahan.

Agen menjalankan setiap tugas secara berurutan:

  • Membuat perubahan kode sesuai dengan rencana.
  • Memvalidasi tiap build setelah terjadi perubahan.
  • Memindai dan mengatasi CVE.
  • Menerapkan perubahan.

Langkah 4: Tinjau hasilnya

Setelah eksekusi selesai, Anda dapat meninjau semua perubahan yang dibuat agen sebelum menggabungkannya:

  1. Tinjau perubahan: Periksa modifikasi pada cabang saat ini.

    git status
git diff main

  2. Buat permintaan penarikan: Jika Anda puas dengan perubahan, buat permintaan penarikan untuk tinjauan tim.

    gh pr create \
    --title "Modernization: migrate the app to azure" \
    --body "Automated modernization by GitHub Copilot agent"

Langkah berikutnya

Berikan umpan balik

Umpan balik Anda membantu meningkatkan agen modernisasi. Untuk mengirim umpan balik dari Modernisasi TUI, tekan F.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

Anda juga dapat buat masalah di repositori github-copilot-appmod atau menggunakan formulir umpan balik modernisasi GitHub Copilot.

  • Last updated on