İşlem hatlarını iş izlemeyi destekleyecek şekilde yapılandırma

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

İşlem hatları ile Azure DevOps Services genelinde tümleştirmeyi ve izlenebilirliği desteklemek için çeşitli seçenekler yapılandırabilirsiniz. İşlem hattı durumunu bildirebilir, durum rozetlerinin söz dizimini kopyalayabilir ve iş öğelerinin derlemelere ve sürümlere otomatik olarak bağlanmasını ayarlayabilirsiniz.

Desteklenen işlem hattı ve iş takibi entegrasyon özellikleri

Kullanıcı hikayeleri ve özellikler, geliştirme döngüsünde ilerledikçe çeşitli özellikler uçtan uca izlenebilirlik desteği sağlar. şu bağlantı türleriyle iş öğelerini işlem hattı nesnelerine bağlayabilirsiniz: Derleme, Derlemeyle tümleşik ve Yayında tümleşik. Bu bağlantı türleri hem Azure Repos hem de GitHub depolarıyla çalışır. GitHub depolarına sahip YAML işlem hatları için, ilişkili iş öğelerinde otomatik Tümleşik derleme bağlantılarını etkinleştirebilirsiniz. Klasik yayın işlem hatlarında Panolara yayın durumunu bildir seçeneğini etkinleştirerek Yayın ortamında tümleşik bağlantısını oluşturabilirsiniz.

İş öğelerini Azure Pipelines nesnelerine bağlayan bağlantı türlerini gösteren kavramsal diyagramın ekran görüntüsü.

Aşağıdaki tabloda Azure Boards ile Azure Pipelines arasındaki tümleştirme noktaları özetlemektedir. Seçenekler ve yapılandırma adımları, YAML veya Klasik işlem hattı yapılandırmanıza ve Azure DevOps sürümünüze bağlı olarak farklılık gösterir. Aksi belirtilmediği sürece çoğu seçenek Azure Repos Git deposunda veya GitHub deposunda çalıştırılan işlem hatları için desteklenir.

Özellik

Açıklama

Desteklenen sürümler


İş öğeleriyle derlemeler arasında elle bağlantı kurma

Bir iş öğesinden, aynı proje veya kuruluş içindeki diğer projelerdeki derlemelere bağlantı kurabilirsiniz. Daha fazla bilgi için bkz Diğer nesnelerden iş öğelerine bağlanma.

Tüm sürümler


Bir iş öğesine bağlı derlemeleri görüntüleme

Bir iş öğesine bağlı olan tüm derlemeleri, ister manuel ister otomatik olarak bağlanmış olsun, Bağlantılar sekmesinden görüntüleyebilirsiniz. Daha fazla bilgi için bkz Diğer nesnelerden iş öğelerine bağlanma, Bağlı nesnelerin listesini görüntüleme.

Tüm sürümler


İş öğelerini otomatik olarak derlemelere bağla.

Geliştirme denetimini Derlemede tümleşik bağlantılarla doldurmak için gereklidir. Bir yayının parçası olan iş öğeleri veya işlemeler yapıtların sürümlerinden hesaplanır. Örneğin, Azure Pipelines'daki her derleme bir dizi iş öğesi ve commit'lerle ilişkilendirilir. Bu seçenek hem Azure Depoları hem de GitHub depoları için desteklenir. Daha fazla bilgi için bu makalenin devamında yer alan İş öğelerini otomatik olarak bağlama bölümüne bakın.

YAML, Azure DevOps Server 2020 ve üzeri


İş öğelerini yayınlara otomatik olarak bağlama ve dağıtım durumunu bir iş öğesine bildirme (yalnızca klasik)

İş öğesi formundaki Dağıtım denetimini Yayın aşamasında tümleşik bağlantılarla doldurmak için bu göreve ihtiyacınız vardır. Daha fazla bilgi için bu makalenin devamında dağıtım durumunu Panolara bildirme bölümüne bakın.

Azure DevOps Server 2020 ve üzeri


Derleme veya yayına bağlı olan iş öğelerinin listesini görüntüle

Derleme veya sürüme dahil edilen iş öğelerini gözden geçirin ve açın.

YAML, Azure DevOps Server 2020 ve üzeri


Hata durumunda iş öğesi oluşturma (Klasik)

Derleme başarısız olduğunda otomatik olarak bir iş öğesi oluşturun ve isteğe bağlı olarak iş öğesi alanları için değerler ayarlayın. Daha fazla bilgi için bu makalenin devamında Hata durumunda iş öğesi oluşturma konusuna bakın.

Tüm sürümler


Çalışma Öğelerini Sorgula görevi, sorgudan döndürülen eşleşen iş öğelerinin sayısının eşik içinde olduğundan emin olun.

İş öğesi sorgusu tarafından döndürülen eşleşen öğelerin sayısının yapılandırılan eşikler içinde olduğundan emin olmak için bu görevi kullanın. Daha fazla bilgi için Sorgu İş Öğeleri görevi ve Geçitler ve onaylarla dağıtımları denetleme bölümüne bakın.

Azure DevOps Server 2020 ve sonraki sürümleri


