Hızlı Başlangıç Kılavuzu: .NET için GitHub Copilot modernizasyonuyla bir .NET projesini değerlendirme ve taşıma

Bu hızlı başlatmada, .NET için GitHub Copilot modernizasyonunu kullanarak bir .NET projesini değerlendirir ve geçirirsiniz. Aşağıdaki görevleri tamamlarsınız:

  • Örnek projeyi değerlendirme (Contoso University)
  • Geçiş işlemini başlatma

Prerequisites

Uyarı

Bu önkoşullar Visual Studio için geçerlidir. Diğer geliştirme ortamları için bkz. GitHub Copilot modernleştirmesini yükleme.

Uygulama hazırlığını değerlendirme

.NET değerlendirmesi için GitHub Copilot modernizasyonu, uygulama hazırlığı sorunlarını bulmanıza, etkilerini öğrenmenize ve önerilen geçiş görevlerini görmenize yardımcı olur. Her geçiş görevi, Azure kaynakları ayarlama, yapılandırma ekleme ve kod değişiklikleri yapma başvurularını içerir. Geçişinizi başlatmak için şu adımları izleyin:

  1. .NET migration copilot samples deposunu bilgisayarınıza kopyalayın.

  2. Visual Studio'da, örnek deposundan Contoso University çözümünü açın.

  3. Solution Explorer'da çözüm düğümüne sağ tıklayın ve Modernize öğesini seçin.

    Bağlam menüsündeki modernleştir seçeneğini gösteren ekran görüntüsü.

  4. GitHub Copilot Sohbet penceresi, karşılama iletisi ve önceden tanımlanmış seçeneklerle açılır. Kullanılabilir seçenekler içinden Azure'a Taşı'yı seçin ve Copilot'a gönderin.

    Geçiş seçeneklerini içeren karşılama iletisini gösteren ekran görüntüsü.

    Tip

    3. ve 4. adımlar yerine, GitHub Copilot Chat doğrudan açabilir ve değerlendirme ve geçiş akışını başlatmak için @Modernize Migrate to Azure gönderebilirsiniz.

  5. Yeni bir Copilot sohbet oturumu açılır ve karşılama iletisi gösterilir. Değerlendirme otomatik olarak başlar ve geçiş hazırlığı için projenizi analiz eder.

    Durum göstergeleriyle devam eden değerlendirmeyi gösteren ekran görüntüsü.

  6. Değerlendirme tamamlandığında, sohbet penceresinde kapsamlı bir değerlendirme raporu kullanıcı arabirimi sayfası ve geçiş görevlerinin listesini görürsünüz.

    Ayrıntılı bulguları içeren oluşturulan değerlendirme raporunu gösteren ekran görüntüsü.

Uygulama geçişleri

.NET için GitHub Copilot modernizasyonu, yaygın geçiş senaryoları için önceden tanımlanmış görevleri içerir ve Microsoft'un en iyi yöntemlerini izler.

Geçiş görevini başlat

Geçiş görevini aşağıdaki yollardan biriyle başlatın:

1. Seçenek Değerlendirme Raporu'ndan yürütme

Geçiş görevini başlatmak için önceki adımdaki Değerlendirme Raporu'nda Görevi Çalıştır düğmesini seçin.

2. Seçenek Copilot Sohbetinde Gönder

Geçiş görev numarasını (örneğin, 1.1) veya adını sohbete gönderin.

Geçiş görevini başlatmak için Copilot Sohbet'te ileti gönderme ekran görüntüsü.

Planlama ve ilerleme izleyicisi oluşturma

  • Geçişi başlattığınızda GitHub Copilot, önceden tanımlanmış istemlerle aracı modunda "<source technology>'den <target technology>'e geçiş: Modernleştirme" adlı bir oturum başlatır.
  • Araç klasörde iki dosya .appmod/.migration oluşturur:
    • plan.md: Genel geçiş planı.
    • progress.md: GitHub Copilot'un görevleri tamamladıkça güncellediği bir ilerleme izleyicisi.
  • Devam etmeden önce geçişinizi özelleştirmek için bu dosyaları düzenleyin.

Kod düzeltmeyi başlatma

  • Plan ve ilerleme izleyiciden memnunsanız, geçiş işlemini başlatmak için aşağıdakiler gibi bir istem girin:

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

  • GitHub Copilot geçiş işlemini başlatır ve Model Bağlam Protokolü (MCP) sunucusundaki bilgi bankası araçlarını kullanmak için onayınızı isteyebilir. İstendiğinde izin verin.

  • Copilot iş planını ve ilerleme izleme sistemini takip eder:

    • Bağımlılıkları yönetme.
    • Yapılandırma değişikliklerini uygulama.
    • Kod değişiklikleri yapın.
    • Çözümü derleyin, tüm derleme ve yapılandırma hatalarını düzeltin ve başarılı bir derleme sağlayın.
    • Güvenlik açıklarını düzeltin.

