Çekme isteklerini tamamlama, bırakma veya geri döndürme

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

Visual Studio 2019 | Visual Studio 2022

Tüm gerekli gözden geçirenler çekme isteğinizi (PR) onayladıktan ve çekme isteği tüm dal ilkesi gereksinimlerini karşıladıktan sonra, değişikliklerinizi hedef dalla birleştirip çekme isteğini tamamlayabilirsiniz. Veya çekme isteğindeki değişikliklere devam etmemeye karar verirseniz, çekme isteğini bırakabilirsiniz.

Gözden geçirenlerin değişikliklerini ele almak, gözden geçirme açıklamalarını yanıtlamak ve çözümlemek için bkz . Açıklamaları adresle.

Önkoşullar

• Projenizde depolar etkinleştirilmelidir. Depolar hub'ı ve ilişkili sayfalar görüntülenmiyorsa, depoları yeniden etkinleştirmek için bkz. Azure DevOps hizmetini açma veya kapatma.

• Çekme isteğinizi tamamlamak için, çekme isteğinin içinde olduğu projede Katkıda Bulunanlar güvenlik grubunun üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.

• Çekme isteğine katkıda bulunmak için Okuyucular güvenlik grubunun üyesi olmanız veya ilgili izinlere sahip olmanız gerekir.

• PR'leri görüntülemek veya gözden geçirmek için Azure DevOps projesine Temel veya daha yüksek erişiminiz olmalıdır.

• Katkıda bulunmak istediğiniz projenin üyesi değilseniz, eklemeye başlayın.

  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 edinmek için bkz . Varsayılan Git deposu ve dal izinleri ve Erişim düzeyleri hakkında.

• Azure DevOps Services'te, uzantıyla azure-devops Azure komut satırı arabiriminden (CLI) PR'leri ve diğer kaynakları yönetebilirsiniz. Azure DevOps Services CLI ile çalışmayı öğrenmek için bkz . Azure DevOps CLI'yı kullanmaya başlama. PR'ler için Azure Repos CLI komutları az repos pr kullanır.

Birleştirme değişikliklerini denetleme

Çekme isteğini tamamladığınızda Git, ana dalın sonuna yeni bir birleştirme işlemesi ekler. Bu birleştirme işlemesi, ana dalın ve çekme isteği kaynak dalının önceki geçmişlerini bağlar. Önizleme birleştirme işlemesini görmek ve birleştirme çakışmalarını denetlemek için, çekme isteğine Genel Bakış sayfasının sağ üst kısmındaki Diğer seçenekler menüsünü ve ardından Birleştirme değişikliklerini görüntüle'yi seçin.

Çekme isteğini oluşturduktan sonra hedef dalı değiştirdiyseniz Birleştirmeyi yeniden başlat'ı seçerek yeni bir önizleme birleştirme işlemesi oluşturun ve birleştirme değişikliği fark görünümünü güncelleştirin.

Dal ilkelerini gözden geçirme

Ekipler, korumalı dallardaki PR'lerin birleştirilmeden önce belirli ölçütleri karşılamasını gerektiren dal ilkeleri ayarlayabilir. Çekme isteğiniz için geçerli olan dal ilkelerini, birleştirme için gerekli olup olmadığını ve çekme isteğinin geçirilip geçirilip geçmediğini görebilirsiniz.

Tarayıcı

Çekme İsteğine Genel Bakış sekmesi, çekme isteği için geçen veya başarısız olan dal ilkelerini özetler. Genel bakışta yalnızca başarısız ilkeler listelenir, ancak n denetimi görüntüle'yi <seçerek tüm ilke denetimlerini görebilirsiniz.>

Çekme İsteğine Genel Bakış sayfasında, dal ilkesi gereksinimlerinin bir simgesi vardır. Gereksinimin yanındaki Diğer seçenekler'i ve ardından İlkeyi görüntüle'yi seçerek Project Ayarlar'daki dalın Dal İlkeleri sayfasına gidin.

Visual Studio

Visual Studio'da bir çekme isteği açabilir ve ardından Tarayıcı sekmesinde açıklandığı gibi dal ilkelerini gözden geçirebilirsiniz.

Visual Studio'dan bir çekme isteği açmak için Git menüsünde <Git hizmeti>>Çekme İsteklerini Görüntüle'yi seçin ve açmak için bir çekme isteği seçin.

Visual Studio 2019 sürüm 16.8 ve sonraki sürümleri, Takım Gezgini Git kullanıcı arabirimini korurken bir Git sürüm denetimi deneyimi sağlar. Takım Gezgini'ni kullanmak için, menü çubuğundan Araçlar>Seçenekler>Önizleme Özellikleri>Yeni Git kullanıcı deneyimi'nin işaretini kaldırın. Git özelliklerini her iki arabirimden de birbirinin yerine kullanabilirsiniz.

