Çekme istekleri oluşturma

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Git deposundakikodu değiştirmek, gözden geçirmek ve birleştirmek için çekme istekleri oluşturma (PR 'ler). Yukarı akış deposundaki veya deponun çatalınızdaki dallardaki dallardan PR 'ler oluşturabilirsiniz. Takımınız PR 'ler gözden geçirebilir ve değişiklikler hakkında geri bildirimde bulunabilir. Gözden geçirenler önerilen değişikliklere göre ileredebilir, açıklamalar bırakabilir ve PR 'ler ' yi onaylamak veya reddetmek için oy verebilir. Şube ilkelerine ve diğer gereksinimlere bağlı olarak, çekme isteğini tamamlamadan ve değişiklikleri hedef Dalla birleştirebilmeniz için, çekme isteğinin çeşitli ölçütlere uyması gerekebilir.

PR yönergeleri ve yönetimi konuları için bkz. çekme Istekleri hakkında.

Önkoşullar

  • Repos projenizdeki etkin olmalıdır. Repos hub ve ilişkili sayfalar görünmüyorsa, bkz. Repos yeniden etkinleştirmek için Azure DevOps hizmeti açma veya kapatma .

  • pr 'ler görüntülemek veya gözden geçirmek için, temel erişim veya daha yüksek bir Azure DevOps projesinin üyesi olmanız gerekir.

  • Bir PR 'ye katkıda bulunmak için, Okuyucular güvenlik grubunun bir üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.

  • Bir çekme isteği oluşturup tamamlayabilmeniz için, katkıda bulunanlar güvenlik grubunun bir üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.

    Not

    Ortak projeler için, paydaş Access verilen kullanıcıların Azure Repos için tam erişimi vardır.

  • Repos projenizdeki etkin olmalıdır. Repos hub ve ilişkili sayfalar görünmüyorsa, bkz. Repos yeniden etkinleştirmek için Azure DevOps hizmeti açma veya kapatma .
  • pr 'ler görüntülemek veya gözden geçirmek için, temel erişim veya daha yüksek olan Azure DevOps projenin bir üyesi olmanız gerekir. Proje üyesi değilseniz, eklendi.
  • Bir çekme isteği oluşturup tamamlayabilmeniz için, katkıda bulunanlar güvenlik grubunun bir üyesi olmanız veya değiştirmek istediğiniz projede ilgili izinlere sahip olmanız gerekir.
  • Bir PR 'ye katkıda bulunmak için, Okuyucular güvenlik grubunun bir üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.
  • Bir çekme isteği oluşturup tamamlayabilmeniz için, katkıda bulunanlar güvenlik grubunun bir üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.
  • pr 'ler görüntülemek veya gözden geçirmek için, temel erişim veya daha yüksek bir Azure DevOps projesinin üyesi olmanız gerekir. Proje üyesi değilseniz, eklendi.
  • Bir PR 'ye katkıda bulunmak için, Okuyucular güvenlik grubunun bir üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.

Çekme isteği oluşturma

Azure DevOps project web sitesinden, Visual Studio veya Azure DevOps clı 'dan yeni bir çekme isteği oluşturabilirsiniz.

Azure DevOps project web sitesinden, şuradan yeni bir çekme isteği oluşturabilirsiniz:

Çekme istekleri sayfasından bir PR oluşturma

Web üzerinde projenizin çekme istekleri sayfasından herhangi bir dal için PR 'ler oluşturabilirsiniz.

  1. çekme istekleri Repos sayfasında, sağ üst köşedeki yeni çekme isteği ' ni seçin.

    Yeni çekme isteği düğmesinin ekran görüntüsü.

  2. Değişiklikleri birleştirmek istediğiniz değişiklikleri ve dalı içeren dalı, ana dal gibi seçin.

    Azure Repos bir P R için kaynak ve hedef dalların ekran görüntüsü.

  3. PR ayrıntılarınızı gırıp PR 'yi oluşturun.

Gönderilen daldan bir PR oluşturma

bir özellik dalını gönderdikten veya güncelleştirdikten sonra Azure Repos, çekme isteği oluşturmak için bir istem görüntüler.

  • Çekme istekleri sayfasında:

    Azure Repos 'daki çekme Istekleri sekmesinde bir P R oluşturma istemi gösteren ekran görüntüsü.

  • Dosyalar sayfasında:

    Azure Repos Dosya sekmesinde bir P R oluşturma istemi gösteren ekran görüntüsü.

Çekme Isteği oluştur ' u seçerek PR ayrıntılarınızı girebileceğiniz bır sayfaya gidin ve PR 'yi oluşturun.

bir özellik dalını gönderdikten veya güncelleştirdikten sonra, Azure Repos web üzerinde kod görünümünde bir PR oluşturmanız istenir. Bu istem, çekme isteklerinde ve dosyalarındagörüntülenir.

Azure Repos 'daki çekme Istekleri sekmesinde bir P R oluşturma istemi gösteren ekran görüntüsü.

Azure Repos Dosya sekmesinde bir P R oluşturma istemi gösteren ekran görüntüsü.

Çekme Isteği oluştur ' u seçerek PR ayrıntılarınızı girebileceğiniz bır sayfaya gidin ve PR 'yi oluşturun.

Bağlantılı iş öğesinden bir PR oluşturma

dala bağlı Azure Boards iş öğesinden doğrudan bir çekme isteği oluşturabilirsiniz.

  1. Azure Boards, görünümündeki biriktirme listeleri veya sorgulardan , dala bağlı bir iş öğesi açın.

  2. İş öğesinin geliştirme alanında çekme isteği oluştur' u seçin.

    Bağlantılı dala sahip bir iş öğesinin geliştirme alanından bir çekme isteği oluşturma ekranının ekran görüntüsü.

Bağlantı, sizi çekme isteği ayrıntılarınızı girebileceğiniz ve çekme isteği oluşturabileceğiniz bir sayfaya götürür.

Tek tek seçme ile güncelleştirmeler ekleme

Tek tek seçme kullanarak commit'leri bir daldan diğerine kopyalayıp kopyalay ıstırma. Birleştirme veya yenidenbase'den farklı olarak tek tek seçme, bir dalda yapılan tüm değişiklikler yerine yalnızca sizin seçerek yaptığınız değişiklikleri getirir.

Tamamlanmış bir ÇEKME'den değişiklikleri tek tek seçmek için ÇEKME'nin Genel Bakış sayfasında Tek tek seçim'i seçin. Etkin bir pr'den değişiklikleri kopyalamak için ÇEKME'nin Diğer seçenekler menüsünden Tek seçim'i seçin. Bu eylem, kopyalanan değişikliklerle yeni bir dal oluşturur. Daha sonra yeni daldan yeni bir PR oluşturabilirsiniz. Ayrıntılı yönergeler için bkz. Tek tek seçme ile değişiklikleri kopyalama.

Çekme isteğinizin kaynak ve hedef dallarını değiştirme

Bir PR'yi ilk kez kaydetmeden önce dal adlarının yanındaki Kaynak ve hedef dalları değiştir simgesini seçerek PR'nin kaynak ve hedef dallarını değiştirebilirsiniz. Pr etkin olduktan sonra bu simge gider, ancak yine de PR'nin hedef dallarını değiştirebilirsiniz.

Kaynak ve hedef dalları değiştir simgesinin ekran görüntüsü.

Çekme isteği şablonlarını kullanma

Çekme isteği şablonu, çekme isteği güncelleştirmeyi güncelleştirmeyi içeren Markdown metni içeren bir dosyadır. İyi PR açıklamaları, PR gözden geçirenlerine neler beklenebilir ve birim testleri ekleme ve belgeleri güncelleştirme gibi görevlerin izlenmesine yardımcı olabilir. Takımınız, repoda tüm yeni PR açıklamalarına metin ekleyen bir varsayılan PR şablonu oluşturabilir. Ayrıca, dallara özgü şablonlar veya takımınız tarafından tanımladığı diğer şablonlar da kullanılabilir. Çekme isteği şablonları oluşturma ve kullanma hakkında daha fazla bilgi için bkz. Şablonları kullanarak çekme isteği açıklamalarını geliştirme.

Repo' nun varsayılan bir şablonu varsa, repo'daki tüm DISK'ler oluşturma sırasında varsayılan şablonun açıklama metnine sahip olur. Diğer şablonları eklemek için Şablon ekle'yi seçin ve ardından açılan listeden bir şablon seçin. Şablon metnini açıklamanıza ekleyebilir, kaldırabilir veya başka bir metin eklemek için kullanabilirsiniz.

P R oluştururken şablon ekle'yi gösteren ekran görüntüsü.

TaslakRS oluşturma

PR'niz gözden geçirme için hazır değilse, devam eden işi belirtmek için bir taslak PR oluşturabilirsiniz. PR gözden geçirme için hazır olduğunda yayımlayın ve tüm gözden geçirme sürecini başlatarak veya devam ettirin.

Taslak DISK'ler, yayımlanan DISK'lerden aşağıdaki farklara sahip:

  • Derleme doğrulama ilkeleri otomatik olarak çalıştırılır. Pr'de diğer seçenekler menüsünü seçerek derleme doğrulamalarını el ile kuyruğa ekleyebilirsiniz.

  • Taslak modundayken oylama devre dışı bırakılır.

  • Gerekli gözden geçirenler otomatik olarak eklenmez. Bildirimler yalnızca taslak PR'ye açıkça ekleyen gözden geçirenlere gönderilir.

  • Taslak PR'ler, Taslak rozetiyle pr listesinde görüntülenir.

    P R listesinde taslak P R'yi gösteren ekran görüntüsü.

Not

Taslak DISK'ler oluşturmak Azure DevOps Server 2019.1 veya sonraki bir sürümü gerektirir.

Taslak pr oluşturmak için Oluştur'un yanındaki oku seçin ve pr'yi oluştururken Taslak olarak oluştur'a tıklayın. WIP veya MERGE YAPMA gibi başlık ön eklerini kullanmak zorunda değildir.

Taslak P R olarak oluştur'ları gösteren ekran görüntüsü.

Pr'yi gözden geçirerek tamamlamış olmaya hazır olduğunda, PR'nin sağ üst kısmında Yayımla'yı seçin. Pr yayımlama, gerekli gözden geçirenleri atar, ilkeleri değerlendirir ve oylamayı atar.

P R için yayımla'yı gösteren ekran görüntüsü.

Mevcut yayımlanmış bir PR'yi taslak olarak değiştirmek için Taslak olarak işaretle'yi seçin. Bir PR'nin taslak olarak işaretlenmesi mevcut tüm oyları kaldırır.

Taslak olarak işaretle'nin ekran görüntüsü.

Çekme isteği başlığı ve açıklaması ekleme veya düzenleme

Yeni çekme isteği sayfasında bir Başlık ve değişikliklerinizin ayrıntılı Açıklaması girin, böylece diğer kişi değişikliklerin çöztt olduğu sorunları görebilir. Mevcut PR'lerde olduğu gibi yeni bir PR'de, dosyalar ve commit'leri pr'nizin ayrı sekmelerinde görebilir. Gözden geçirenler ekleyebilir, iş öğelerini bağ ekleyebilir ve PR'ye etiketler ebilirsiniz.

Değişikliklerinizi gözden geçirmeye hazır olduğunda Oluştur'a seçerek PR'yi oluşturun.

Yeni bir P R oluşturmayı gösteren ekran görüntüsü.

Yeni bir P R'ye ayrıntılar ekleme.

PR'nizi oluşturmada tüm iş öğeleri, gözden geçirenler veya ayrıntılar hazır değilse endişelenmeyin. Pr'yi oluşturduk sonra bu öğeleri ekleyebilir veya güncelleştirebilirsiniz.

Pr başlığını ve açıklamasını düzenleme

Gözden geçirenlerin çekme isteği içindeki değişiklikleri anlayabilmesi için çekme isteği başlığını ve açıklamasını güncel tutun.

Mevcut bir PR 'nin başlığını, geçerli başlığı seçerek ve metni güncelleştirerek güncelleştirebilirsiniz. Değişiklikleri kaydetmek için Kaydet simgesini seçin veya değişiklikleri atmak Için geri al simgesini seçin.

Açıklama bölümündeki Düzenle simgesini seçerek PR açıklamasını düzenleyin.

P R başlığını düzenlemeyi ve açıklama Düzenle düğmesini seçmeyi gösteren ekran görüntüsü.

Çekme isteğine gözden geçirenler ekleme

Gözden geçirenleri yeni veya mevcut bir PR 'nin Gözden geçirenler bölümüne ekleyebilirsiniz. Ayrıca, isteğe bağlı gözden geçirenleri gerekli hale getirebilirsiniz veya gerekli gözden geçirenleri, ilke tarafından gerektirmedikleri takdirde, isteğe bağlı olarak değiştirebilir veya kaldırabilirsiniz.

Dal ilkeleri en az sayıda gözden geçiren gerektirebilirveya PR 'ler içinde belirli isteğe bağlı veya gerekli gözden geçirenleri otomatik olarak dahil edebilir. Dal ilkesi için gerekli gözden geçirenleri kaldıramazsınız. Dal ilkesi için isteğe bağlı gözden geçirenleri gerekli olacak şekilde değiştirebilir veya kaldırabilirsiniz.

Otomatik olarak bir gözden geçiren ekleyen dal ilkesini görmek için, PR 'ye genel bakış sayfasının Gözden geçirenler bölümüne, gözden geçirenin yanındaki diğer seçenekler ' e sağ tıklayın.

Bir gözden geçiren üzerinde, dal ilkesine otomatik olarak dahil edilen görünüm ilkesini gösteren ekran görüntüsü.

Çekme isteğini incelemek istediğiniz kullanıcı veya grup projenizin bir üyesi değilse, bunları gözden geçirenler olarak ekleyebilmeniz için bunları projeye eklemeniz gerekir.

Yeni bir PR 'ye gözden geçirenler eklemek için:

  1. Yeni çekme isteği sayfasında, Gözden geçirenler' in altında, Gözden geçirenler olarak eklemek için kullanıcıları ve grupları ara' yı seçin.
  2. Bir ad veya e-posta adresi girerken, açılan liste, eşleşen kullanıcı ve grupların listesini gösterir. İsteğe bağlı gözden geçirenler olarak eklemek için listeden adlar ' ı seçin.
  3. Gerekli gözden geçirenleri eklemek için gerekli gözden geçirenleri Ekle' yi seçin ve ardından aramak için gerekli gözden geçirenleri eklemek üzere ara ' yı seçin.

Yeni bir P R 'ye gözden geçiren ekleme ekran görüntüsü.

Mevcut bir PR 'ye gözden geçirenler eklemek için:

  1. Genel bakış sayfasının Gözden geçirenler bölümünde Ekle' yi seçin ve gerekli gözden geçiren ' i veya isteğe bağlı gözden geçiren' i seçin.

    Çekme isteğine genel bakış

  2. Bir ad veya e-posta adresi girerken, eşleşen kullanıcıların veya grupların bir listesi görüntülenir. Gözden geçirenler olarak eklenecek adları seçin.

    P R gözden geçiren ekle.

Gerekli ve isteğe bağlı bir gözden geçireni değiştirmek veya gözden geçireni kaldırmak için, gözden geçiren adının sağında daha fazla seçenek seçin. Gözden geçiren olarak belirlenmiş bir grubun veya ekibin üyeliğini görmek için grubun simgesini seçin.

PR 'nize gözden geçirenler eklemek için:

  1. PR 'deki genel bakış sekmesini seçin.

    PR genel bakış

  2. Gözden geçirenler alanındaki Ekle düğmesini seçin.

  3. PR için gözden geçiren listesine eklenecek kullanıcının veya grubun adını girin. Kullanıcı projenizin bir üyesi değilse, bunları eklemenizgerekir.

  4. Bir ad veya e-posta adresi girerken, eşleşen kullanıcıların veya grupların bir listesi görüntülenir. Gözden geçiren olarak eklemek için listeden Kullanıcı veya grup seçin.

    PR gözden geçiren ekle

İş öğelerini yeni bir PR 'ye bağlamak için:

  1. Yeni çekme isteği sayfasında, bağlanacak Iş öğelerialtında kimliğe veya başlığa göre iş öğelerini ara' yı seçin.
  2. Bir iş öğesi KIMLIĞI veya başlığı girmeyi başlatın ve görüntülenen açılan listeden bağlanacak iş öğesini seçin.

İş öğelerini mevcut bir PR 'ye bağlamak için:

  1. PR genel bakış sekmesinde, iş öğeleri alanında, öğesini seçin .

    Genel Bakış sekmesinin ve iş öğeleri bölümünün seçilip seçildiğinin gösterildiği ekran görüntüsü.

  2. İş öğesinin KIMLIĞINI veya iş öğesi başlığı için arama ' yı girin. Görüntülenen listeden iş öğesini seçin.

İş öğesinin yanındaki x simgesini seçerek bir iş öğesi bağlantısını kaldırın. Bir bağlantıyı kaldırmak yalnızca iş öğesiyle PR arasındaki bağlantıyı kaldırır. Dalda veya yürütmelerde oluşturulan bağlantılar iş öğesinde kalır.

İş öğelerini PR 'nize bağlamak için:

  1. PR 'deki genel bakış sekmesini seçin.

    Genel Bakış sekmesinin ve öğeleri bağla düğmesinin seçilip seçildiğinin gösterildiği ekran görüntüsü.

  2. Iş öğeleri alanında Ekle düğmesini seçin. PR 'ler içinde simge Ekle

  3. Çalışma öğesinin KIMLIĞINI girin veya metninize uyan başlıklar içeren iş öğelerini arayın. Görüntülenen listeden iş öğesini seçin.

İş öğesinin üzerine geldiğinizde görüntülenen Kaldır düğmesini seçerek iş öğesi bağlantılarını kaldırın. Kaldır düğmesi Bir bağlantıyı kaldırmak yalnızca bir iş öğesi ile bir çekme isteği arasındaki bağlantıyı kaldırır. Dalda veya yürütmelerde oluşturulan bağlantılar iş öğesinde kalır.

İş öğelerini PR 'nize bağlamak için:

  1. PR 'de Genel Bakış ' ı seçin.

    PR 'de Genel Bakış ' ı seçin.

  2. Iş öğeleri alanında Ekle düğmesini seçin.

  3. Çalışma öğesinin KIMLIĞINI girin veya metninize uyan başlıklar içeren iş öğelerini arayın. Görüntülenen listeden iş öğesini seçin.

İş öğesinin üzerine geldiğinizde görüntülenen Kaldır düğmesini seçerek iş öğesi bağlantılarını kaldırın. simgeyi kaldır Bir bağlantıyı kaldırmak yalnızca iş öğesiyle PR arasındaki bağlantıyı kaldırır. Dalda veya yürütmelerde oluşturulan bağlantılar iş öğesinde kalır.

Çekme isteğine etiketler ekleme

Önemli ayrıntıları göstermek ve PR 'ler düzenlemeye yardımcı olmak için etiketleri kullanın. Etiketler, çekme isteği hala sürmekte olan bir iş veya yaklaşan bir sürüme yönelik bir düzeltme olduğu gibi, gözden geçirenlere daha fazla bilgi gönderebilir.

Etiketli P RS gösteren ekran görüntüsü.

Çekme isteği oluştururken bir etiket eklemek için Etiketler bölümüne bir etiket adı yazın. PR 'yi oluşturduktan sonra Etiketler bölümünde etiketleri yönetebilirsiniz.

P R etiketleri bölümünün vurgulandığını gösteren ekran görüntüsü.

Çekme isteğine etiketler ekleme

Bir çekme isteği hakkındaki ek bilgileri, etiketleri kullanarak gözden geçirenlere gönderebilirsiniz. Çekme isteği hala sürmekte olan bir çalışmadır veya yaklaşan bir sürüme yönelik bir düzeltmedir. Önemli ayrıntıları iletmek ve PR 'ler organize etmenize yardımcı olmak için etiketleri kullanın.

Not

PR etiketlerinin kullanılması TFS 2018,2 veya sonraki bir sürümü gerektirir.

Etiketli P RS gösteren ekran görüntüsü.

Bir PR oluştururken etiket eklemek için etiket ekle' yi seçin. Bir PR oluşturduktan sonra etiketleri Etiketler bölümünde yönetebilirsiniz.

P R etiketi ekle

Çekme isteklerine ekler ekleme

Oluşturma sırasında veya sonrasında çekme isteğinize görüntü dahil olmak üzere dosyalar ekleyebilirsiniz. Açıklama alanının altında bulunan ataş simgesini seçin veya dosyaları doğrudan PR 'nin Açıklama alanına sürükleyip bırakın.

Oluşturma sırasında P R açıklamasına dosya eklemeyi gösteren ekran görüntüsü.

Etkin bir çekme isteğinin hedef dalını değiştirme

Çoğu takım için, neredeyse All PR 'ler, veya gibi varsayılan bir dalı hedefler maindevelop . Bazen farklı bir dalı hedeflemek gerekirse, çekme isteğini oluştururken hedef dalı değiştirmeyi unutmak kolaydır. Bu durumda, etkin bir PR 'nin hedef dalını değiştirebilirsiniz:

  1. PR genel bakış sayfasında sağ üst köşede daha fazla eylem seçin ve ardından açılan menüden hedef dalı Değiştir ' i seçin.
  2. Hedef dalı Değiştir bölmesinde, hedef dal Seç' i seçin, yeni dalı seçin ve ardından Değiştir' i seçin.

Paydaşlara e-posta çekme isteği bildirimleri

Gözden geçirenlere bildirmek ve ekip üyeleriyle iletişim kurmak için bir çekme isteğini e-postayla paylaşabilirsiniz. Bir PR 'yi paylaşmak için:

  1. PR genel bakış sayfasında daha fazla seçenek ' i seçin ve ardından çekme isteğini paylaşma' yı seçin.

    Bir P R 'nin Genel Bakış sayfasında çekme isteği paylaşma seçeneğini seçen ekran görüntüsü.

  2. Çekme Isteğini paylaşma ekranında, Kimden : alanına adlarını yazarak ve görüntülenen kullanıcı adlarından seçerek alıcıları ekleyin. Alıcıları da kaldırabilirsiniz.

  3. Note (Isteğe bağlı) alanına isteğe bağlı bir ileti ekleyin ve ardından Gönder' i seçin. Alıcılar, ilgilenmesini ve çekme isteğini bağlamayı isteyen bir e-posta alır.

Not

Yerleşik e-posta özelliğini kullanıyorsanız, e-postayı yalnızca proje üyelerinin ayrı adreslerine gönderebilirsiniz. Bir ekip grubunu veya güvenlik grubunu to: satırına ekleme desteklenmiyor. Sistemin tanımadığı bir e-posta hesabı eklerseniz, e-postalarınızın bir veya daha fazla alıcının, gönderilen çekme isteğini okuma izni olmadığını belirten bir ileti alırsınız.

e-posta özelliğinin çalışması için, Azure DevOps Server yöneticinizin bir SMTP sunucusu yapılandırmasıgerekir.

Sonraki adımlar