Aracılığıyla paylaş


Hızlı Başlat: .NET projeleri için GitHub Copilot ile uygulama modernleştirmesi yoluyla bir .NET projesini değerlendirin ve taşıyın

Bu hızlı başlangıçta, .NET projesini değerlendirir ve geçiş yaparken GitHub Copilot'un .NET için uygulama modernizasyonunu kullanırsınız. Aşağıdaki görevleri tamamlarsınız:

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

Prerequisites

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

.NET değerlendirmesi için GitHub Copilot uygulama 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ını 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 geçiş yardımcı pilotu örnek deposunu bilgisayarınıza kopyalayın.

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

  3. Çözüm Gezgini'nde çözüm düğümüne sağ tıklayın ve Modernleştir'i seçin.

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

  4. GitHub Copilot Sohbet penceresi bir karşılama iletisi ve önceden tanımlanmış seçeneklerle açılır. Kullanılabilir seçenekler arasından Azure'a geçir'i 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'i doğrudan açabilir ve değerlendirme ve geçiş akışını başlatmak için gönderebilirsiniz @Modernize Migrate to Azure .

  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 uygulama modernleştirmesi, yaygın geçiş senaryoları için önceden tanımlanmış görevler içerir ve Microsoft'un en iyi uygulamalarını 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 Chat'e ile 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 Sohbeti'nde ileti göndermenin ekran görüntüsü.

Planlama ve ilerleme izleyicisi oluşturma

  • Geçişi başlattığınızda GitHub Copilot, önceden tanımlanmış istemlerle ajan modunda "<source technology>'dan <target technology>'a taşıma: Uygulama modernleştirme" adlı bir oturumu başlatır.
  • Araç klasörde iki dosya .appmod/.migration oluşturur:
    • plan.md: Genel geçiş planı.
    • progress.md: GitHub Copilot'ın görevleri tamamladıkça güncelleştirdiğ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, plan ve ilerleme izleyicisini takip ederek:

    • 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 uygulama modernleştirmesi, iş akışınızı kolaylaştırmak için varsayılan sohbet iletisi seçenekleri sağlar.

Copilot Sohbeti'nde 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ırma: 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. Belirli sorular veya ihtiyaçlar 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 uygulama 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ını 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 geçiş yardımcı pilotu örnek deposunu bilgisayarınıza kopyalayın.

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

  3. GitHub Copilot uygulama 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 uygulama modernleştirmesi, yaygın geçiş senaryoları için önceden tanımlanmış görevler içerir ve Microsoft'un en iyi uygulamalarını 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. Copilot sohbet penceresini açmak için Etkinlik Çubuğu'ndaki sohbet simgesini seçin.

  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 .NET özel aracısını seçme işleminin 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

GÖREVLER - .NET bölümünde belirli bir görevi çalıştırın. Örneğin, Veritabanı Görevleri altındaki Veritabanını PostgreSQL için Azure Veritabanı'na Geçirme görevi veritabanı bağlantınızı, yapılandırmalarınızı, bağımlılıklarınızı ve veri erişim kodunuzu PostgreSQL için Azure Veritabanı'nı 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'ın görevleri tamamladıkça güncelleştirdiğ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, plan ve ilerleme izleyicisini takip ederek:

  • 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 uygulama modernleştirmesi, .NET kodunu Azure'a geçirmek üzere 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