Visual Studio Ekip Gezgini'nden PR'lere erişmek için:

1. Visual Studio'dan projenize Bağlan.

2. Ekip Gezgini'ne bak'ı>seçerek Ekip Gezgini'nin açılmasını sağlayın. Ayrıca Ctrl, Ctrl\++ M tuşlarına da basabilirsiniz.

3. Giriş'ten Çekme İstekleri'ni seçerek sizin tarafınızdan açılan veya size atanan PR'lerin listelerini görüntüleyin.

4. Web portalında bir çekme isteği açmak ve ilkeleri etkin olarak görüntülemek için pr'ye sağ tıklayın ve Tarayıcıda aç'ı seçin.

Azure DevOps CLI

Çekme isteği için geçerli olan tüm dal ilkelerini görmek için gerekli id parametreyle az repos pr policy list komutunu kullanın.

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Parametreler

Parametre	Açıklama
--id	Çekme isteğinin kimliği. Gerekli.
--detect	Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true.
--org --organization	Azure DevOps kuruluş URL'si. kullanarak varsayılan kuruluşu az devops configure -d organization=<ORG_URL>yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir . Örnek: https://dev.azure.com/MyOrganizationName/.
--query-examples	Önerilen JMESPath dizesi. Sonuçları görmek için sorgulardan birini kopyalayıp parametrenin --query arkasına çift tırnak içine yapıştırabilirsiniz. Önerilerin bu anahtar sözcüklere dayalı olması için bir veya daha fazla konumsal anahtar sözcük ekleyebilirsiniz.
--skip	Atlana ilke sayısı.
--subscription	Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s <NAME_OR_ID>yapılandırabilirsiniz.
--top	Liste alınacak en fazla ilke sayısı.

Örnek

Örneğin, pr #28'de geçerli olan ilkeleri görmek için aşağıdaki komutu çalıştırın:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

Çekme isteğini tamamlama

Birleştirme çakışmalarını çözümledikten ve çekme isteği tüm dal ilkelerini karşıladıktan ve tüm gerekli onaylara sahip olduktan sonra çekme isteğini tamamlayabilirsiniz.

Tarayıcı

1. Çekme isteğini tamamlamak için sağ üst köşeden Tamamla'yı seçin. İsterseniz, Tamamla düğmesinin yanındaki açılan oku seçin ve seçeneklerden birini belirleyin.

   

   • Tamamlandı: Çekme isteğini şimdi tamamlayın ve değişiklikleri hedef dalla birleştirin.
   • Otomatik tamamlama ayarla: Çekme isteğini tüm gerekli dal ilkelerini karşıladıktan sonra tamamlayacak ve birleştirecek şekilde yapılandırın.
   • Taslak olarak işaretle: Çekme isteğini taslak durumuna döndürerek tüm oyları kaldırın.
   • Bırakma: Çekme isteğini değişiklikleri birleştirmeden kapatın.

2. Çekme isteğini tamamla bölmesindeki Birleştirme türü altında birleştirme seçeneklerinden birini seçin.

   

   • Birleştirme (ileri sarma olmadan): Tüm işlemeleri koruyan doğrusal olmayan bir geçmişle birleştirin.
   • Squash işlemesi: Tüm kaynak işlemeleri hedefte tek bir işlemede birleştiren doğrusal bir geçmişle birleştirin veya squash çekme isteğini birleştirir . İşleme geçmişini kaynak daldan tutmadan hedef dal için yeni bir işleme oluşturulacağını unutmayın.
   • Yeniden temel ve ileri sarma: Kaynak işlemelerini hedefe ve ileriye doğru yeniden temelleyin.
   • Yarı doğrusal birleştirme: Kaynakta yeniden temel oluşturma hedefi işler ve iki üst birleştirme oluşturur.

   Not

   Mevcut ilkeler zorunlu kılındı. Örneğin, dalınızın şu anda "yalnızca squash birleştirme" ilkesi varsa, başka bir birleştirme türü kullanmak istiyorsanız bu ilkeyi değiştirmeniz gerekir.

