Çekme isteklerini gözden geçirme

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

İpucu

Azure DevOps görevlerine yardımcı olması için yapay zekayı kullanabilirsiniz. Başlamak için bkz. Azure DevOps MCP Sunucusu ile yapay zeka yardımlarını etkinleştirme .

Çekme isteği (PR) oluşturduğunuzda ve gerekli/isteğe bağlı gözden geçirenleri belirttiğinizde, Azure Repos gözden geçirenlere çekme isteğinizin gözden geçirmeye hazır olduğunu bildirir. Değişikliklerin hedef dala birleştirilebilmesi için pull request'inizdeki değişiklikleri gerekli tüm gözden geçirenlerin onaylaması gerekir. Kritik dalları, örneğin main dalını değiştiren PR'ler için, ekibiniz gözden geçirenleri belirten veya en az sayıda gözden geçiren gerektiren dal ilkeleri oluşturmuş olabilir. Dal stratejileri çekme isteğinize isteğe bağlı gözden geçirenler eklerse, bunları tutabilir, zorunlu kılabilir veya kaldırabilirsiniz. Dal ilkeleri çekme isteğinize gerekli gözden geçirenleri eklerse, bunları isteğe bağlı yapamaz veya kaldıramazsınız. Dal politikaları aracılığıyla gözden geçirenleri atama hakkında bilgi için bkz Kod gözden geçirenleri otomatik olarak ekleme.

Bir PR'yi inceliyorsanız, kesin ve anlaşılması kolay yapıcı geri bildirimler vermeyi deneyin. Geri bildirimleri gözden geçirme hakkında daha fazla bilgi için Çekme isteği geri bildirimi bölümüne bakın. Bu makalede Azure DevOps'ta çekme isteklerinin nasıl gözden geçirıldığı açıklanır.

Azure DevOps PR'lerini web portalında yalnızca tarayıcınızı kullanarak gözden geçirebilirsiniz.

Bu makalede şunları öğreneceksiniz:

• Değişiklikleri gözden geçirme
• Açıklamaları kullanma
• Dosyaları düzenleme
• gözden geçirilmiş dosyaları izleme
• PR değişikliklerine oy verin
• Çekme isteğini tamamla

Önkoşullar

• Azure DevOps proje ayarlarınızda depoların etkinleştirilmesi gerekir. Eğer Repos hub'ı ve ilişkili sayfalar görüntülenmiyorsa, Repos'u yeniden etkinleştirmek için Azure DevOps hizmetini açma veya kapatma konusuna bakın.

• PR'leri gözden geçirmek için, en az Temel erişimiyle çekme isteğinin içinde olduğu Azure DevOps projesinin bir üyesi olun.

  • Projeniz yoksa bir proje oluşturun veya ücretsiz kaydolun.

  • Proje üyesi değilseniz, eklenin.

  Not

  Ortak projeler için Paydaş erişimi verilen kullanıcılar Azure Repos'a tam erişime sahiptir.

• İzinler ve erişim hakkında daha fazla bilgi için bkz . Varsayılan Git deposu ve dal izinleri ve Erişim düzeyleri hakkında.

Azure DevOps Services'da PR'leri Yönetmek için Azure DevOps komut satırı arabirimini (CLI) kullanabilirsiniz. Azure Cli ve Azure DevOps uzantısını yüklediğinizde Azure DevOps CLI kullanılabilir. PR'leri yönetmeye yönelik CLI komutlarının listesi için az repos pr komutlarına bakın.

Değişiklikleri gözden geçirme

Pull istekleri, bu değişiklikler bir depodaki hedef dalda uygulanmadan önce belirlenen gözden geçirenler tarafından önerilen değişikliklerin incelenmesine, tartışılmasına ve oylanmasına olanak tanır. Geliştirme aynı dosyalarla farklı dallarda gerçekleştiriliyorsa çakışan değişiklikler olabileceğini unutmayın. Bu durumda, bu çakışmaları dikkatlice analiz etmek ve çözmek gerekir. Bunu yapmak için kaynak, hedef veya her iki daldaki değişiklikleri doğru şekilde uygulamak için dosyanın el ile düzenlenmesi gerekebilir. Kaynaktan veya hedeften tüm değişiklikleri almak (tek bir düğme tıklaması ile yapılabilir) en uygun olmayabilir ve bazı gerekli değişikliklerin kaybolmasına neden olabilir. Bu, ADO araçları kullanılarak yapılabilir veya geliştirme araçlarını (Visual Studio gibi) kullanmak daha kullanışlı olacaktır.

Daha fazla bilgi edinmek için bkz. Birleştirme çakışmalarını çözme.