Önkoşullar

  • Klasik yayın işlem hattının tümleştirme seçeneklerini yapılandırmak için yayını düzenleme izinleriniz olmalıdır.
  • İş öğelerini işlemelere ve çekme isteklerine bağlamak için , bu düğümdeki iş öğelerini düzenleme izninizi, iş öğesine atanan Alan Yolu için İzin Ver olarak ayarlamanız gerekir. Varsayılan olarak Katkıda Bulunanlar grubu bu izin ayarına sahiptir.
  • İş öğelerini görüntülemek için , bu düğümdeki iş öğelerini görüntüleme izninizi, iş öğesine atanan Alan Yolu için İzin Ver olarak ayarlamanız gerekir.

İşlem hattı ayarlarını, derleme seçeneklerini veya tümleştirme seçeneklerini açma

İşlem hattı ayarlarını açma

YAML tanımlı yayın işlem hatları için tümleştirmeyi İşlem Hattı ayarları iletişim kutusu aracılığıyla yapılandırabilirsiniz.

  • İşlem hattını açın, Diğer eylemler'i ve ardından Ayarlar'ı seçin.

    Ayarlar seçeneğini gösteren Diğer eylemler menüsünün açık olduğu YAML işlem hattının ekran görüntüsü.

    Veri Hattı Ayarları iletişim kutusu görüntülenir. Otomatik bağlama hakkında daha fazla bilgi için bkz. İş öğelerini otomatik olarak bağlama.

    Bu derlemede yeni iş öğelerini otomatik olarak bağla seçeneğiyle YAML İşlem Hattı ayarları iletişim kutusunun ekran görüntüsü.

Otomatik bağlamayı etkinleştirerek, büyük bir derleme veya yayın kümesinde el ile arama yapmak zorunda kalmadan çalışmayı içeren derlemeleri veya sürümleri izleyebilirsiniz. İş öğesiyle ilişkili her başarılı derleme, iş öğesi formunun Geliştirme denetiminde otomatik olarak görüntülenir. İş öğesiyle ilişkili her yayın aşaması, iş öğesi formunun Dağıtım denetiminde otomatik olarak görüntülenir.

Bu özellik hem Azure Repos hem de GitHub depoları için çalışır. Bağlı bir GitHub deposundan kod derleyen YAML işlem hatları için, bu seçeneğin etkinleştirilmesi ilişkili iş öğelerinde Tümleşik derleme bağlantıları oluşturur ve Azure Repos ile aynı derleme izlenebilirliği deneyimini sağlar. GitHub tümleştirmesi hakkında daha fazla bilgi için bkz. GitHub commit'lerini, çözüm isteklerini, branşları ve sorunları iş öğelerine bağlama.

  1. İşlem Hattı ayarlarınıİşlem Hattı ayarlarını Aç'ta açıklandığı gibi açın.

  2. Bu derlemedeki yeni çalışmayı otomatik olarak bağla seçeneğini etkinleştirin.

    İşlem hattı ayarları iletişim kutusunun ekran görüntüsü: Bu derlemedeki iş öğelerini otomatik olarak bağla.

    Etkinleştirildikten sonra, her sürüm çalıştırmasında seçilen çekme isteğine bağlı tüm iş öğeleri için Build'de Entegre bağlantılar oluşturulur.

Otomatik bağlamaya hangi iş öğeleri dahil edilir?

Yazılımınızı geliştirirken bir dal, commit işlemi veya pull isteği oluşturduğunuzda iş öğelerini bağlayabilirsiniz. Ya da bir iş öğesinden bir dal oluşturabilir, taahhüt edebilir veya çekme isteği başlatabilir ve bu nesneleri Bir İş Öğesinden Git Geliştirmeyi Yürütme bölümünde şekilde açıklandığı gibi otomatik olarak ilişkilendirebilirsiniz. Örneğin, burada siparişi iptal etme formu kullanıcı hikayesinden yeni bir dal oluşturacağız.

Dal oluştur iletişim kutusunun, iş öğesi bağlantı seçeneklerini gösteren ekran görüntüsü.

İş öğelerini derlemelere otomatik olarak bağladığınızda aşağıdaki hesaplamalar yapılır:

  • İlk kez oluşturma için:

    • Oluşturmayla ilişkili dal, taahhütler ve çekme talepleriyle bağlantılı tüm iş öğelerini tanımlayın.
  • Sonraki yapılar için:

    • Oluşturulan geçerli işleme (C1) ile ilişkili tüm iş öğelerini tanımlayın.
    • Aynı kaynak dalının son başarılı derlemesinin taahhüdü (C2) ile ilişkili tüm iş öğelerini tanımlayın.
    • İşleme ağacındaki C1 ve C2 arasındaki işlemelerle ilişkili tüm iş öğelerini tanımlayın.

Derleme hatasında iş öğesi oluşturma (Klasik)

Derleme işlem hattı başarısız olursa, sorunu düzeltmeyi izlemek için otomatik olarak bir iş öğesi oluşturabilirsiniz. İş öğesi türünü belirtebilir ve istek sahibine veya diğer alanlara otomatik olarak atamak için seçenekleri ayarlayabilirsiniz. İstek sahibi, derlemeyi tetikleyen kişiye karşılık gelir.

