Çekme istekleri oluşturma

Bir özellik dalına (feature branch) gönderme veya güncelleştirme yaptıktan sonra Azure Repos, PR (çekme isteği) oluşturmak için bir istem görüntüler.

• Çekme talepleri sayfasında:

  

• Dosyalar sayfasında:

  

Çekme isteği oluştur seçeneğine tıklayın ve çekme isteği ayrıntılarınızı girerek PR oluşturun.

Projenizde yeni bir PR oluşturmak için az repos pr createkullanın. Oluşturduktan sonra tarayıcınızda PR'yi açmak için --open parametresini kullanın.

az repos pr create [--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]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--subscription]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Parametre

Örnek

Aşağıdaki komut, Fabrikam deposundaki new dalından varsayılan main dalına bir çekme isteği oluşturur, çekme isteğini tarayıcıda açar ve komut çıktısını bir tabloda gösterir. Örnek varsayılan yapılandırmayı kullanır: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos pr create --repository Fabrikam --source-branch new --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
30    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

Çekme isteği oluşturma sırasında veya sonrasında başka birçok çekme isteği ayrıntısı ekleyebilirsiniz. Çekme isteğine ayrıntıları, gözden geçirenleri, iş öğelerini ve tamamlama seçeneklerini eklemek için bkz. Ayrıntıları ekleme veya çekme isteklerini düzenleme.

Azure DevOps CLI komutları Azure DevOps Server için desteklenmez.

Taslak çekme isteği oluşturmak için, Oluştur yanındaki oku seçin ve Çekme İsteği'ni oluştururken Taslak olarak oluştur seçeneğini tercih edin. WIP veya DO NOT MERGE gibi başlık ön eklerini kullanmanız gerekmez.

PR'in incelenip tamamlanmasına hazır olduğunuzda PR'de sağ üst köşedeki Yayımla'yı seçin. Çekme isteği yayımlamak, gerekli gözden geçirenleri görevlendirir, politikaları değerlendirir ve oylamayı başlatır.

Var olan yayımlanmış çekme isteğini taslak olarak değiştirmek için Taslak olarak işaretleseçin. Bir pull request'i taslak olarak işaretlemek, tüm mevcut oyları kaldırır.

PR'yi taslak olarak oluşturmak için PR oluştururken --draft parametresini true olarak ayarlayın. (Azure DevOps Server 2020 veya sonraki bir sürümü gerektirir.)

Mesela:

az repos pr create --repository Fabrikam --source-branch new --draft true

Mevcut çekme talebini taslak olarak ayarlamak için az repos pr update --id <PR Id> --draft true'u kullanın.

PR'nin taslak durumunu kaldırmak için --draft'ı falseolarak değiştirin.

Azure DevOps CLI komutları Azure DevOps Server için desteklenmez.

oluşturmayı gösteren ekran görüntüsü

Ayrıntıları yeni bir P R'ye ekleme

az repos pr createile PR oluşturma sırasında ayrıntıları ekleyebilir veya az repos pr updateile mevcut PR'lerde ayrıntıları güncelleyebilirsiniz.

az repos pr createile çekme isteği oluşturduğunuzda, başkalarının değişikliklerin hangi sorunları çözdüğüne bakabilmesi için bir --title ve değişikliklerinizin ayrıntılı bir --description ekleyin. --description parametresi Markdown formatında giriş kabul eder ve bağımsız değişkendeki her değer, PR tanımına bir yeni satırdır.

Mesela:

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

Gözden geçirenlerin pull isteğindeki değişiklikleri anlayabilmesi için bu alanları güncel tutun. Çekme isteğinin ayrıntılarını güncelleştirmek için gerekli çekme isteği --id parametresiyle az repos pr update kullanın.

Örneğin, PR #21'in başlığını ve açıklamasını güncelleştirmek için şunu kullanın:

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Azure DevOps CLI komutları Azure DevOps Server için desteklenmez.

Yeni veya var olan bir çekme isteği için Gözden Geçirenler bölümüne gözden geçirenler ekleyebilirsiniz. Ayrıca, mevcut isteğe bağlı gözden geçirenleri zorunlu hale getirebilir veya zorunlu gözden geçirenleri, ilke tarafından gerekli olmadıkça isteğe bağlı hâle getirebilir veya kaldırabilirsiniz.

Dal ilkeleri en az sayıda gözden geçiren gerektirebilir ya da belirli isteğe bağlı veya gerekli gözden geçirenleri otomatik olarak PR'lere ekleyebilir. Dal ilkesinin gerektirdiği gözden geçirenleri kaldıramazsınız. Şube politikası kapsamında isteğe bağlı olan gözden geçirenleri gerekli hale getirebilir veya bunları kaldırabilirsiniz.

Otomatik olarak bir gözden geçiren ekleyen dal ilkesini görmek için, PR Genel Bakış sayfasındaki Gözden Geçirenler bölümünde gözden geçirenin yanındaki Daha fazla seçenek üzerine sağ tıklayın.

PR'inizi incelemek istediğiniz kullanıcı veya grup projenizin bir üyesi değilse, onları inceleme yapacak kişi olarak ekleyebilmeniz için önce projeye eklemeniz gerekir.

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

1. Yeni çekme isteği sayfasında, Gözden Geçirenleraltında, gözden geçiren olarak eklemek için Kullanıcı ve grupları ara 'yı seçin.
2. Bir ad veya e-posta adresi girdiğinizde, açılan listede eşleşen kullanıcıların ve grupların listesi gösterilir. İ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çirenleriekle'yi seçin ve ardından adları arayıp seçmek için Ara'yı seçin.