3. Aşağıdaki tamamlama sonrası seçeneklerinden herhangi birini seçin. Bazı birleştirme türleri için bazı seçenekler kullanılamaz.

   • Birleştirmeden sonra ilişkili iş öğelerini tamamlama: Bağlı iş öğelerini tamamlayın.
   • Birleştirdikten sonra dal adını> silin<: Birleştirdikten sonra ÇEKME isteğinin kaynak dalını silin.
   • Birleştirme işleme iletisini özelleştirme: Özel birleştirme işleme iletisi ekleyin. Bu seçeneği seçerseniz birleştirme işleme iletisini güncelleştirin.
   • Dal ilkelerini geçersiz kılın ve birleştirmeyi etkinleştirin. Çekme isteği tüm dal ilkelerini karşılamasa bile birleştirmeyi zorlar. Bu seçenek yalnızca ilke zorlama izninden muaf tutma izniniz varsa kullanılabilir.

4. Birleştirmeyi tamamla'yı seçin.

Birleştirmeyi tamamladığınızda, bağlı iş öğeleri çekme isteğinin tamamlanmasını gösterecek şekilde otomatik olarak güncelleştirilir.

Visual Studio

Çekme isteğini tamamlamak için pr'yi tarayıcıda açın ve Genel Bakış sayfasında Tamamla'yı seçin veya diğer seçenekleri ayarlayın.

Visual Studio'dan bir çekme isteği açmak için Git menüsünde <Git hizmeti>>Çekme İsteklerini Görüntüle'yi seçin ve açmak için bir çekme isteği seçin.

Visual Studio 2019 Ekip Gezgini'nden PR'lere erişmek için:

1. Visual Studio'dan projenize Bağlan.

2. Ekip Gezgini'ne bak'ı>seçerek Ekip Gezgini'nin açılmasını sağlayın. Ayrıca Ctrl, Ctrl\++ M tuşlarına da basabilirsiniz.

3. Giriş'ten Çekme İstekleri'ni seçerek sizin tarafınızdan açılan veya size atanan PR'lerin listelerini görüntüleyin.

4. Web portalında bir çekme isteği açmak için çekme isteğine sağ tıklayın ve Tarayıcıda aç'ı seçin.

Azure DevOps CLI

Çekme isteğini tamamlamak ve değişiklikleri birleştirmek için az repos pr update komutunu kullanarak çekme isteğini --statuscompletedolarak güncelleştirin.

Örneğin, PR #21'i tamamlamak için şunu kullanın:

az repos pr update --id 21 --status completed

Tamamlama seçeneklerini ayarlama

ile az repos pr createçekme isteği oluştururken çekme isteği tamamlama seçeneklerini ayarlayabilir veya ile az repos pr updatemevcut PR'lerde oluşturma seçeneklerini güncelleştirebilirsiniz.

Çekme isteği tamamlama seçenekleri şunlardır:

• bypass-policy {false, true}: Gerekli ilkeleri atlayıp birleştirme işlemini tamamladıktan sonra çekme isteğinin tamamlanıp tamamlanmayacağı.
• bypass-policy-reason: Gerekli ilkeleri atlama nedeni.
• delete-source-branch {false, true}: Çekme isteği tamamlandıktan ve birleştirildikten sonra kaynak dalın silinip silinmeyeceği.
• merge-commit-message: Birleştirme işleme iletisini özelleştirin.
• squash {false, true}: Kaynak işlemelerin birleştirilmek üzere tek bir hedef işlemeye sıkıştırılıp sıkıştırılmayacağı.
• transition-work-items {false, true}: Çekme isteği birleştirildiğinde bağlantılı iş öğelerinin çözümlenip çözümlenmeyeceği.

Tamamlama seçeneklerini ayarlamak ve mevcut çekme isteğini tamamlamak için gerekli id parametreyi kullanınaz repos pr update.

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parametreler

Parametre	Açıklama
--id	Çekme isteğinin kimliği. Gerekli.
--auto-complete	Tüm ilkeler geçirildiğinde ve kaynak dal hedef dalda birleştirilebildiğinde çekme isteğini otomatik olarak tamamlanacak şekilde ayarlayın. Kabul edilen değerler: false, true.
--bypass-policy	Gerekli ilkeleri atlayın ve birleştirilebildiğinde çekme isteğini tamamlayın. Kabul edilen değerler: false, true.
--bypass-policy-reason	Gerekli ilkeleri atlamanın nedeni.
--delete-source-branch	Çekme isteği tamamlandıktan ve hedef dala birleştirildikten sonra kaynak dalı silin. Kabul edilen değerler: false, true.
--description -d	Çekme isteği için yeni açıklama. Markdown içerebilir. Her değer yeni bir satırdır. Örneğin: --description "First Line" "Second Line".
--detect	Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true.
--draft	Çekme isteğini taslak moduna dönüştürün veya yayımlayın. Kabul edilen değerler: false, true.
--merge-commit-message	İşlemeler birleştirildiğinde görüntülenecek ileti.
--org --organization	Azure DevOps kuruluş URL'si. kullanarak varsayılan kuruluşu az devops configure -d organization=<ORG_URL>yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir . Örnek: https://dev.azure.com/MyOrganizationName/.
--squash	Hedef dala birleştirirken kaynak daldaki işlemeleri sıkıştırın. Kabul edilen değerler: false, true.
--status	Çekme isteğinin yeni durumunu ayarlayın. Kabul edilen değerler: abandoned, active, completed.
--subscription	Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s <NAME_OR_ID>yapılandırabilirsiniz.
--title	Çekme isteği için yeni başlık.
--transition-work-items	Çekme isteğine bağlı tüm iş öğelerini bir sonraki mantıksal duruma (örneğin Çözüldü) geçirin. Kabul edilen değerler: false, true.

