Mulai cepat: Menilai dan memigrasikan proyek .NET dengan modernisasi GitHub Copilot untuk .NET

Dalam panduan cepat ini, Anda menilai dan memigrasikan proyek .NET dengan menggunakan modernisasi GitHub Copilot untuk .NET. Kemudian, selesaikan tugas-tugas berikut:

• Menilai proyek sampel (Universitas Contoso)
• Memulai proses migrasi

Prerequisites

• Windows Sistem Operasi.

• Visual Studio 2026 (atau Visual Studio 2022 versi 17.14.17 dan yang lebih baru).

• .NET beban kerja pengembangan desktop dengan komponen opsional berikut diaktifkan:

  • GitHub Copilot
  • Agen modernisasi GitHub Copilot

• GitHub Copilot Langganan (berbayar atau gratis).

• Masuk ke Visual Studio menggunakan akun GitHub dengan akses Copilot.

  Penting

  Jika Anda mengubah langganan, Anda harus memulai ulang Visual Studio.

• Kode harus ditulis dalam C#.

Nota

Prasyarat ini berlaku untuk Visual Studio. Untuk lingkungan pengembangan lainnya, lihat Menginstal modernisasi GitHub Copilot.

Menilai kesiapan aplikasi

Modernisasi GitHub Copilot untuk penilaian .NET membantu Anda menemukan tantangan kesiapan aplikasi, mempelajari dampaknya, dan melihat tugas migrasi yang direkomendasikan. Setiap tugas migrasi mencakup referensi untuk menyiapkan sumber daya Azure, menambahkan konfigurasi, dan membuat perubahan kode. Ikuti langkah-langkah berikut untuk memulai migrasi Anda:

1. Klon repositori sampel kopilot migrasi .NET ke komputer Anda.

2. Di Visual Studio, buka solusi Contoso University dari repositori sampel.

3. Di Solution Explorer, klik kanan simpul solusi dan pilih Modernize.

   

4. Jendela obrolan GitHub Copilot terbuka dengan pesan selamat datang dan opsi yang telah ditentukan sebelumnya. Pilih Migrasikan ke Azure dari pilihan yang tersedia dan kirim ke Copilot.

   

   Tip

   Alih-alih langkah 3 dan 4, Anda dapat membuka GitHub Copilot Chat secara langsung dan mengirim @Modernize Migrate to Azure untuk memulai penilaian dan alur migrasi.

5. Sesi obrolan Copilot baru terbuka dan menampilkan pesan selamat datang. Penilaian dimulai secara otomatis dan menganalisis proyek Anda untuk kesiapan migrasi.

   

6. Setelah penilaian selesai, Anda akan melihat halaman UI laporan penilaian komprehensif dan daftar tugas migrasi di jendela obrolan.

   

Migrasi aplikasi

Modernisasi GitHub Copilot untuk .NET mencakup tugas yang telah ditentukan sebelumnya untuk skenario migrasi umum dan mengikuti praktik terbaik Microsoft.

Memulai tugas migrasi

Mulai tugas migrasi dengan salah satu cara berikut:

Opsi 1. Jalankan Laporan Penilaian

Pilih tombol Jalankan Tugas di Laporan Penilaian dari langkah sebelumnya untuk memulai tugas migrasi.

Opsi 2. Kirim ke Copilot Chat

Kirim nomor tugas migrasi (misalnya, 1.1) atau namanya dalam obrolan.

Pembuatan pelacak rencana dan kemajuan

• Saat Anda memulai migrasi, GitHub Copilot memulai sesi bernama "Modernisasi: bermigrasi dari <source technology> ke <target technology>" dalam mode agen dengan perintah yang telah ditentukan sebelumnya.
• Alat ini membuat dua file di .appmod/.migration folder:
  • plan.md: Rencana migrasi keseluruhan.
  • progress.md: Pelacak kemajuan yang diperbarui oleh GitHub Copilot saat tugas diselesaikan.
• Edit file-file ini untuk menyesuaikan migrasi Anda sebelum melanjutkan.

Memulai perbaikan kode

• Jika Anda puas dengan rencana dan pelacak kemajuan, masukkan perintah untuk memulai proses migrasi, seperti:

  The plan and progress tracker look good to me. Go ahead with the migration.
  

• GitHub Copilot memulai proses migrasi dan mungkin meminta persetujuan Anda untuk menggunakan alat pangkalan pengetahuan di server Model Context Protocol (MCP). Berikan izin saat diminta.