Mevcut pr'ye gözden geçirenleri eklemek için:

1. Gözden Geçirenler bölümünde, Genel Bakış sayfasında Ekle'yi seçin ve ardından Gerekli gözden geçiren veya İsteğe bağlı gözden geçirenöğesini seçin.

   

2. Bir ad veya e-posta adresi girdiğinizde eşleşen kullanıcıların veya grupların listesi görüntülenir. Gözden geçiren olarak eklenecek isimleri seçin.

   

Gözden geçireni gerekli ve isteğe bağlı olarak değiştirmek veya gözden geçireni kaldırmak için gözden geçiren adının sağındaki Diğer seçenekler seçin. Gözden geçiren olarak belirlenen bir grubun veya ekibin üyeliğini görmek için grubun simgesini seçin.

Bir PR oluştururken isteğe bağlı gözden geçirenler ekleyebilirsiniz.
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

Mesela:

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

Gerekli gözden geçirenleri eklemek veya gözden geçirenleri isteğe bağlı ve gerekli arasında değiştirmek için pr'yi tarayıcıda açın ve güncelleştirin.

Mevcut çekme isteğini gözden geçirenleri yönetmek için az repos pr reviewerkullanın.

• Mevcut PR'ye gözden geçirenleri eklemek için
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• Çekme isteğini gözden geçirenleri listelemek amacıyla az repos pr reviewer list --id <PR Id>kullanın.
• Gözden geçirenleri çekme isteğinden kaldırmak için az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>"kullanın.

az repos pr reviewer add --id
                         --reviewers
                         [--detect {false, true}]
                         [--org]
                         [--subscription]

Parametreler

Azure DevOps CLI komutları Azure DevOps Server için desteklenmez.

İş öğelerini yeni bir çekme talebine bağlamak için:

1. Yeni çekme isteği sayfasında,bağlamak için iş öğeleri'ni altında İş öğelerini kimlik veya başlığa göre araseçin.
2. bir iş öğesi kimliği veya başlığı girmeye başlayın ve açılan listeden bağlanılacak iş öğesini seçin. Başlığa göre arama, duruma göre filtrelenmiş iş öğelerini döndürür; Durum kategorileri Tamamlandı ve Kaldırıldı olan tüm iş öğeleri dışlanır. Bu iş öğeleri tarihe ve kullanıcıya göre de filtrelenir ve yalnızca son 30 gün içinde oluşturulan veya güncelleştirilen öğeler gösterilir ve geçerli kullanıcı tarafından oluşturulmaları, atanmaları veya yetkilendirilmeleri gerekir.

İş öğelerini mevcut bir pull request'e bağlamak için:

1. Çekme İsteği Genel Bakış sekmesindeki İş öğeleri alanında +öğesini seçin.

   

2. İş öğesinin kimliğini girin veya iş öğesi başlığını arayın. Görüntülenen listeden iş öğesini seçin.

İş öğesinin yanındaki x simgesini seçerek iş öğesi bağlantısını kaldırın. Bir bağlantının kaldırılması, yalnızca iş öğesi ile çekme isteği arasındaki bağlantıyı kaldırır. Şubede veya taahhütlerden oluşturulan bağlantılar iş öğesinde kalır.

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

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

   

2. İş Öğeleri alanında ekle düğmesini seçin.

3. İş öğesinin kimliğini girin veya metninizle eşleşen başlıklara sahip iş öğelerini arayın. Görüntülenen listeden iş öğesini seçin. Başlığa göre arama, duruma göre filtrelenmiş iş öğelerini döndürür; Durum kategorileri Tamamlandı ve Kaldırıldı olan tüm iş öğeleri dışlanır. Bu iş öğeleri tarihe ve kullanıcıya göre de filtrelenir ve yalnızca son 30 gün içinde oluşturulan veya güncelleştirilen öğeler gösterilir ve geçerli kullanıcı tarafından oluşturulmaları, atanmaları veya yetkilendirilmeleri gerekir.

İş öğesinin üzerine geldiğinizde görüntülenen kaldır düğmesini seçerek iş öğesi bağlantılarını kaldırın. Bir iş öğesi ile bir PR arasındaki bağlantıyı kaldırmak yalnızca bağlantıyı kaldırır. Daldan veya commit'lerden oluşturulan bağlantılar iş öğesinde yer alır.

Çekme isteği oluşturma sırasında Azure Boards iş öğelerini az repos pr create --work-items <Id1> <Id2>ile PR'lere bağlayabilirsiniz; burada <Kimliği> iş öğesinin kimliğidir.

Örneğin, aşağıdaki komut, iş öğeleri #63 ve #64'ü new dalındaki yeni bir çekme isteğine bağlar:

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

Mevcut bir çekme isteğinin iş öğelerini yönetmek için az repos pr work-itemkullanın.

• İş öğelerini var olan bir çekme isteğine bağlamak için az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2>'ı kullanın.
• Bir PR'a bağlı iş öğelerini listelemek için az repos pr work-item list --id <PR Id>kullanın.
• bir iş öğesinin çekme isteği bağlantısını kaldırmak için az repos pr work-item remove --id <PR Id> --work-items <Id1>kullanın. Bağlantıyı kaldırmak yalnızca iş öğesi ile çekme isteği arasındaki bağlantıyı kaldırır. Dalda veya commit’lerden oluşturulan bağlantılar, iş öğesinde kalır.

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org]
                          [--subscription]

Parametre

Azure DevOps CLI komutları Azure DevOps Server için desteklenmez.