Çekme isteklerini gözden geçirme

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Çekme isteğini gözden geçiriyorsanı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 pull isteklerinin nasıl gözden geçirildiği 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
• Pull request değişikliklerine oy verin
• Bir PR'yi tamamla

Önkoşullar

• Azure DevOps proje ayarlarınızda depoların etkinleştirilmesi gerekir. Depolar hub'ü ve ilişkili sayfalar görüntülenmiyorsa, Depolar'ı yeniden etkinleştirmek için bkz: Azure DevOps hizmetini açma veya kapatma.

• PR'leri gözden geçirmek için, en az Temel erişime sahip olarak PR'nin içinde bulunduğ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 göz atın.

Değişiklikleri gözden geçirme

Pull request'ler, önerilen değişiklikler bir depodaki hedef dala uygulanmadan önce, belirlenen gözden geçirenlerin bu değişiklikleri incelemesine, tartışmasına ve oylaması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.

Aşağıdaki adımlarda, Azure Repos'taki PR'leri gözden geçirenlerin önerilen değişiklikleri anlamak için çekme isteğinde nasıl gezinebileceği açıklanmaktadır:

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 çekme isteği varsayılan olarak Genel Bakış sekmesine gider.

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 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. Dosyalar sekmesini seçerek PR'ın kaynak dalındaki tüm içerik değişikliklerini gözden geçirin. İ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ü kesilmiş dosya içeriğini gösterir. Tam içeriğin karşılaştırma görünümü için yerel bir karşılaştırma aracı kullanarak bu tür dosyaları indirip 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. Kaynak dala belirli gönderimler tarafından sunulan değişiklik kümesini gözden geçirmek için, değişiklikler açılan listesinden bir veya daha fazla değişiklik kümesi 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 gözden geçirmenizden bu yana PR'ye değişiklikler yapıldığında ve yalnızca yeni değişiklikleri görmek istediğinizde kullanışlıdır. Değişiklikler açılan listesi her değişiklik kümesini, her gönderme işleminde son taahhütteki işleme iletisine göre adlandırır.

   

   İpucu

   Shift tuşunu basılı tutarak değişiklikler açılır listesinden birden çok değişiklik kümesi seçin.

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 seti, o işlem sırasında gönderilen commit'leri gösterir. Zorla gönderilen bir değişiklik kümesi, değişiklik kümesi geçmişinin üzerine yazmaz ve diğer değişiklik kümeleri gibi, değişiklik kümesi listesinde görünür.

   

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

   

Dosyaları gözden geçirme

PR Dosyalar sekmesini seçerek, çekme isteğinin hedef dalının yanındaki kaynak dalında yapılan gerçek değişiklikleri görüntüleyin.

Not

Azure DevOps Pull isteği ile Azure DevOps Dal karşılaştırması arasındaki farklar, farklı karşılaştırma yöntemlerinden kaynaklanmaktadır.

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şlemeleri oluşturur. Dal Karşılaştırma: git diff branch..master C, D, E, F, G taahhütlerini oluşturur.

Daha fazla detay için üç nokta ve iki nokta: git diff karşılaştırmaları ve git diff konularına bakın.

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

Tüm güncelleştirmeler açılan listesinden kodun önceki sürümlerini gözden geçirin.

Daldaki her güncelleme, listeye yeni bir sürüm ekler ve çekme isteğinin Güncellemeler sekmesinde görünür. Farklı güncelleştirmeleri seçtiğinizde fark görünümü, çekme isteğinin her sürümündeki dosyalar arasındaki farkları gösterecek şekilde güncelleştirilir.

PR'den uzak kaldıktan sonra, son incelemenizden bu yana yapılan değişiklikleri adım adım inceleyerek PR güncellemelerini 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, çekme isteği yorumları ekleyerek ve bu yorumlara yanıt vererek birbirleriyle iletişim kurabilir. Çekme isteğini gözden geçirirken, önerilen değişikliklerle ilgili sorunları belirtmek, değişiklikler önermek ve önceki yorumlara yanıt vermek için yorumları kullanın. Kesin ve anlaşılması kolay yapıcı geri bildirimleri hedefleyin. Alıcıları @username kullanarak doğrudan adresleyin. #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 gelerek satır içi yorum kutusunu açmak için yorum düğmesini seçin. 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. Çekme isteğinin Dosyalar sekmesinde, açıklama eklemek istediğiniz satırın üzerine gelin ve satır içi açıklama kutusunu açmak için açıklama düğmesini seçin. 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 fark 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 Uygula'yı seçerek değişikliği işlemeye hazır olacak şekilde hazırlamak.

   

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 sahneden çıkarmak için Değişikliği geri al seçeneğini seçebilir.

   

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 içeren yorumlar, dolu 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ı onlarla doğrudan iletişime geçmek için @username kullanarak adresleyin. İş öğelerine #workitemID kullanarak ve diğer PR'lere !pullrequestID kullanarak başvurun.

   

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

   

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