Varsayılan sohbet iletileri

.NET için GitHub Copilot modernizasyonu, iş akışınızı kolaylaştırmak için varsayılan sohbet iletisi seçenekleri sağlar.

Copilot Chat'teki varsayılan sohbet iletisi seçeneklerini gösteren ekran görüntüsü.

Önceden tanımlanmış seçeneklerden birini seçin ve sohbette gönderin:

  • Modernleştirme değerlendirmesini çalıştırın: Geçişe hazır olma sorunlarını ve Azure uyumluluk zorluklarını belirlemek için uygulamanızın yeni bir değerlendirmesini başlatır.
  • Değerlendirme raporunu görüntüle: Önceki değerlendirme raporunu açar ve sonuçlara göre geçiş görevlerinin özetini gösterir. Önceki bir değerlendirme yoksa, önce yeni bir değerlendirme çalıştırır.
  • En önemli geçiş görevlerine göz atın: Belirli değerlendirme sonuçlarından bağımsız olarak önerilen geçiş görevlerini ve yaygın modernleştirme senaryolarını gösterir.

Tip

Bu varsayılan iletiler, özel istemler yazmadan yaygın iş akışlarında hızla gezinmenize yardımcı olur. Ayrıca, belirli sorular veya gereksinimler için Copilot ile etkileşime geçmek için kendi iletilerinizi de girebilirsiniz.

Sonraki Adımlar

Prerequisites

Uygulama hazırlığını değerlendirme

.NET değerlendirmesi için GitHub Copilot modernizasyonu, uygulama hazırlığı sorunlarını bulmanıza, etkilerini öğrenmenize ve önerilen geçiş görevlerini görmenize yardımcı olur. Her geçiş görevi, Azure kaynakları ayarlama, yapılandırma ekleme ve kod değişiklikleri yapma başvurularını içerir. Geçişinizi başlatmak için şu adımları izleyin:

  1. .NET migration copilot samples deposunu bilgisayarınıza kopyalayın.

  2. Visual Studio Code'da, örnek deposundan Contoso University çözümünü açın.

  3. GitHub Copilot modernleştirme uzantısını açın.

  4. QUICKSTART bölümünde Değerlendirmeyi Başlat'ı seçin. Değerlendirme raporları sayfası açılır.

  5. Sayfanın sağ üst köşesinde değerlendirmeyi çalıştır'ı seçin.

    Geçiş görevini başlatmak için görevler bölümünde görev çalıştırma işleminin ekran görüntüsü.

  6. Değerlendirme otomatik olarak başlar ve geçiş hazırlığı için projenizi analiz eder.

    Geçiş hazırlığı için projenizi analiz eden bir görev çalıştırma işleminin ekran görüntüsü.

  7. Değerlendirme tamamlandığında, sohbet penceresinde kapsamlı bir değerlendirme raporu kullanıcı arabirimi sayfası ve geçiş görevlerinin listesini görürsünüz.

    Değerlendirme raporu kullanıcı arabirimini çalıştırma sayfasının ve geçiş görevlerinin listesinin ekran görüntüsü.

Uygulama geçişleri

.NET için GitHub Copilot modernizasyonu, yaygın geçiş senaryoları için önceden tanımlanmış görevleri içerir ve Microsoft'un en iyi yöntemlerini izler.

Sohbet tabanlı geçiş, geçişi başlatmanın önerilen yoludur. Özel AppModernization-DotNet aracı, uygulama modernleştirme görevleri için iyileştirilmiştir. Bu aracı, karmaşık geçiş senaryoları gerçekleştirmek için basit, doğal dil istemleri kullanmanıza olanak tanır.

Özel aracıyı seçmek ve geçişi başlatmak için aşağıdaki adımları tamamlayın:

  1. Visual Studio Code'da açık bir .NET projeniz olduğundan emin olun.

  2. Activity Bar içindeki sohbet simgesini seçerek Copilot sohbet penceresini açın.

  3. Sohbet giriş kutusunun üst kısmındaki ajan seçim menüsünü sohbet penceresinde bulun. Listeden AppModernization-DotNet öğesini seçin. Bu özel aracı, .NET uygulama modernleştirme ve geçiş senaryoları için tasarlanmıştır.

    Sohbet penceresinde özel .NET aracısını seçme ekran görüntüsü.

  4. Sohbet penceresindeki biçimi migrate from <source> to <target> kullanarak bir istem girin. Örneğin:

    migrate from rabbitmq to Azure service bus

  5. Aracı kodunuzu analiz eder, bir geçiş planı oluşturur, kod değişiklikleri yapar, doğrulamaları çalıştırır ve bir özet oluşturur. Tıklayın: Her adımda ilerlemek için Devam ve değişiklikleri kabul etmek için Sakla.

