Aracılığıyla paylaş

Hızlı Başlangıç: GitHub Copilot modernizasyon aracısını yükleme ve kullanma

Bu hızlı başlangıç, GitHub Copilot modernizasyon aracısını yükleme ve örnek bir uygulamayı modernleştirmek için bu aracıyı kullanma adımlarını gösterir.

Önkoşullar

  • GitHub Copilot aboneliği: Ücretsiz, Pro, Pro+, İş veya Kurumsal plan. Bkz. Copilot planları.
  • GitHub CLI: Kimlik doğrulaması gh için GitHub CLI'sini (v2.45.0) veya üzerini yükleyin. Bkz . gh'yi yükleme.

Platform gereksinimleri

  • Windows: x64 veya ARM64.
  • Linux: 2.27 veya üzeri ile glibc x64 veya ARM64 (Ubuntu 18.04 veya üzeri, Debian 10 veya üzeri, Fedora 29 veya üzeri, Azure Linux 2.0 veya üzeri).
  • macOS: Apple Silicon veya Intel.

Modernleştirme aracısını yükleme

Modernleştirme aracısını yüklemek veya en son sürüme güncelleştirmek için aşağıdaki komutları kullanın.

Aşağıdaki seçeneklerden birini kullanın:

Seçenek 1 - Winget (önerilir):

winget install GitHub.Copilot.modernization.agent

İstem olmadan sessiz yükleme için:

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

Seçenek 2 - PowerShell tek satırlık komut:

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

Seçenek 3 - MSI yükleyicisi:

GitHub sürümleri sayfasından en son MSI'yi indirin ve çalıştırın.

Uyarı

Yüklemeden sonra komutun modernize PATH'inizde kullanılabilir olması için yeni bir terminal açın. Bu komutlar hem ilk yükleme hem de en son sürüme güncelleştirme için çalışır. Gelecek bir sürümde özel bir sürüm güncelleştirme komutu sağlanacaktır.

Yüklemeyi doğrulayın:

modernize --version

Örnek uygulama alma

Bu hızlı başlangıç için örnek bir uygulama kullanın. Java veya .NET'i seçin:

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

Etkileşimli modu kullanma

Kullanmaya başlamanın en kolay yolu etkileşimli modu kullanmaktır. İlk olarak GitHub CLI kullanarak kimlik doğrulaması yapın:

gh auth login

Ardından, modernleştirme aracısını çalıştırın:

modernize

Ana menü görüntülenir:

○ 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

1. Adım: Uygulamayı değerlendirme

  1. 1'i seçin. Uygulamayı değerlendirme.
  2. Değerlendirme seçeneklerini yapılandırmak için istemleri izleyin (veya varsayılanları kullanmak için Enter tuşuna basın).
  3. Seçimlerinizi gözden geçirin ve değerlendirmeyi başlatmak için Enter tuşuna basın.
  4. Değerlendirmenin tamamlanmasını bekleyin.

Değerlendirme sonuçları proje dizininize kaydedilir .github\modernize\assessment\ . Aracı şunları tanımlamak için kodunuzu, bağımlılıklarınızı ve yapılandırmanızı analiz eder:

  • Eski çerçeve sürümleri
  • Kullanım dışı API'ler
  • Bulut uyumluluğu sorunları
  • Geçiş fırsatları

2. Adım: Modernleştirme planı oluşturma

Değerlendirme tamamlandıktan sonra aracı, tanımlanan sorunları temel alan bir modernleştirme planı oluşturmanızı ister:

○ 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. 1'i seçin. Modernleştirme planı oluşturun.
  2. Varsayılan adı kullanmak için bir plan adı girin veya Enter tuşuna basın.
  3. Modernleştirme hedefinizi istem olarak girin. Varsayılan olarak, istem değerlendirme bulgularına göre bir plan oluşturmaktır References the assessment summary and creates plan . Bunu başka bir geçiş isteğiyle değiştirebilirsiniz, örneğin:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Planı oluşturmak için Enter tuşuna basın.

Aracı, kod tabanınızı analiz eder ve aşağıdakileri oluşturur:

  • Plan dosyası (.github/modernize/{plan-name}/plan.md): Ayrıntılı strateji ve yaklaşım.
  • Görev listesi (.github/modernize/{plan-name}/tasks.json): Yürütülebilir adımların dökümü.

Tavsiye

Açıklamaları eklemek veya ayrıntıları ayarlamak için el ile düzenleyebilirsiniz plan.md . Planı yürütmeden önce görevleri değiştirmek, yeniden sıralamak, eklemek veya kaldırmak için de güncelleştirebilirsiniz tasks.json .

3. Adım: Modernleştirme planını yürütme

Planı doğruladıktan sonra planı yürütmek istediğinizi onaylayın.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. 1'i seçin. Modernleştirme planını yürütme.
  2. Planı yürütmek için Enter tuşuna basın.
  3. Aracı değişiklikleri uygularken ilerleme durumunu izleyin.

Ajan her görevi sırayla yürütür.

  • Plana göre kod değişiklikleri yapar.
  • Her değişiklik sonrasında derlemeleri doğrular.
  • CVE'leri tarar ve çözer.
  • Değişiklikleri kaydeder.

4. Adım: Sonuçları gözden geçirme

Yürütme tamamlandıktan sonra, aracıyı birleştirmeden önce yaptığı tüm değişiklikleri gözden geçirebilirsiniz:

  1. Değişiklikleri gözden geçirme: Geçerli daldaki değişiklikleri denetleyin.

    git status
git diff main

  2. Pull request oluşturma: Değişikliklerden memnunsanız, ekip incelemesi için bir pull request oluşturun.

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

Sonraki Adımlar

Geri bildirimde bulunun

Girdinize değer veririz! Modernleştirme aracısı hakkında geri bildiriminiz varsa github-copilot-appmod deposunda bir sorun oluşturun veya GitHub Copilot modernleştirme geri bildirim formunu kullanın.

  • Last updated on