Azure Repos'ta PR'leri inceleyenlerin önerilen değişiklikleri anlamak için bir PR'de nasıl gezinebileceğini açıklayan adımlar aşağıda verilmiştir:

1. Web tarayıcınızdan Azure DevOps kuruluşunuz için ekip projesini açın. Çekme isteklerini listelemek için Depo > Çekme istekleri'ni seçin. Yeni açılan bir PR varsayılan olarak Genel Bakış sekmesine gelir.

2. Çekme isteğinin Genel Bakış sekmesinde başlık, açıklama, gözden geçirenler, bağlantılı çalışma öğeleri, geçmiş, durum ve açıklamalar gösterilir. Önerilen değişiklikleri görmek için çekme isteği (PR) açıklamasını okuyun. Diğer gözden geçirenlerin oluşturduğu sorunları anlamak için açıklamaları görüntüleyin.

   Not

   Her dosya bir dizi değişiklik için tahmin edilir ve adının yanında "+" işareti veya "yeniden adlandır, düzenle" etiketiyle işaretlenir. Bir dosyada yüzde 50'den fazla değişiklik olduğunda yeniden adlandırılmış olarak kabul edilir . Bu, değiştirilemeyen git depoları için varsayılan eşiktir.

   

3. Çekme isteğinin kaynak dalındaki tüm içerik değişikliklerini gözden geçirmek için Dosyalar sekmesine tıklayın. İlk görünümde tüm dosya değişikliklerinin özet görünümü gösterilir. Yalnızca bu dosyanın değişikliklerini görüntülemek için dosyanın yanındaki Görünüm düğmesini seçin. Dosya değiştirildiyse, Görünüm düğmesi fark görünümünü açar. Dosya eklendiyse veya silindiyse, Görünüm düğmesi bir içerik bölmesi açar.

   

   Not

   Performans nedenleriyle, özet görünümü 0,5 MB'tan büyük bir dosyanın değişikliklerini göstermez.

4. Bir dosyanın fark görünümünde Yan yana veya Satır içi fark düzenini seçebilirsiniz.

   

   İpucu

   5 MB'tan büyük tek bir dosya için fark görünümü kısaltılmış dosya içeriğini gösterir. İçeriğin tamamının fark görünümü için yerel bir fark aracı kullanarak bu tür dosyaları indirin ve gözden geçirin.

   Başka bir dosyayı görüntülemek için sol taraftaki dosya ağacını kullanın veya tüm dosya değişikliklerinin özet görünümünü görmek için dosya ağacının kökünü seçin.

5. Belirli gönderimler tarafından kaynak dalına sunulan değişiklik kümesini incelemek için, değişiklikler açılır listesinden bir veya birkaçını seçin. Bir veya daha fazla değişiklik kümesini seçtiğinizde fark görünümü yalnızca seçili değişiklik kümelerinden yapılan değişiklikleri gösterecek şekilde güncelleştirilir. Bu özellik, son incelemenizden bu yana PR'ye değişiklikler yüklendiğinde ve yalnızca yeni değişiklikleri görmek istediğinizde kullanışlıdır. Değişiklikler açılan listesi, her gönderme işlemindeki her değişiklik kümesini, son commit'teki işlem iletisiyle adlandırır.

   

   İpucu

   Birden çok değişiklik kümesini değişiklikler açılır listesinden seçerken Shift tuşunu basılı tutun.

6. Kaynak dal değişikliklerini kaçırmadığınızdan emin olmak için gönderilen tüm değişiklik kümelerini görüntülemek için Güncelleştirmeler sekmesini seçin. Değişiklik kümeleri numaralandırılır ve en son değişiklik kümesi listenin en üstünde görünür. Her değişiklik kümesi, bu gönderme işleminde gönderilen işlemeleri gösterir. Zorla gönderilen bir değişiklik kümesi, değişiklik kümesi geçmişini değiştirmez ve diğer tüm değişiklik kümeleri gibi değişiklik kümesi listesinde gösterilir.

   

7. Hedef daldan ayrılan kaynak dalın işleme geçmişini görüntülemek için İşlemeler sekmesini seçin. PR yazarı farklı bir işleme geçmişini zorla gönderirse, İşlemeler sekmesindeki işleme geçmişinin üzerine yazılır. Bu nedenle, İşlemeler sekmesinde gösterilen işlemeler, Güncellemeler sekmesinde gösterilen işlemelerden farklı olabilir.

   

Dosyaları gözden geçirme

Kaynak dalda yapılan gerçek değişiklikleri, çekme isteğinin hedef dalına göre görüntülemek için Dosyalar sekmesini seçin.

Not