Kullanıcı arabiriminden geçiş görevi başlatma

Geçiş görevini kullanıcı arabiriminden de başlatabilirsiniz:

1. Seçenek Değerlendirme Raporu'ndan yürütme

Geçiş görevini başlatmak için önceki adımdaki Değerlendirme Raporu'nda Görevi Çalıştır düğmesini seçin.

2. Seçenek Önceden tanımlanmış bir görevi uygula

TASKS - .NET bölümünde belirli bir görevi çalıştırın. Örneğin, Database Görevleri altındaki Migrate Database to Azure Database for PostgreSQL görevi, veritabanı bağlantınızı, yapılandırmalarınızı, bağımlılıklarınızı ve veri erişim kodunuzu Azure Database for PostgreSQL kullanacak şekilde güncelleştirir.

Önceden tanımlanmış belirli bir görevi çalıştırmanın ekran görüntüsü.

Planlama ve ilerleme izleyicisi oluşturma

Geçişi başlattığınızda, GitHub Copilot aracı modunda bir oturum başlatır.

Araç klasörde iki dosya .github/appmod/code-migration/<target-branch-name> oluşturur:

  • plan.md: Genel geçiş planı.
  • progress.md: GitHub Copilot'un görevleri tamamladıkça güncellediği bir ilerleme izleyicisi.

Devam etmeden önce geçişinizi özelleştirmek için bu dosyaları düzenleyin.

Geçiş görevi sırasında plan oluşturmanın ekran görüntüsü.

Kod düzeltmeyi başlatma

Plan ve ilerleme izleyiciden memnun olduğunuzda geçişi başlatmak için devam et yazın.

GitHub Copilot geçiş işlemini başlatır ve Model Bağlam Protokolü (MCP) sunucusundaki bilgi bankası araçlarını kullanmak için onayınızı isteyebilir. İstendiğinde izin verin.

Copilot iş planını ve ilerleme izleme sistemini takip eder:

  • Bağımlılıkları yönetme.
  • Yapılandırma değişikliklerini uygulama.
  • Kod değişiklikleri yapın.
  • Projeyi derleyin, tüm derleme ve yapılandırma hatalarını düzeltin ve başarılı bir derleme sağlayın.
  • Güvenlik açıklarını düzeltin.

Araç veya komut kullanımını onaylamak ve kod değişikliklerinin bitmesini beklemek için sürekli olarak Devam'ı seçin veya girin.

Uyarı

Visual Studio Code'da modernleştirme, .NET kodunu Azure'a geçirecek şekilde güncelleştirirken en iyi sonuçları elde etmek için varsayılan olarak Claude Sonnet 4.5 ile özel aracıyı kullanır AppModernization-DotNet . Sonnet 4.5'in kullanımınıza sunulmamış olması durumunda "otomatik" modele geri döner. Aracı menüsünden Özel Aracıları Yapılandır'ı seçerek özel aracıyı 'model' ayarını değiştirecek şekilde yapılandırabilirsiniz. Alternatif olarak, geçerli sohbet oturumu için model değiştirmek için sohbet penceresindeki dil modeli seçiciyi kullanabilirsiniz.

Doğrulama yinelemesi

Kod değişiklikleri tamamlandıktan sonra geçiş aracı bir doğrulama başlatır ve yineleme döngüsünü düzeltir. Bu döngü aşağıdaki beş adımı içerir:

  1. Geçerli bağımlılıklardaki Yaygın Güvenlik Açıklarını ve Açığa Çıkarmaları (CVE)'leri algılayın ve düzeltin.
  2. Projeyi derleyin ve derleme hatalarını çözün.
  3. İşlevsel tutarlılık için kodu analiz edin.
  4. Birim testi hataları için projeyi analiz edin ve testler geçene kadar bunları düzeltmek için otomatik olarak bir plan oluşturun.
  5. İlk kod geçişinde kaçırılan geçiş öğelerinin kodunu analiz edin ve düzeltin.

Tüm işlemler tamamlandıktan sonra geçiş aracı bir özet oluşturur. Kod değişikliklerini gözden geçirin ve Koru'yu seçerek onaylayın.

Sonraki Adımlar

  • Last updated on