GitHub Copilot modernleştirme aracısıyla toplu plan oluşturun

Batch planı, tek bir iş akışı ve paylaşılan bir modernleştirme hedefi kullanarak birden çok depo için modernleştirme planları oluşturmanıza olanak tanır. Bu makalede, yürütmeye başlamadan önce birden çok uygulamada tutarlı planlar oluşturma işlemi gösterilmektedir.

Toplu iş planını kullanarak şunları yapabilirsiniz:

  • Tek bir destekli iş akışında birden çok uygulama için planlar oluşturun.
  • Depolara tutarlı bir modernizasyon hedefi uygulayın.
  • Plan kalitesini geliştirmek için değerlendirme bulgularını bağlam olarak kullanın.
  • Yürütmeden önce planları gözden geçirin ve önce hangi depoların modernleştirildiğine karar verin.

Batch planı aşağıdaki avantajları sağlar:

  • Tutarlılık ve denetim:

    • Paylaşılan amaç: Depolar arasında tek bir modernleştirme isteminden başlayın.
    • Karşılaştırılabilir çıkışlar: Yürütmeden önce planları yan yana gözden geçirin.
    • Esnek iyileştirme: Oluşturulan her planı depoya özgü gereksinimleri yansıtacak şekilde düzenleyin.

  • Büyük ölçekte planlama:

    • Portföy görünürlüğü: Aynı isteğin uygulamalar arasında nasıl uygulandığını anlayın.
    • Yeniden kullanım için hazırlık: Önceki aşamalardaki aynı depo listesini ve değerlendirme çıktılarını yeniden kullanın.
    • Daha hızlı karar alma: Önce planlar oluşturun, ardından yalnızca onayladığınız depoları yürütür.

Prerequisites

  • CLI'i modernleştirin.
  • Planlamak istediğiniz tüm depolara erişim.
  • GitHub kimlik doğrulaması yapılandırıldı (gh auth login ).
  • Ajanın değerlendirme bulgularını planlama bağlamı olarak kullanmasını istiyorsanız, tamamlanmış bir toplu değerlendirme önerilir.

Tavsiye

Toplu değerlendirme gerekli değildir, ancak aracı algılanan sorunlara ve geçiş fırsatlarına başvurabildiğinden genellikle daha doğru ve eyleme dönüştürülebilir planlar üretir.

Depoları yapılandırma

Modernleştirme aracısı, planlamak istediğiniz depoları belirtmek için birden çok yolu destekler:

  • Geçerli klasör: Geçerli çalışma dizininizde proje için bir plan oluşturun.
  • El ile giriş: Yerel dizin yollarını veya uzak Git URL'lerini doğrudan girin.
  • Depo yapılandırma dosyası: Tüm depoları listeleyen bir JSON yapılandırma dosyası kullanın.

Depo yapılandırma dosyası

Birçok depoda toplu işlemler için, tüm depoları listelemek için bir JSON yapılandırma dosyası oluşturun. Örneğin, çalışma dizininizde .github/modernize/repos.json konumunda oluşturun veya özel bir yol sağlayın.

Biçim (depo dizisi):

[
    {
        "name": "PhotoAlbum-Java",
        "url": "https://github.com/Azure-Samples/PhotoAlbum-Java.git"
    },
    {
        "name": "PhotoAlbum",
        "url": "https://github.com/Azure-Samples/NewsFeedSite.git"
    }
]

Her depo girişi aşağıdaki alanları destekler:

Alan Açıklama Zorunlu
name Depo için kolay bir ad (raporlarda ve panolarda kullanılır). Yes
url HTTPS veya SSH biçiminde Git kopyası URL'si. url veya path'den biri

Tavsiye

Toplu değerlendirme, toplu plan ve toplu yükseltme iş akışlarında aynı repos.json dosyayı kullanabilirsiniz.

Modernleştirme aracısı, etkileşimli modda repos.json seçtiğinizde .github/modernize/repos.json dosyasını otomatik olarak algılar. Özel bir yol da sağlayabilirsiniz.

Toplu iş planı nasıl çalışır?

Toplu planlama iş akışı:

  1. Depo seçimi: Eklemek istediğiniz depoları seçin.
  2. Bağlam seçimi: İsteğe bağlı olarak kullanılabilir değerlendirme raporlarını giriş olarak kullanın.
  3. İstem tanımı: Modernleştirme hedefinizi bir kez açıklayın ve depolar arasında uygulayın.
  4. Açıklığa kavuşturma: Temsilcinin yönelttiği ek soruları yanıtlayın.
  5. Plan oluşturma: Aracı, seçilen her depo için bir plan oluşturur.

Oluşturulan her plan hedef depoya kaydedilir ve yürütmeden önce gözden geçirilebilir veya düzenlenebilir.

Toplu iş planını çalıştırma

Depolarınızı yapılandırdıktan sonra toplu planlama iş akışını başlatın.

Etkileşimli mod

  1. Modernleştirme aracısını çalıştırın:

    modernize

  2. Ana menüden Plan'ı seçin.

    ○ 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

  3. Hedef depolarınızı nasıl belirleyeceğinizi seçin. Dosya kullanmak için Yapılandırma dosyasından'ırepos.json seçin.

    ○ Choose target repositories

    1. Current folder
      /Users/username/project
    2. Manual input
      Enter local path or remote URL
  > 3. From a config file
      /path/to/.github/modernize/repos.json

    Tavsiye

    Yerel yolları veya uzak Git URL’lerini doğrudan girmek için El ile giriş seçeneğini ya da geçerli dizininizdeki proje için planlama yapmak üzere Geçerli klasör seçeneğini de seçebilirsiniz.

  4. repos.json Dosya varsayılan konumda algılanırsa aracı dosyayı otomatik olarak doldurur. Aksi takdirde, yapılandırma dosyanızın yolunu girin ve Enter tuşuna basın.

  5. Tüm depolar varsayılan olarak seçilidir. Atlamak istediğiniz depoların seçimini kaldırın ve seçiminizi onaylamak için Enter tuşuna basın.

    • Gezinmek için ok tuşlarını kullanın ve tek tek depoları açıp kapatmak için Boşluk Tuşu'na basın.

  6. 1'i seçin. Makinenizde plan 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.

  7. Varsayılanı kullanmak için bir plan adı girin veya Enter tuşuna basın.

  8. Modernleştirme hedefinizi istem olarak girin. Örneğin:

    • upgrade to Spring Boot 3 and prepare for Azure deployment
    • migrate the database to Azure PostgreSQL
    • containerize the application and deploy to Azure Container Apps

  9. Planları oluşturmak için Enter tuşuna basın.

  10. Aracı otomatik olarak çalışır:

    • Seçilen her depoyu kopyalar veya her depo için bir bulut aracısına iş gönderir.
    • Her depo için yerelde bir plan veya planı içeren bir PR oluşturur.

Sonraki Adımlar

Toplu iş planını tamamladıktan sonra, şu komutu kullanarak planları gözden geçirin ve yürütin execute :

Geri bildirimde bulunun

Toplu plan veya 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