Azure DevOps Çekme isteği ile Azure DevOps Dal karşılaştırması arasındaki farklara, farklı karşılaştırma yöntemleri neden oluyor.

Git diff komutu için iki karşılaştırma yöntemi vardır: İki noktalı (git diff A..B) ve üç noktalı (git diff A...B). Varsayılan olarak, Çekme İstekleri üç noktalı fark gösterirken Dal Karşılaştırması bunun yerine iki noktalı fark gösterir.

Örneğin:

      C---D---E branch
     /
A---B---F---G   master

Çekme İstekleri: git diff branch...master yalnızca C, D, E işlemelerini üretecek. Dal Karşılaştırma: git diff branch..master C, D, E, F, G işlemeleri oluşturur.

Diğer ayrıntılar için bkz. Üç Nokta ve İki Nokta Git-Diff Karşılaştırmaları ve git farkı

Not

Seçilen tek bir dosya için farkı görüntülerken, dosya boyutu sınırı 5 MB'tır. 5 MB'tan büyük dosyaları görüntülemek ve fark etmek için dosyayı indirebilir ve yerel fark aracını kullanarak görüntüleyebilirsiniz. Bir dosya koleksiyonu için farkı görüntülerken, performans nedeniyle her dosya için boyut sınırı 0,5 MB'tır.

Güncelleştirmeleri gözden geçirme

Kodun önceki sürümlerini Tüm güncellemeler açılır listesinden gözden geçirin.

Dalda yapılan her güncelleştirme, listedeki versiyonlara ve çekme isteğinin Güncelleştirmeler sekmesinde yeni bir sürüm ekler. Farklı güncellemeleri seçtiğinizde, karşılaştırma görünümü PR'nin her sürümündeki dosyalar arasındaki farkları gösterir.

Son gözden geçirmenizden bu yana yapılan değişikliklere adım adım ilerleyerek halkla ilişkiler güncellemelerini PR'den (çekme isteğinden) uzak kaldıktan sonra yakalayabilirsiniz.

Güncelleştirmeler sekmesinde yazardan gelen değişikliklerin listesine göz atın.

İşlemeler sekmesinde dalda yapılan işlemelerde yapılan değişiklikleri görüntüleyin ve seçin.

Açıklamaları kullanma

Çekme isteği yazarları ve gözden geçirenler, PR yorumları ekleyip yanıtlayarak birbirleriyle iletişim kurabilir. PR'yi gözden geçirirken, önerilen değişikliklerle ilgili sorunları belirtmek, değişiklikler önermek ve önceki açıklamalara yanıt vermek için açıklamaları kullanın. Kesin ve anlaşılması kolay yapıcı geri bildirimleri hedefleyin. Alıcıları doğrudan @username kullanarak hitap edin. #workitemID kullanarak iş öğelerine ve !pullrequestID kullanarak diğer PR'lere başvurun. Pr yazarları bazen belgeleme amacıyla kendileri için açıklamalar oluşturur.

Yorumlarda geri bildirim sağlayın

Geri bildiriminiz bir dosyadaki belirli bir satır veya satır aralığı için geçerliyse, dosyanın içindeki o konuma bir açıklama ekleyin:

1. PR'nin Dosyalar sekmesinde, yorum eklemek istediğiniz satırın üzerine gelin ve satır içi yorum kutusunu açmak için yorum düğmesine tıklayın. Ayrıca birden çok satır seçebilir ve ardından söz konusu satırların üzerine geldiğinizde görüntülenen açıklama düğmesini seçebilirsiniz.

   

2. Açıklama kutusuna açıklamanızı girin ve Açıklama'yı seçin.

   

Geri bildiriminiz dosyanın tamamı için geçerliyse, dosya seçenekleri menüsünden Açıklama ekle'yi seçerek dosya düzeyinde bir açıklama ekleyin:

Belirli bir dosyayla ilgili olmayan genel geri bildirim sağlamak için Genel Bakış sekmesine bir açıklama ekleyin:

Çekme isteği gözden geçirenler, sonraki bölümde açıklandığı gibi belirli dosya satırlarında değişiklik önermek için açıklamaları da kullanabilir.

Açıklamalarda değişiklik önerin

Bir dosyadaki bir veya daha fazla satır için değiştirme metni önermek için açıklamaları kullanabilirsiniz:

1. PR'nin Dosyalar sekmesinde, yorum eklemek istediğiniz satırın üzerine gelin ve satır içi yorum kutusunu açmak için yorum düğmesine tıklayın. Ayrıca birden çok satır seçebilir ve ardından söz konusu satırların üzerine geldiğinizde görüntülenen açıklama düğmesini seçebilirsiniz. Kabul edilirse, önerilen içeriğiniz açıklamanızın eklendiği satırın veya satırların yerini alır.

   