Örnek

Aşağıdaki örnek PR #21'i tamamlar, kaynak dalını siler, bağlı iş öğelerini çözümler ve birleştirme işleme iletisi ekler:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Çekme isteği tamamlama sırasında yeniden temel alma

Çekme isteği tamamlama sırasında yeniden başlatmanın mümkün olmadığı birkaç durum vardır:

• Hedef daldaki bir ilke yeniden temel stratejilerinin kullanılmasını yasaklarsa, yeniden temel almak için Dal ilkelerini geçersiz kılma iznine sahip olmanız gerekir.
• Çekme isteği kaynak dalı ilkelerine sahipse, yeniden temel alamazsınız. Yeniden dengeleme, ilke onay işlemine geçmeden kaynak dalı değiştirir.
• Birleştirme Çakışması Uzantısı'nı birleştirme çakışmalarını çözmek için kullandıysanız yeniden temel alamazsınız. Üç yönlü birleştirmeye uygulanan çakışma çözümleri, tüm çekme isteği işlemeleri ayrı ayrı yeniden oluşturulurken nadiren başarılı veya geçerli olur.

Tüm bu durumlarda dalınızı yerel olarak yeniden temel almaya ve ardından yukarı akışa göndermeye veya çekme isteğini tamamladığınızda değişikliklerinizi sıkıştırarak birleştirmeye devam edebilirsiniz.

Birden çok birleştirme temel sorunu

Bazı durumlarda çekme isteği birden fazla gerçek birleştirme tabanına sahiptir ve bu durum güvenlik sorunlarına neden olabilir. Çekme isteğindeki dosyaların birleştirme tabanları içinde farklı sürümleri varsa, birden çok birleştirme tabanı uyarısı gerçekleşir. Daha fazla bilgi ve düzeltme için bkz . Birden çok birleştirme temeli.

Birleştirme çakışmalarını çözümleme

Dalınızdaki dosya değişiklikleri başka bir daldaki değişikliklerle çakışabilir. Değişiklikleri birleştirme açık olmadığında Git, çekme isteğinin Genel Bakış sayfasında çakışan dosyaları gösterir. Çekme isteğini birleştirmeden veya çekme isteğini otomatik tamamlamaya ayarlamadan önce çekme isteği dalı ile hedef dal arasındaki birleştirme çakışmalarını çözmeniz gerekir. Birleştirme çakışmalarını çözme yönergeleri için bkz . Birleştirme çakışmalarını çözme.

Otomatik tamamlama için çekme isteği ayarlama

Tarayıcı

Koşullar tüm dal ilkelerini karşılar karşılamaz çekme isteği değişikliklerini tamamlamak ve birleştirmek için Tamamla açılan listesinden Otomatik tamamlama ayarla'yı seçin. Çekme isteği tamamlandığında bir e-posta bildirimi alırsınız. Bir çakışma veya hata çekme isteğinin tamamlanmasını engelliyorsa, e-posta sorunu size bildirir.

Not

Otomatik tamamlama ayarla seçeneği, dal ilkeleriniz olduğunda Azure Repos ve TFS 2017 ve üzeri sürümlerde kullanılabilir. Otomatik tamamlama ayarla seçeneğini görmüyorsanız dal ilkeleriniz yoktur. Daha fazla bilgi için bkz . Dal ilkeleri.

Varsayılan olarak, otomatik tamamlama olarak ayarlanmış bir çekme isteği yalnızca gerekli ilkelerde bekler. Otomatik tamamlamayı etkinleştir panelinde isteğe bağlı ilkeleri beklemeyi de seçebilirsiniz.

