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:

○ How would you like to modernize your app?

  > Assess
    Analyze modernization readiness across one or multiple applications
    Plan
    Generate a structured plan to guide the agent
    Execute
    Run the tasks defined in the modernization plan

  Or select a quick-start scenario:

    Upgrade
    Upgrade runtimes and frameworks across one or multiple applications

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. Java upgrade ve Cloud Hazırlık gibi değerlendirme etki alanlarını seçin ve Enter tuşlarına basın.
  4. Çö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.
  5. 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.
  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. 1'i seçin. Planı makinenizde oluşturmak için planı yerel tutun veya 2'yi seçin. Bulut aracısının oluşturmasını sağlamak için Bulut Aracısı'na gönderin. Seçenek 2 deneyseldir.
  3. Yeni oluşturulan değerlendirme raporu varsayılan olarak planı oluşturmak için seçilir. 1'i seçin. Bunun yerine belirli gereksinimlerinizi açıklamak istiyorsanız rapor yok.
  4. Varsayılan adı kullanmak için bir plan adı girin veya Enter tuşuna basın.
  5. Modernleştirme hedefinizi istem olarak girin. Varsayılan olarak, istem değerlendirme bulgularına göre bir plan oluşturmaktır Based on the assessment report, upgrade the project and migrate to Azure . 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
  6. Planı oluşturmak için Enter tuşuna basın.
  7. Aracı, kod tabanınızı analiz eder ve isteği netleştirmenizi ister. Önerilen bir yanıtı seçebilir veya kendi yanıtınızı yazabilirsiniz.

Ajan tüm bilgileri toplar ve şunları oluşturur:

  • Plan dosyası (.github/modernize/{plan-name}/plan.md): Ayrıntılı strateji ve yaklaşım.

Tavsiye

Açıklamaları eklemek veya ayrıntıları ayarlamak için el ile düzenleyebilirsiniz plan.md .

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

Geri bildiriminiz, modernleştirme aracısının geliştirilmesine yardımcı olur. TUI'yi Modernleştir'den geri bildirim göndermek için F tuşuna basın.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

Ayrıca github-copilot-appmod deposunda sorun oluşturabilir veya GitHub Copilot modernleştirme geri bildirim formunu kullanabilirsiniz.

  • Last updated on