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

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

Önkoşullar

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

Platform gereksinimleri

  • Windows: x64 veya ARM64.
  • Linux: glibc 2.27 veya üzeri yüklü 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 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ı:

gh auth login

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

modernize

Ana menü görüntülenir:

○ What would you like to do?

  > Assess        Analyze your source application and generate an assessment report
    Plan          Create a modernization plan based on assessment findings
    Execute       Run tasks defined in your modernization plan
  ──────────────
    Upgrade       Upgrade your runtime and frameworks to the latest versions

1. Adım: Uygulamayı değerlendirme

  1. Ana menüden Değerlendir'i seçin.
  2. Hedef depolarınızı nasıl belirleyeceğinizi seçin. Geçerli dizini kullanmak için Geçerli klasör'ü, yerel yolları veya uzak Git URL'lerini girmek için El ile girdi'yi veya bir JSON yapılandırma dosyasından depoları yüklemek için Yapılandırma dosyasından seçebilirsiniz. Bu hızlı başlangıç için Geçerli klasör'e tıklayın.
  3. Yürütme modunu seçin. Değerlendirmeyi makinenizde çalıştırmak için Yerel olarak değerlendir'i veya bulut aracılarının değerlendirmeyi paralel olarak çalıştırmasına izin vermek için Bulut Aracılarına Temsilci Seç'i seçin. Bu hızlı başlangıç için Yerel olarak değerlendir'i seçin.
  4. Java upgrade ve Cloud Hazırlık gibi değerlendirme etki alanlarını seçin ve Enter tuşlarına basın.
  5. Çözümleme Kapsamı ve Hedef Çalışma Zamanı gibi değerlendirme yapılandırma seçeneklerini gözden geçirin. Önerilen varsayılanları kabul etmek veya ayarları gerektiği gibi ayarlamak için Devam Et'teEnter tuşuna basın.
  6. Varsayılan çıkış yolunu kabul edin veya özel bir çıkış yolu girin ve ardından değerlendirmeyi başlatmak için Enter tuşuna basın.
  7. 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

Girişiniz önemlidir! 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