• Copilot mengikuti pelacak rencana dan kemajuan untuk:

  • Mengelola dependensi.
  • Terapkan perubahan konfigurasi.
  • Buat perubahan kode.
  • Bangun solusi, perbaiki semua kesalahan kompilasi dan konfigurasi, dan pastikan build berhasil.
  • Memperbaiki kerentanan keamanan.

Pesan obrolan default

Modernisasi GitHub Copilot untuk .NET menyediakan opsi pesan obrolan default untuk menyederhanakan alur kerja Anda.

Pilih salah satu opsi yang telah ditentukan sebelumnya dan kirimkan dalam obrolan:

• Buat penilaian modernisasi: Memulai penilaian baru aplikasi Anda untuk mengidentifikasi masalah kesiapan migrasi dan Azure tantangan kompatibilitas.
• Lihat laporan penilaian: Membuka laporan penilaian sebelumnya dan menunjukkan ringkasan tugas migrasi berdasarkan hasilnya. Jika tidak ada penilaian sebelumnya, sistem akan menjalankan penilaian baru terlebih dahulu.
• Telusuri tugas migrasi teratas: Menampilkan tugas migrasi yang direkomendasikan dan skenario modernisasi umum, terlepas dari hasil penilaian tertentu.

Tip

Pesan default ini membantu Anda dengan cepat menavigasi alur kerja umum tanpa mengetik permintaan kustom. Anda juga dapat memasukkan pesan Anda sendiri untuk berinteraksi dengan Copilot untuk pertanyaan atau kebutuhan tertentu.

Langkah selanjutnya

• Bekerja dengan penilaian
• Tugas yang Telah Ditentukan Sebelumnya
• Tanya Jawab Umum

Prerequisites

• Akun GitHub dengan langganan GitHub Copilot aktif dalam paket apa pun.

• Versi terbaru Visual Studio Code. Harus versi 1.101 atau yang lebih baru.

  • GitHub Copilot dalam Visual Studio Code. Untuk petunjuk penyiapan, lihat Menyiapkan GitHub Copilot di Visual Studio Code. Pastikan untuk masuk ke akun GitHub Anda dalam Visual Studio Code.
  • Modernisasi GitHub Copilot. Mulai ulang Visual Studio Code setelah penginstalan.

• Lingkungan pengembangan .NET untuk membangun dan menguji proyek.

Menilai kesiapan aplikasi

Modernisasi GitHub Copilot untuk penilaian .NET membantu Anda menemukan tantangan kesiapan aplikasi, mempelajari dampaknya, dan melihat tugas migrasi yang direkomendasikan. Setiap tugas migrasi mencakup referensi untuk menyiapkan sumber daya Azure, menambahkan konfigurasi, dan membuat perubahan kode. Ikuti langkah-langkah berikut untuk memulai migrasi Anda:

1. Klon repositori sampel kopilot migrasi .NET ke komputer Anda.

2. Di Visual Studio Code, buka solusi Contoso University dari repositori sampel.

3. Buka ekstensi GitHub Copilot modernisasi.

4. Di bagian MULAI CEPAT , pilih Mulai Penilaian. Halaman Laporan penilaian terbuka.

5. Pilih Jalankan Penilaian di sudut kanan atas halaman.

   

6. Penilaian dimulai secara otomatis dan menganalisis proyek Anda untuk kesiapan migrasi.

   

7. Setelah penilaian selesai, Anda akan melihat halaman UI laporan penilaian komprehensif dan daftar tugas migrasi di jendela obrolan.

   

Migrasi aplikasi

Modernisasi GitHub Copilot untuk .NET mencakup tugas yang telah ditentukan sebelumnya untuk skenario migrasi umum dan mengikuti praktik terbaik Microsoft.

Migrasi berbasis obrolan (disarankan)

Migrasi berbasis obrolan adalah cara yang disarankan untuk memulai migrasi. Agen AppModernization-DotNet kustom dioptimalkan untuk tugas modernisasi aplikasi. Agen ini memungkinkan Anda menggunakan perintah bahasa alami yang sederhana untuk melakukan skenario migrasi yang kompleks.

Selesaikan langkah-langkah berikut untuk memilih agen kustom dan mulai migrasi:

1. Pastikan Anda membuka proyek .NET di Visual Studio Code.

2. Pilih ikon obrolan di bilah Activity untuk membuka jendela obrolan Copilot.