TFS 2018 Güncelleştirme 2'den başlayarak, Çekme İsteğine Genel Bakış sayfasında çekme isteğinin beklediği bekleyen ilke ölçütlerinin listesi görüntülenir. Otomatik tamamlamayı etkinleştir panelinde gerekli olacak şekilde bir ilke ayarladıysanız, Genel Bakış sayfasında ilkeyi isteğe bağlı olarak ayarlayabilirsiniz.

Otomatik tamamlama'yı kapatmak için Otomatik tamamlamayı iptal et'i seçin.

Otomatik tamamlamaya ayarlanmış bir çekme isteği, Çekme istekleri sayfasında otomatik tamamlama rozeti görüntüler.

Visual Studio

Web portalında bir çekme isteği açın. Genel Bakış sayfasında Otomatik tamamlama ayarla'yı seçin.

Visual Studio'dan bir çekme isteği açmak için Git menüsünde <Git hizmeti>>Çekme İsteklerini Görüntüle'yi seçin ve açmak için bir çekme isteği seçin.

Visual Studio 2019 Ekip Gezgini'nden PR'lere erişmek için:

1. Visual Studio'dan projenize Bağlan.

2. Ekip Gezgini'ne bak'ı>seçerek Ekip Gezgini'nin açılmasını sağlayın. Ayrıca Ctrl, Ctrl\++ M tuşlarına da basabilirsiniz.

3. Giriş'ten Çekme İstekleri'ni seçerek sizin tarafınızdan açılan veya size atanan PR'lerin listelerini görüntüleyin.

4. Web portalında bir çekme isteği açmak ve ilkeleri etkin olarak görüntülemek için pr'ye sağ tıklayın ve Tarayıcıda aç'ı seçin.

Azure DevOps CLI

Tüm gerekli onayları ve dal ilkelerini geçtiğinde çekme isteğini otomatik olarak tamamlamak için otomatik tamamlama'yı ayarlayın. Çekme isteği oluşturma sırasında otomatik tamamlama ayarlayabilir veya mevcut bir çekme isteğini güncelleştirebilirsiniz.

• Çekme isteği oluşturma sırasında otomatik tamamlamayı ayarlamak için kullanın az repos pr create --auto-complete true.
• Mevcut çekme isteğini otomatik tamamlamaya güncelleştirmek için kullanın az repos pr update --id <PR Id> --auto-complete true.

Çekme isteğini bırakma veya yeniden etkinleştirme

Tarayıcı

Değişikliklerinizi ve çekme isteğinizi birleştirmeden bırakmak için, Tamamla düğmesindeki açılan listeden Bırak'ı seçin. Terk edilen çekme isteğini görüntülemeye devam edebilirsiniz ve iş öğeleriyle bağlantılı kalır.

Bırakılan çekme isteğini istediğiniz zaman yeniden etkinleştirmek için Çekme İsteği görünümündeki Bırakılan sekmesinden çekme isteğini açın ve sağ üstteki Yeniden etkinleştir'i seçin.

Visual Studio

Web portalında bir çekme isteği açın. Genel Bakış sayfasında, Bırak'ı seçin.

Çekme isteğini web portalında açmak için Çekme isteğini tamamlama yordamını kullanın.

Azure DevOps CLI

Değişiklikleri birleştirmeden çekme isteğini bırakmak için kullanın az repos pr update --id <PR Id> –-status abandoned. Pr'yi durumunu activeolarak ayarlayarak yeniden etkinleştirebilirsiniz.

Tamamlanmış çekme isteğini geri döndürme

Çekme isteğindeki değişiklikleri geri almak için şu adımları izleyin. Daha fazla bilgi için bkz . Değişiklikleri geri alma.

1. Tamamlanan çekme isteğini açın ve Geri Al'ı seçin. Bu eylem, deponuzdaki mevcut bir hedef dalda çekme isteğini geri alan değişiklikler içeren yeni bir dal oluşturur.

2. Çekme isteğini geri döndür bölmesinde:

   1. Hedef dal'ın altında çekme isteği değişikliklerini geri almak istediğiniz dalı seçin.
   2. Konu dal adı gerekli altında, isterseniz çekme isteği dalını geri döndür adını değiştirin.
   3. Geri Al'ı seçin.

3. Yeni çekme isteği ekranında Oluştur'u seçin.

4. Geri döndürme işlemini tamamlamak için yeni çekme isteğini birleştirin.

Not

Bu geri döndürme sırasında oluşturulan dal, özgün çekme isteğinden tüm dosya değişikliklerini geri döndüren tek bir işlemeye sahiptir. Dal, özgün çekme isteğindeki işlemelerin her biri için geri döndürülen bir işleme içermez.

Sonraki adımlar

Değişiklikleri vişne seçimiyle kopyalama

İlgili makaleler

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