2. Açıklama kutusunun altındaki ampul simgesini seçerek önerilen değişikliklerinizi, çevrelenmiş bir kod bloğunun içindeki açıklama kutusunda yapın ve ardından Açıklama'yı seçin. Yan yana karşılaştırma görünümünün özgün koduna (sol tarafta) açıklama eklerseniz ampul simgesini görmezsiniz.

   

PR yazarları önerinizi şu şekilde kabul edebilir:

1. "Değişiklikleri sahneye almak için Değişiklikleri Uygula seçeneğini seçin ve işleme hazır hale getirin."

   

2. Tüm aşamalı değişiklikleri işlemek için Tüm değişiklikleri işle'yi seçin. Çekme isteği yazarları, bir öneriyi kaldırmak için Değişikliği geri al seçeneğini kullanabilir.

   

Açıklamaları düzenleme veya silme

Açıklamanın üzerine gelip düzenle veya sil simgesini seçerek açıklamanızı düzenleyebilir veya silebilirsiniz :

Açıklamaları beğenme

PR yazarları ve gözden geçirenler, açıklamanın üzerine gelip başparmak simgesini seçerek kendi yorumlarını veya başka birinin açıklamasını beğenebilir:

Beğeni alan yorumlar, doldurulmuş bir başparmak yukarı simgesi ve beğeni sayısını gösterir. Açıklamayı beğenen kişilerin listesini görmek için başparmak yukarı simgesinin üzerine gelin.

Açıklamaları yanıtlama

PR yazarları, gözden geçirenlere geri bildirim ve önerileri nasıl ele aldıklarını bildirmek için yorumları yanıtlamalıdır:

1. Açıklamayı yanıtlamak için Yanıt yaz alanına yanıtınızı yazın. Alıcıları doğrudan @username kullanarak hitap edin. #workitemID kullanarak iş öğelerine ve !pullrequestID kullanarak diğer PR'lere başvurun.

   

2. Yanıtınızı girdikten sonra, yanıtınız son ise Yanıtla ve çöz'ü seçin. Aksi takdirde Yanıtla'yı seçin.

   

   Yanıtla ve çöz'ü seçerseniz açıklama durumu Çözüldü olarak değişir. Çekme isteği yazarları, sonraki bölümde açıklandığı gibi doğrudan bir açıklamanın durumunu da değiştirebilir.

Açıklama durumunu değiştirme

Yeni açıklamalar başlangıçta Etkin bir duruma sahiptir ve bu durum, PR yazarlarının gözden geçirme sürecinde, gözden geçirenlerin geri bildirimlerini ve önerilerini nasıl ele aldıklarını belirtmek için güncellenir. PR yazarları durum açılır listesinden bir yorum durumu seçebilir.

• Etkin: Yeni açıklamalar için varsayılan durum.

• Beklemede: Bu açıklamadaki sorun gözden geçiriliyor ve başka bir şeyin tamamlanmasını bekliyor.

• Çözüldü: Bu açıklamadaki sorun giderildi.

• Düzeltilmeyecek: Bu açıklamadaki sorun belirtilmiştir ancak düzeltilmeyecektir.

• Kapatıldı: Bu açıklamadaki tartışma kapatıldı.

Çekme isteği yazarları ve gözden geçirenler, sonraki bölümde açıklandığı gibi yorumları filtreleyerek çekme isteği ilerlemesini izleyebilir.

Açıklamaları filtreleme

Açıklama filtresi açılan listesinden bir filtre seçeneği belirleyerek Genel Bakış sekmesinde hangi açıklamaların veya güncelleştirmelerin göstereceğini seçebilirsiniz. Örneğin, çekme isteğini en son açmanızdan bu yana eklenen yeni yorumları ve güncellemeleri görmek için 'Yenilikler' filtresini seçin. Her filtre seçeneği, kategori için öğe sayısını gösterir.

Adres açıklamaları

Web'deki Kod'un Dosyalar sekmesinden doğrudan dalınıza hızlı güncellemeler yapabilirsiniz.

Dosyaları düzenleme

Kolaylık sağlamak için PR yazarları dosyaları doğrudan Azure Repos'ta düzenleyebilir. Örneğin, gözden geçirenin önerdiği kod değişikliğini kabul etmiş ve başka bir yerde benzer değişiklikler yapmak isteyebilirsiniz.

1. Dosyaları Depola'yı >seçin, çekme isteği kaynak dalını seçin, bir dosya seçin ve ardından Düzenle'yi seçin.

   