3. Di jendela obrolan, temukan menu dropdown pemilih agen di bagian atas kotak input obrolan. Pilih AppModernization-DotNet dari daftar. Agen kustom ini dirancang untuk .NET modernisasi aplikasi dan skenario migrasi.

   

4. Masukkan perintah menggunakan format migrate from <source> to <target> di jendela obrolan. Contohnya:

   migrate from rabbitmq to Azure service bus
   

5. Agen menganalisis kode Anda, membuat rencana migrasi, membuat perubahan kode, menjalankan validasi, dan menghasilkan ringkasan. Pilih Lanjutkan untuk melanjutkan setiap langkah dan Tetap menerima perubahan.

Memulai tugas migrasi dari UI

Anda juga dapat memulai tugas migrasi dari UI:

Opsi 1. Jalankan Laporan Penilaian

Pilih tombol Jalankan Tugas di Laporan Penilaian dari langkah sebelumnya untuk memulai tugas migrasi.

Opsi 2. Menerapkan tugas yang telah ditentukan sebelumnya

Jalankan tugas tertentu di bagian TASKS - .NET. Misalnya, tugas Migrate Database ke Azure Database for PostgreSQL di bawah Database Tasks memperbarui koneksi database, konfigurasi, dependensi, dan kode akses data Anda untuk menggunakan Azure Database for PostgreSQL.

Pembuatan pelacak rencana dan kemajuan

Saat Anda memulai migrasi, GitHub Copilot memulai sesi dalam mode agen.

Alat ini membuat dua file di .github/appmod/code-migration/<target-branch-name> folder:

• plan.md: Rencana migrasi keseluruhan.
• progress.md: Pelacak kemajuan yang diperbarui oleh GitHub Copilot saat tugas diselesaikan.

Edit file-file ini untuk menyesuaikan migrasi Anda sebelum melanjutkan.

Memulai perbaikan kode

Saat Anda puas dengan rencana dan pelacak kemajuan, masukkan lanjutkan untuk memulai migrasi.

GitHub Copilot memulai proses migrasi dan mungkin meminta persetujuan Anda untuk menggunakan alat pangkalan pengetahuan di server Model Context Protocol (MCP). Berikan izin saat diminta.

Copilot mengikuti pelacak rencana dan kemajuan untuk:

• Mengelola dependensi.
• Terapkan perubahan konfigurasi.
• Buat perubahan kode.
• Bangun proyek, perbaiki semua kesalahan kompilasi dan konfigurasi, dan pastikan build berhasil.
• Memperbaiki kerentanan keamanan.

Berulang kali pilih atau masukkan Lanjutkan untuk mengonfirmasi penggunaan alat atau perintah dan tunggu hingga perubahan kode selesai.

Nota

Di Visual Studio Code, modernisasi menggunakan AppModernization-DotNet agen kustom dengan Claude Sonnet 4.5 secara default untuk hasil terbaik saat memperbarui kode .NET untuk bermigrasi ke Azure. Ini kembali ke model 'otomatis' jika Sonnet 4.5 tidak tersedia untuk Anda. Anda dapat mengonfigurasi agen kustom untuk mengubah pengaturan 'model' dengan memilih Konfigurasikan Agen Kustom dari menu Agen . Atau, Anda dapat menggunakan pemilih model bahasa di jendela obrolan untuk beralih model untuk sesi obrolan saat ini.

Perulangan validasi

Setelah perubahan kode selesai, alat migrasi memulai perulangan validasi dan perbaikan. Perulangan ini mencakup lima langkah berikut:

1. Deteksi Kerentanan dan Paparan Umum (CVE) dalam dependensi saat ini dan perbaiki.
2. Bangun proyek dan atasi kesalahan build apa pun.
3. Analisis kode untuk konsistensi fungsi.
4. Analisis proyek untuk menemukan kegagalan pengujian unit dan secara otomatis buat rencana untuk memperbaikinya hingga pengujian berhasil.
5. Analisis kode untuk item migrasi yang terlewatkan dalam migrasi kode awal dan perbaiki.

Setelah semua proses selesai, alat migrasi menghasilkan ringkasan. Tinjau perubahan kode dan konfirmasikan dengan memilih Simpan.

Langkah Selanjutnya

• Tugas yang Telah Ditentukan Sebelumnya
• Tanya Jawab Umum modernisasi GitHub Copilot