Açıklama durumunu değiştirme

Yeni yorumlar başlangıçta Etkin durumda olur ve PR yazarları, bu durumu gözden geçirme sürecinde gözden geçirenlerin geri bildirim ve önerilerine nasıl yanıt verdiklerini belirtmek için günceller. Çekme talebi 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 şey 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 açıklama durumunu 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çtığınızdan bu yana yapılan yeni yorumları ve güncelleştirmeleri görmek için Yenilikler filtresi seçeneğini belirleyin. Her filtre seçeneği, kategori için öğe sayısını gösterir.

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. Depolar Dosyalar'ı 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. İşleme iletişim kutusunda, gerekirse işleme iletisini düzenleyin ve ardından İşle ve Gönder seçeneğini belirleyerek değişiklikleri PR'ınıza gönderin.

   

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 ya da klasörün yanındaki onay kutusunu seçerek gözden geçirilmiş dosyaları izleyebilir:

Pull request değişikliklerine oy verin

Tarayıcı

Pull isteğini gözden geçirenler, oy açılır listesinden bir oy seçeneği seçerek pull isteğinde oy kullanabilir. Çekme isteği sayfasındaki gözden geçiren simgesi, oylarını belirten bir göstergeyi gösterir.

Oylama seçenekleri şunlardır:

• Onayla: PR'de önerilen değişiklikleri onaylar. Bu seçenek sadece bir oydur ve çekme talebini onaylamaz.

• Önerilerle onaylanmış: PR'deki önerilen değişikliklere yönelik, isteğe bağlı iyileştirme önerileri ile onaylar. Bu seçenek sadece bir oylamadır ve PR'ı onaylamaz.

• Yazarı bekle: Gözden geçirenin açıklamalarını gözden geçirmesi için yazardan ister. Çekme isteği yazarı, yorumları ele aldıktan sonra gözden geçirenlere kodu yeniden incelemelerini bildirmelidir. Gerekli bir gözden geçiren bu oylama seçeneğini ayarlarsa, PR 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 PR onayını durdurur.

• Geri bildirim sıfırla: Oy verinizi temizler. Oy olmaması, bir PR'nin tamamlanmasını engellemez.

Azure DevOps CLI

Çekme isteğinin onaylanması için oylama yapmak amacıyla 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	Varsayılan bir kuruluş ayarlamak için Azure DevOps kuruluş URL'sini veya az devops configure -d organization=<organization URL> kullanın.
--subscription	Hayır	Bir Azure aboneliğinin adını veya kimliğini belirtin veya az account set -s <name or ID> kullanarak varsayılan bir abonelik ayarlayın.

Ö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ı bir PR çözümleme seçeneği belirleyebilir.

• Tamamlandı: Gerekli tüm gözden geçirenler onaylamışsa ve tüm gerekli dal ilkeleri karşılanırsa pr'yi şimdi tamamlayın.

• Otomatik tamamlama ayarla: Gereken tüm gözden geçirenler onayladığında ve tüm gerekli dal ilkeleri karşılandığında PR'yi otomatik tamamla.

• Taslak olarak işaretle: Çekme talebini henüz gözden geçirmeye hazır olmadığını göstermek için taslak durumuna ayarlayın. Taslak PR için Yayımla seçeneğini kullanarak taslak durumunu kaldırabilir ve gözden geçirme için hazır hale getirebilirsiniz.

• İptal: PR'yi kapatın. Terk edilmiş bir çekme isteğini geri yüklemek için Yeniden etkinleştir'i seçebilirsiniz.

Çekme isteğini tamamlama hakkında daha fazla bilgi için bkz Çekme isteğini tamamlama.

Sonraki adımlar

Çekme isteğini tamamlama

İlgili makaleler

• Çekme talebi güncelleme bildirimleri
• Çekme istekleri ve izinler hakkında