2. Düzenleyicide değişikliklerinizi yapın ve ardından İşleme iletişim kutusunu açmak için İşle'yi seçin.

   

3. Commit iletişim kutusunda, gerekirse işleme iletisini düzenleyin ve ardından değişiklikleri PR'ınıza işlemek ve göndermek için İşle'yi seçin.

   

gözden geçirilmiş dosyaları izleme

Çekme isteği gözden geçirenler, dosya seçenekleri menüsünden Gözden geçirildi olarak işaretle'yi seçerek veya bir dosya veya klasörün yanındaki onay kutusunu seçmek suretiyle gözden geçirdiği dosyaları izleyebilir.

PR değişikliklerine oy verin

Tarayıcı

PR gözden geçirenler, oy açılır listesinden bir oy seçeneği seçerek bir PR'de oy kullanabilir. Çekme isteği sayfasındaki değerlendirici simgesi oylarını belirtir.

Oylama seçenekleri şunlardır:

• Onayla: Çekme isteğinde önerilen değişiklikleri onaylar. Bu seçenek yalnızca bir oylamadır, ve PR'yi onaylamaz.

• Önerilerle Onayla: PR'deki önerilen değişiklikleri, isteğe bağlı iyileştirme önerileriyle onaylar. Bu seçenek yalnızca bir oylamadır, ve PR'yi onaylamaz.

• Yazarı bekle: Yazardan değerlendirici yorumlarını incelemesini ister. Çekme isteği yazarı, yorumları giderdikten sonra, kodu yeniden gözden geçirmeleri gerektiğini gözden geçirenlere bildirmelidir. Gerekli bir gözden geçiren bu oy seçeneğini ayarlarsa, oy çekme isteği onayını engeller.

• Reddet: Değişikliklerin kabul edilebilir olmadığını gösterir. Bu seçeneği belirlediğinizde nedenini açıklayan bir açıklama ekleyin. Gerekli bir gözden geçiren bu oy seçeneğini ayarlarsa, oy çekme isteği onayını engeller.

• Geri bildirimi sıfırla: Oy hakkınızı sıfırlar. Oy olmaması, bir "pull request"in tamamlanmasını engellemez.

Azure DevOps CLI

PR'nin onaylanıp onaylanmayacağını oylamak için az repos pr set-vote komutunu kullanın.

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

Parametreler

Parametre	Zorunlu	Açıklama
--id	Yes	Pull request kimliği
--vote	Yes	Çekme isteği için yeni oy değeri (kabul edilen değerler: approve, approve-with-suggestions, reject, resetveya wait-for-author)
--detect	Hayır	Kuruluşu otomatik olarak algıla (kabul edilen değerler: false, true)
--organization	Evet, varsayılan kuruluş ayarlanmadıysa ve git yapılandırma dosyası kuruluşu belirtmiyorsa	Azure DevOps kuruluş URL'si veya kullanarak varsayılan bir kuruluş ayarlayın: az devops configure -d organization=<organization URL>
--subscription	Hayır	Azure aboneliğinin adını veya kimliğini belirtin ya da varsayılan bir abonelik ayarlayın: az account set -s <name or ID>

Örnekler

Aşağıdaki komut PR #21'i onaylamak için oy kullanacaktır. komutu bir tablo döndürür.

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

Aşağıdaki komut oyunuzu kaldırır. komutu bir tablo döndürür.

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Çekme isteğini tamamla

PR yazarları çekme isteği çözümleme seçeneği belirleyebilir:

• Tamamla: Gerekli tüm gözden geçirenler onaylamışsa ve tüm gerekli dal ilkeleri karşılandıysa PR'yi şimdi tamamlayın.

• Otomatik tamamlama ayarla: Tüm gerekli gözden geçirenler onayladığında ve gerekli tüm dal ilkeleri karşılandığında çekme isteği otomatik olarak tamamlanır.

• Taslak olarak işaretle: İncelemeye hazır olmadığını göstermek için çekme talebini taslak durumuna ayarlayın. Taslak çekme isteği için Yayımla'yı seçerek taslak durumunu kaldırabilir ve gözden geçirmeye hazır olarak işaretleyebilirsiniz.

• Vazgeç: Çek isteğini kapatın. Terk edilmiş bir çekme isteği için Yeniden etkinleştir'i seçerek geri yükleyebilirsiniz.

Çekme isteğini tamamlama hakkında daha fazla bilgi için Çekme isteği tamamla kısmına bakın.

Sonraki adımlar

Çekme isteğini tamamlama

İlgili makaleler

• Çekme isteği güncelleştirme bildirimleri
• Çekme istekleri ve izinleri hakkında