İpucu

Hata durumunda iş öğesi oluşturma seçeneği yalnızca Klasik işlem hatları için desteklenir. Bunu bir YAML işlem hattıyla gerçekleştirmek için, "Yayın hatasında Hata Oluştur" gibi bir market uzantısı kullanabilir veya Azure CLI ya da REST API çağrılarını kullanarak bunu kendiniz uygulayabilirsiniz.

  1. İşlem hattı derleme seçeneklerini, derleme özellikleri bölümünde tarif edildiği şekilde açın.

  2. Hata durumunda İş öğesi oluştur'u etkinleştirin ve oluşturulacak iş öğesinin türünü seçin. Opsiyonel olarak Talep sahibine ata onay kutusunu işaretleyip, Atanacak Kişi alanını ayarlayın ve oluşturulacak iş öğesinde ayarlamak üzere alanlar ekleyin.

    Örneğin, burada Hata iş öğesi türünü seçip Öncelik ve Etiketler alanlarını ve bunların değerlerini belirteceğiz.

    Hata İş Öğesi türü seçili olarak derleme seçeneklerindeki Başarısızlıkta İş Öğesi Oluştur seçeneğinin ekran görüntüsü.

  3. İşlem hattınızı kaydedin.

Bir alanın başvuru adını bulmak için İş öğesi alan dizininden bakın. Devralınan bir işlem aracılığıyla eklediğiniz özel alanlar için Azure DevOps, "Custom" ön ekli kullanıcı dostu alan adına dayalı bir başvuru adı atar. Örneğin, "DevOps Triage" adlı bir alan eklersiniz. Referans adı Custom.DevOpsTriage'dir. Referans adında boşluk kullanılmasına izin verilmez.

Durum rozetini alma veya etkinleştirme

  1. İşlem hattı Diğer Eylemler'i açın ve Durum rozeti'ni seçin.

    Durum rozeti seçeneğine sahip YAML işlem hattı Diğer Eylemler menüsünün ekran görüntüsü.

  2. İlgi alanı dalını ve kapsamını seçin ve ardından resmi veya Markdown söz dizimini kopyalamak için Panoya kopyala'yı seçin.

    Dal ve kapsam seçimi seçeneklerini gösteren YAML işlem hattı durumu rozeti iletişim kutusunun ekran görüntüsü.

Depo ana bilgisayarına dağıtım durumunu bildirme (Klasik)

Kodunuz bir Azure Repos Git deposunda depolandığında, yayın işlem hattınızı Azure Repos sayfalarında bir rozet görüntüleyecek şekilde yapılandırabilirsiniz. Rozet, belirli commit'in yayımlandığı yeri ve dağıtımın başarılı mı yoksa başarısız mı olduğunu gösterir. Bu seçenek kod işlemeden dağıtıma kadar izlenebilirliği artırır.

Klasik boru hatları için Entegrasyon seçeneklerinin ekran görüntüsü, Dağıtım durumunu depo sunucusu ayarlarına bildirmek için gösterilmektedir.

Azure Repos dağıtım durumunu aşağıdaki bölümlerde görüntüler:

  • Dosyalar: Seçili dal için en son dağıtımın durumunu gösterir.
  • İşlemeler: Her işleme için dağıtım durumunu gösterir (yayınınız için sürekli tümleştirme (CD) tetikleyicisinin etkinleştirilmesini gerektirir).
  • Dallar: Her dal için en son dağıtımın durumunu gösterir.

Bir commit'i, birden çok aşamaya sahip birden fazla dağıtım hattına gönderirseniz, her aşama durumuyla birlikte rozette görüntülenir. Varsayılan olarak, yayın işlem hattı oluşturduğunuzda tüm aşamalar için dağıtım durumu gönderilir. Ancak, durum rozetinde dağıtım durumunun görüntüleneceği aşamaları seçmeli olarak seçebilirsiniz (örneğin, yalnızca üretim aşamasını göster). Ekip üyeleriniz durum rozetini seçerek yayın işlem hatlarının seçili aşamalarının her birinin en son dağıtım durumunu görüntüleyebilir.

Dağıtım durumunu Jira'ya bildirme (Klasik)

Jira sorunlarını iş öğelerine ekleyin ve aşama tamamlandığında tüm sorunların bağlantılarını oluşturun. Jira Yazılım bulutunda Jira için Azure Pipelines uygulamasını yükleyin ve bağlantı oluşturmak için kuruluş ekleyin.

Jira ayarlarına dağıtım durumunu raporla'yı gösteren Klasik işlem hatları için Tümleştirme seçeneklerinin ekran görüntüsü.

Jira sorun izleme ile tümleştirmeyi desteklemek için, Jira için Azure DevOps'u yükleyin ve Azure DevOps kuruluşlarınızı Jira Yazılımı örneğiniz ile bağlayın. Tek bir örnekle birden fazla kuruluşa bağlanabilir ve tüm ekipleriniz ve ilgili projeleriniz için veri alabilirsiniz. Daha fazla bilgi için bkz . Azure DevOps'u Jira'ya bağlama.