Bagikan melalui

Panduan Cepat: Menginstal dan menggunakan agen modernisasi GitHub Copilot

Panduan awal ini memandu Anda dalam menginstal agen GitHub Copilot dan menggunakannya untuk meningkatkan aplikasi contoh.

Prasyarat

  • Langganan GitHub Copilot: Paket Gratis, Pro, Pro+, Bisnis, atau Perusahaan. Lihat Paket copilot.
  • GitHub CLI: Instal GitHub CLI (gh) untuk autentikasi, v2.45.0 atau di atasnya. 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 GitHub CLI:

gh auth login

Kemudian, jalankan agen modernisasi:

modernize

Menu utama muncul:

○ How would you like to modernize your Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

Langkah 1: Menilai aplikasi

  1. Pilih 1. Menilai aplikasi.
  2. Ikuti perintah untuk mengonfigurasi opsi penilaian (atau tekan Enter untuk menggunakan default).
  3. Tinjau pilihan Anda dan tekan Enter untuk memulai penilaian.
  4. 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. Masukkan nama paket atau tekan Enter untuk menggunakan nama default.
  3. Masukkan tujuan modernisasi Anda dalam bentuk prompt. Secara default, perintahnya adalah References the assessment summary and creates plan 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
  4. Tekan Enter untuk menghasilkan rencana.

Agen menganalisis basis kode Anda dan menghasilkan:

  • File rencana (.github/modernize/{plan-name}/plan.md): Strategi dan pendekatan yang terperinci.
  • Daftar tugas (.github/modernize/{plan-name}/tasks.json): Perincian langkah-langkah yang dapat dieksekusi.

Petunjuk / Saran

Anda dapat mengedit plan.md secara manual untuk menambahkan klarifikasi atau menyesuaikan detail. Anda juga dapat memperbarui tasks.json untuk mengubah, menyusun ulang, menambahkan, atau menghapus tugas sebelum menjalankan rencana.

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

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

  • Last updated on