PublishTestResults@2 - Test Sonuçlarını Yayımla v2 görevi

Test sonuçlarını Azure Pipelines'da yayımlama.

Sözdizimi

# Publish Test Results v2
# Publish test results to Azure Pipelines.
- task: PublishTestResults@2
  inputs:
    testResultsFormat: 'JUnit' # 'JUnit' | 'NUnit' | 'VSTest' | 'XUnit' | 'CTest'. Alias: testRunner. Required. Test result format. Default: JUnit.
    testResultsFiles: '**/TEST-*.xml' # string. Required. Test results files. Default: **/TEST-*.xml.
    #searchFolder: '$(System.DefaultWorkingDirectory)' # string. Search folder. Default: $(System.DefaultWorkingDirectory).
    #mergeTestResults: false # boolean. Merge test results. Default: false.
    #failTaskOnFailedTests: false # boolean. Fail if there are test failures. Default: false.
    #failTaskOnFailureToPublishResults: false # boolean. Fail if there is failure in publishing test results. Default: false.
    #failTaskOnMissingResultsFile: false # boolean. Fail if no result files are found. Default: false.
    #testRunTitle: # string. Test run title. 
  # Advanced
    #buildPlatform: # string. Alias: platform. Build Platform. 
    #buildConfiguration: # string. Alias: configuration. Build Configuration. 
    #publishRunAttachments: true # boolean. Upload test results files. Default: true.

Girişler

testResultsFormat - Test sonucu biçimi
Giriş diğer adı: testRunner. string. Gerekli. İzin verilen değerler: JUnit, NUnit, VSTest, XUnit, CTest. Varsayılan değer: JUnit.

Yayımlamak istediğiniz sonuç dosyalarının biçimini belirtir. Aşağıdaki biçimler desteklenir: CTest, JUnit, NUnit 2, NUnit 3, Visual Studio Test (TRX) ve xUnit 2.

Tavsiye

VSTest formatı, TRX formatını ifade eder. Bu nedenle, Microsoft.Testing.Platform (MTP) ile TRX üretiyorsanız ve VSTest'e özgü değilse de çalışır. Değer, MTP'nin kullanıma sunulmasından önce tarihsel nedenlerden dolayı VSTest'tir.

Test sonuçları dosyalarınıtestResultsFiles -
string. Gerekli. Varsayılan değer: **/TEST-*.xml.

Bir veya daha fazla test sonucu dosyası belirtir.

• Tek klasörlü joker karakter (*) ve özyinelemeli joker karakterler (**) kullanabilirsiniz. Örneğin, **/TEST-*.xml adları tüm alt dizinlerdeki TEST- ile başlayan tüm XML dosyalarını arar. Test sonucu biçimi olarak VSTest kullanılıyorsa, dosya türü .trx olarak değiştirilmelidir, örneğin **/TEST-*.trx
• Birden çok yol belirtilebilir ve yeni bir satırla ayrılabilir.
• Ayrıca minimatch desenlerini kabul eder.

Örneğin, !TEST[1-3].xmlTEST1.xml, TEST2.xmlveya TEST3.xmladlı dosyaları dışlar.

searchFolder - Arama klasörü
string. Varsayılan değer: $(System.DefaultWorkingDirectory).

Opsiyonel. Test sonucu dosyalarının aranması için klasörü belirtir.

test sonuçlarını birleştirmemergeTestResults -
boolean. Varsayılan değer: false.

Bu boole değerinin değeri trueolduğunda, görev tüm dosyalardan alınan test sonuçlarını tek bir test çalıştırmasıraporlar. Değer falseise, görev her test sonucu dosyası için ayrı bir test çalıştırması oluşturur. Daha iyi performans elde etmek için, bu seçenek falseolarak ayarlanmış olsa bile 100'den fazla sonuç dosyası varsa sonuçlar her zaman tek bir çalıştırmada birleştirilir.

Uyarı

Sonuçları eşlemenin ve sürenin doğru hesaplandığından emin olmak için aynı test çerçevesindeki dosyaları birleştirmek için birleştirme testi sonuçları ayarını kullanın.

failTaskOnFailedTests - test hataları varsa başarısız oluyor
boolean. Varsayılan değer: false.

Opsiyonel. Bu boole değerinin değeri trueolduğunda, sonuç dosyasındaki testlerden herhangi biri başarısız olarak işaretlenirse görev başarısız olur. Varsayılan değer falseolur ve sonuç dosyasındaki sonuçları yayımlar.

failTaskOnFailureToPublishResults - Test sonuçlarını yayımlamada hata varsa başarısız
boolean. Varsayılan değer: false.

true, test sonuçlarını yayımlamada hata varsa görevi başarısız olur.

failTaskOnMissingResultsFile - sonuç dosyası bulunamazsa başarısız olur
boolean. Varsayılan değer: false.

Sonuç dosyası bulunamazsa görev başarısız olur.

çalıştırma başlığını test
string.

Opsiyonel. Sonuçların bildirileceği test çalıştırması için bir ad belirtir. Derleme veya yayın işlem hattında bildirilen değişken adları kullanılabilir.

platformbuildPlatform - oluşturma
Giriş diğer adı: platform. string.

Opsiyonel. Test çalıştırmasının raporlanması gereken derleme platformunu belirtir. Örneğin: x64 veya x86. Derleme görevinizde platform için bir değişken tanımladıysanız burada kullanın.

Derleme YapılandırmasıbuildConfiguration -
Giriş diğer adı: configuration. string.

Opsiyonel. Test çalıştırmasının raporlanması gereken derleme yapılandırmasını belirtir. Örneğin: Debug veya Release. Derleme görevinizdeki yapılandırma için bir değişken tanımladıysanız burada kullanın.

publishRunAttachments - Test sonuçları dosyalarını karşıya yükleme
boolean. Varsayılan değer: true.

Opsiyonel. Bu boole değerinin değeri trueolduğunda, görev tüm test sonucu dosyalarını test çalıştırmasına ek olarak yükler.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

• Önkoşullar
• Görev varsayılanları
• Sonuç biçimleri eşleme
• Ekler desteği

Bu görev, kapsamlı bir test raporlama ve analiz deneyimi sağlamak için testler yürütülürken test sonuçlarını Azure Pipelines veya TFS'de yayımlar. İstediğiniz test çalıştırıcısını, ihtiyacınız olan sonuç biçimini destekleyen kullanabilirsiniz. Desteklenen sonuç biçimleri CTest , JUnit (PHPUnitdahil), NUnit 2, NUnit 3, Visual Studio Test (TRX) ve xUnit 2içerir.

Visual Studio Test görevi ve Dot NetCore CLI görevi gibi diğer yerleşik görevler test sonuçlarını işlem hattına otomatik olarak yayımlar. Ant, Maven, Gulp, Gruntve X code gibi görevler, görev içinde bir seçenek olarak yayımlama sonuçları sağlar veya Cobertura ve JaCoCogibi kitaplıklar oluşturur. Bu görevlerden herhangi birini kullanıyorsanız, işlem hattında test sonuçlarını yayımlama ayrı bir görevine ihtiyacınız yoktur.

Yayımlanan test sonuçları, işlem hattı özetindeki Testler sekmesinde görüntülenir. Sonuçlar işlem hattı kalitesini ölçmenize, izlenebilirliği gözden geçirmenize, hataları gidermenize ve sürücü hatası sahipliğini gidermenize yardımcı olur.

Aşağıdaki örnekte görevin test sonuçlarını yayımlayacak şekilde yapılandırıldığı gösterilmektedir.

test geçmişi sayfasını açma

Kapsam raporlaması almak için testleri Azure Pipelines veya TFS'de çalıştırırken oluşturulan kod kapsamı sonuçlarını yayımlamak için bu görevi derleme işlem hattında da kullanabilirsiniz.

Önkoşullar

Windows şirket içinde barındırılan aracı kullanıyorsanız makinenizde şu önkoşul yüklü olmalıdır:

• .NET Framework 4.6.2 veya sonraki bir sürümü

Görev varsayılanları

Varsayılan seçenek, test sonuçlarını yayımlamak için JUnit biçimini kullanır. testRunnerolarak VSTest kullanılırken, testResultsFiles seçeneği **/TEST-*.trxolarak değiştirilmelidir.

testResultsFormat, testRunner giriş adı için bir diğer addır. Sonuç dosyaları yalnızca belirli bir çalıştırıcı tarafından değil, birden çok çalıştırıcı tarafından oluşturulabilir. Örneğin, jUnit sonuç biçimi yalnızca jUnit tarafından değil, birçok çalıştırıcı tarafından desteklenir.

YAML kullanarak Python'a yönelik test sonuçlarını yayımlamak için, bu konuların Ekosistemleri bölümünde python bölümüne bakın ve diğer diller için örnekler de içerir.

Sonuç biçimleri eşlemesi

Bu tabloda, derleme veya yayın özetinde Testler sekmesinde bildirilen alanlar ve desteklenen test sonucu biçimlerindeki özniteliklerle ilgili eşleme listelenir.

Kapsam	Saha	Visual Studio Testi (TRX)
Test çalıştırması	Başlık	Görevde belirtilen test çalıştırma başlığı
	Başlangıç tarihi	/TestRun/Times.Attributes[""]başlar. Değer
	Tamamlanma tarihi	/TestRun/Times.Attributes[""]sonlanıyor. Değer
	Süre	Tamamlanma tarihi - Başlangıç tarihi
	Ekleri	Aşağıdaki Ek desteği bölümüne bakın
Test sonucu	Başlık	/TestRun/Results/UnitTestResult.Attributes["testName"]. Value Or /TestRun/Results/WebTestResult.Attributes["testName"]. Value Or /TestRun/Results/TestResultAggregation.Attributes["testName"]. Değer
	Başlangıç tarihi	/TestRun/Results/UnitTestResult.Attributes["startTime"]. Value Or /TestRun/Results/WebTestResult.Attributes["startTime"]. Value Or /TestRun/Results/TestResultAggregation.Attributes["startTime"]. Değer
	Tamamlanma tarihi	/TestRun/Results/UnitTestResult.Attributes["startTime"]. Value + /TestRun/Results/UnitTestResult.Attributes["süre"]. Value Or /TestRun/Results/WebTestResult.Attributes["startTime"]. Value + /TestRun/Results/WebTestResult.Attributes["süre"]. Value Or /TestRun/Results/TestResultAggregation.Attributes["startTime"]. Value + /TestRun/Results/TestResultAggregation.Attributes["süre"]. Değer
	Süre	/TestRun/Results/UnitTestResult.Attributes["süre"]. Value Or /TestRun/Results/WebTestResult.Attributes["süre"]. Value Or /TestRun/Results/TestResultAggregation.Attributes["süre"]. Değer
	Sahip	/TestRun/TestDefinitions/UnitTest/Owners/Owner.Attributes["adı "]. Değer
	Sonuç	/TestRun/Results/UnitTestResult.Attributes[" "]sonucu. Value Or /TestRun/Results/WebTestResult.Attributes["sonucu "]. Value Or /TestRun/Results/TestResultAggregation.Attributes["sonuç"]. Değer
	Hata mesajı	/TestRun/Results/UnitTestResult/Output/ErrorInfo/Message.InnerText veya /TestRun/Results/WebTestResultOutput/ErrorInfo/Message.InnerText Or /TestRun/Results/TestResultAggregation/Output/ErrorInfo/Message.InnerText
	Yığın izleme	/TestRun/Results/UnitTestResult/Output/ErrorInfo/StackTrace.InnerText veya /TestRun/Results/WebTestResultOutput/ErrorInfo/StackTrace.InnerText or /TestRun/Results/TestResultAggregation/Output/ErrorInfo/StackTrace.InnerText
	Ekleri	Aşağıdaki Ek desteği bölümüne bakın
	Konsol günlüğü	/TestRun/Results/UnitTestResult/Output/StdOut.InnerText veya /TestRun/Results/WebTestResultOutput/Output/StdOut.InnerText Or /TestRun/Results/TestResultAggregation/Output/StdOut.InnerText
	Konsol hata günlüğü	/TestRun/Results/UnitTestResult/Output/StdErr.InnerText Veya /TestRun/Results/WebTestResultOutput/Output/StdErr.InnerText Or /TestRun/Results/TestResultAggregation/Output/StdErr.InnerText
	Temsilci adı	/TestRun/Results/UnitTestResult.Attributes["computerName"]. Value Or /TestRun/Results/WebTestResult.Attributes["computerName"]. Value Or /TestRun/Results/TestResultAggregation.Attributes["computerName"]. Değer
	Test dosyası	/TestRun/TestDefinitions/UnitTest.Attributes["depolama"]. Değer
	Öncelik	/TestRun/TestDefinitions/UnitTest.Attributes["öncelik"]. Değer

JUnit

Kapsam	Saha	JUnit
Test çalıştırması	Başlık	Görevde belirtilen test çalıştırma başlığı
	Başlangıç tarihi	/testsuites/testsuite. Attributes["zaman damgası "]. Değer
	Tamamlanma tarihi	/testsuites/testsuite. Attributes["zaman damgası "]. Değer + TOPLA(/testuites/testsuite/testcase. Öznitelikler["saat"]. Değer) test paketindeki tüm test çalışmaları için
	Süre	Tamamlanma tarihi - Başlangıç tarihi
	Ekleri	Test sonuçlarını yayımlamak için kullanılan sonuç dosyası
Test sonucu	Başlık	/testsuites/testsuite/testcase/Attributes["name"]. Değer
	Başlangıç tarihi	/testsuites/testsuite. Attributes["zaman damgası "]. Değer
	Tamamlanma tarihi	/testsuites/testsuite. Attributes["zaman damgası "]. Değer + /testsuites/testsuite/testcase. Öznitelikler["saat"]. Değer
	Süre	/testsuites/testsuite/testcase/. Öznitelikler["saat"]. Değer
	Sahip	/testsuites/testsuite/testcase/Attributes["sahibi "]. Değer
	Sonuç	Başarısız: varsa /Testsuites/testsuite/testcase/hatası Or /Testsuites/testsuite/testcase/hatasıYürütülmedi: varsa Testsuites/testsuite/testcase/atlandıAtlandı: diğer tüm durumlar için:
	Hata mesajı	/Testsuites/testsuite/testcase/failure. Attributes["ileti"]. Değer veya /Testsuites/testsuite/testcase/error. Attributes["ileti"]. Değer veya /Testsuites/testsuite/testcase/skipped. Attributes["iletisi "]. Değer
	Yığın izleme	/Testsuites/testsuite/testcase/failure. İç Metin Veya /testsuites/testsuite/testcase/error. İç Metin
	Ekleri	-
	Konsol günlüğü	/Testsuites/testsuite/testcase/system-out
	Konsol hata günlüğü	/Testsuites/testsuite/testcase/system-err
	Temsilci adı	/testsuites/testsuite. Attributes["hostname"]. Değer
	Test dosyası	/testsuites/testsuite/testcase/Attributes["classname"]. Değer
	Öncelik	-

NUnit 2

Kapsam	Saha	NUnit 2
Test çalıştırması	Başlık	Görevde belirtilen test çalıştırma başlığı
	Başlangıç tarihi	/test-results. Attributes["date"]. Değer + /test-results. Öznitelikler["saat"]. Değer
	Tamamlanma tarihi	Başlangıç tarihi + /test-results/results/test-case. Öznitelikler["saat"]. Tüm test çalışmaları için değer
	Süre	Tamamlanma tarihi - Başlangıç tarihi
	Ekleri	Test sonuçlarını yayımlamak için kullanılan sonuç dosyası
Test sonucu	Başlık	/test-results/results/test-case. Attributes["name"]. Değer
	Başlangıç tarihi	/test-results. Attributes["date"]. Değer + /test-results. Öznitelikler["saat"]. Değer
	Tamamlanma tarihi	Başlangıç tarihi + /test-results/results/test-case. Öznitelikler["saat"]. Değer
	Süre	/test-results/results/test-case. Öznitelikler["saat"]. Değer
	Sahip	kullanıcı için derleme veya yayın istendi
	Sonuç	Başarısız: varsa /test-results/results/test-case/hatasıYürütülmedi: varsa /test-results/results/test-case. Attributes["sonuç"]. Value=="Ignored" geçti: diğer tüm durumlar için
	Hata mesajı	/test-results/results/test-casefailure/iletisi. InnerText
	Yığın izleme	/test-results/results/test-case/failure/stack-trace. InnerText
	Ekleri	-
	Konsol günlüğü	/test-results/results/test-case/failure/iletisi. InnerText
	Konsol hata günlüğü	/test-results/results/test-case/çıkışı. InnerText
	Temsilci adı	/test-results/environment. Attributes["machine-name"]. Değer
	Test dosyası	/test-results/test-suite. Attributes["name"]. Değer
	Öncelik	-

NUnit 3

Kapsam	Saha	NUnit 3
Test çalıştırması	Başlık	Görevde belirtilen test çalıştırma başlığı
	Başlangıç tarihi	/test-run/başlangıç zamanı
	Tamamlanma tarihi	/test-run/bitiş zamanı
	Süre	Tamamlanma tarihi - Başlangıç tarihi
	Ekleri	Aşağıdaki Ek desteği bölümüne bakın
Test sonucu	Başlık	/test-suite[@type='Assembly']/test-case. Attributes["name"]. Değer
	Başlangıç tarihi	/test-suite[@type='Assembly']/test-case. Attributes["başlangıç zamanı"]. Değer
	Tamamlanma tarihi	/test-suite[@type='Assembly']/test-case. Attributes["end-time"]. Değer
	Süre	/test-suite[@type='Assembly']/test-case. Öznitelikler["süre"]. Değer
	Sahip	kullanıcı için derleme veya yayın istendi
	Sonuç	/test-results/test-suite/results/test-case. Attributes["sonuç"]. Değer
	Hata mesajı	/test-suite[@type='Assembly']/test-case/failure/ileti
	Yığın izleme	/test-suite[@type='Derleme']//test-case/failure/stack-trace
	Ekleri	Aşağıdaki Ek desteği bölümüne bakın
	Konsol günlüğü	/test-suite[@type='Assembly']/test-case/failure/ çıkış
	Konsol hata günlüğü	-
	Temsilci adı	/test-suite[@type='Assembly']/environment. Attributes["machine-name"]. Değer
	Test dosyası	/test-suite[@type='Assembly']. Attributes["name"]. Değer
	Öncelik	-

xBirim 2

Kapsam	Saha	xBirim 2
Test çalıştırması	Başlık	Görevde belirtilen test çalıştırma başlığı
	Başlangıç tarihi	/assemblies/assembly/çalışma tarihi + /assemblies/assembly/çalışma zamanı
	Tamamlanma tarihi	Başlangıç tarihi + /assemblies/assembly/saat
	Süre	Tamamlanma tarihi - Başlangıç tarihi
	Ekleri	Test sonuçlarını yayımlamak için kullanılan sonuç dosyası
Test sonucu	Başlık	/assemblies/assembly/collection/test. "]Attributes["yöntemi. Değer
	Başlangıç tarihi	/assemblies/assembly/çalışma tarihi + /assemblies/assembly/çalışma zamanı
	Tamamlanma tarihi	Başlangıç tarihi + /assemblies/assembly/collection/test. Öznitelikler["saat"]. Değer
	Süre	/assemblies/assembly/collection/test. Öznitelikler["saat"]. Değer
	Sahip	/assemblies/assembly/collection/test/traits/trait[@name='owner']. Attributes["değeri"]. Değer
	Sonuç	/assemblies/assembly/collection/test/failure. Attributes["sonuç"]. Değer
	Hata mesajı	/assemblies/assembly/collection/test/failure/ileti
	Yığın izleme	/montajlar/derleme/koleksiyon/test/hata/yığın izleme
	Ekleri	-
	Konsol günlüğü	/assemblies/assembly/collection/test/failure/ çıkış
	Konsol hata günlüğü	-
	Temsilci adı	-
	Test dosyası	/assemblies/assembly. Attributes["name"]. Değer
	Öncelik	/testcaseNode/traits/trait[@name='priority']. Attributes["değeri"]. Değer

CTest (Deney)

Kapsam	Saha	CTest (Deney)
Test çalıştırması	Başlık	Görevde belirtilen test çalıştırma başlığı
	Başlangıç tarihi	/Site/Testing/StartTestTime.InnerText
	Tamamlanma tarihi	/Site/Testing/EndTestTime.InnerText
	Süre	Tamamlanma tarihi - Başlangıç tarihi
	Ekleri	Test sonuçlarını yayımlamak için kullanılan sonuç dosyası
Test sonucu	Başlık	/Site/Test/Test/Name.InnerText
	Başlangıç tarihi	/Site/Testing/StartTestTime.InnerText
	Tamamlanma tarihi	Başlangıç Tarihi + /Site/Test/Test/Sonuçlar/NamedMeasurement[@name= 'Yürütme Zamanı']/Value.InnerText
	Süre	/Site/Testing/Test/Results/NamedMeasurement[@name= 'Yürütme Zamanı']/Value.InnerText
	Sahip	Kullanıcı için derleme veya yayın istendi
	Sonuç	/Site/Testing/Test.Attributes["Status"]. Değer
	Hata mesajı	-
	Yığın izleme	/Site/Test/Test/Sonuçlar/Ölçüm/Value.InnerText
	Ekleri	-
	Konsol günlüğü	-
	Konsol hata günlüğü	-
	Temsilci adı	-
	Test dosyası	/Site/Test/Test/Path.InnerText
	Öncelik	-

Uyarı

Süre yalnızca Başlangıç Tarihi ve Tamamlanma Tarihi kullanılabilir olmadığında kullanılır.

testName için tam ad biçimi, 512 karakter sınırına sahip Namespace.Testclass.Methodname . Test veri temelliyse ve parametreleri varsa, karakter sınırı parametreleri içerir.

Test sonucunu yayımlarken şu hatayı alabilirsiniz: Test sonuçları yayımlanamadı: Geçersiz Öncelik belirtildi

Test yöntemlerinden herhangi birinin önceliği 255'in üzerinde ayarlanmışsa, koddaki test yöntemi önceliğini düzeltirse ve testleri yeniden yürütürse bu hata oluşur. 255'ten büyük önceliğe sahip tüm testleri görmek için oluşturulan trx dosyasını gözden geçirebilirsiniz.

Ekler desteği

Test Sonuçlarını Yayımla görevi, aşağıdaki biçimler için hem test çalıştırması hem de test sonuçları için ekler için destek sağlar. Genel projeler için toplam 2 GB eki destekliyoruz.

Visual Studio Testi (TRX)

Kapsam	Türü	Yol
Test çalıştırması	Veri Toplayıcı	/TestRun/ResultSummary/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes["href"]. Değer
	Test Sonucu	/TestRun/ResultSummary/ResultFiles/ResultFile.Attributes["yolu "]. Değer
	Kod Kapsamı	/TestRun/TestSettings/Execution/AgentRule/DataCollectors/DataCollector/Configuration/CodeCoverage/Regular/CodeCoverageItem.Attributes["binaryFile"]. Value And /TestRun/TestSettings/Execution/AgentRule/DataCollectors/DataCollector/Configuration/CodeCoverage/Regular/CodeCoverageItem.Attributes["pdbFile"]. Değer
Test sonucu	Veri Toplayıcılar	/TestRun/Results/UnitTestResult/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes["href"]. Value Or /TestRun/Results/WebTestResult/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes["href"]. Value Or /TestRun/Results/TestResultAggregation/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes["href"]. Değer
	Test Sonucu	/TestRun/Results/UnitTestResult/ResultFiles/ResultFile.Attributes["yolu"]. Value Or /TestRun/Results/WebTestResult/ResultFiles/ResultFile.Attributes["yolu"]. Value Or /TestRun/Results/TestResultAggregation/ResultFiles/ResultFile.Attributes["yolu "]. Değer

NUnit 3

NUnit 3

Kapsam	Yol
Test çalıştırması	/test-paketi/ekler/ek/dosyaYolu
Test çalıştırması	/test-paketi[@type='Derleme']/test-case/attachments/attachment/filePath

JUnit

JUnit

Kapsam	Yol
Test Sonucu	/testsuites/testsuite/testcase/system-out/ -> İçerik eşleştirme deseni [[ATTACHMENT|filePath]]

Uyarı

Test sonuçları dosyasını ek olarak karşıya yükleme seçeneği, görevdeki tüm biçimler için geçerli olan varsayılan bir seçenektir.

Örnekler

Docker

Docker tabanlı uygulamalar için uygulamanızı derlemenin ve testleri çalıştırmanın birçok yolu vardır:

• Derleme işlem hattında derleme ve test: derlemeler ve testler işlem hattında yürütülür ve test sonuçları Test Sonuçlarını Yayımla görevi kullanılarak yayımlanır.
• Çok aşamalı dockerfilederleme ve test etme: derlemeler ve testler kapsayıcı içinde çok aşamalı bir Docker dosyası kullanarak yürütülür, bu test sonuçları işlem hattında yeniden yayımlanmaz.
• Dockerfile ile derleme, test ve yayımlama sonuçlarını: derlemeler ve testler kapsayıcı içinde yürütülür ve sonuçlar işlem hattında yeniden yayımlanır. Aşağıdaki örniğe bakın.

Docker dosyasıyla sonuçları derleme, test etme ve yayımlama

Bu yaklaşımda bir Docker dosyası kullanarak kodunuzu derleyip kapsayıcının içinde testler çalıştıracaksınız. Test sonuçları daha sonra işlem hattında yayımlanmak üzere konağa kopyalanır. Test sonuçlarını Azure Pipelines'da yayımlamak için Test Sonuçlarını Yayımla görevini kullanabilirsiniz. Son görüntü Docker veya Azure Container Registry'de yayımlanır.

Kodu al

1. Proje dizininizin kökünde aşağıdakilerle bir Dockerfile.build dosyası oluşturun:

   # Build and run tests inside the docker container
   FROM mcr.microsoft.com/dotnet/sdk:2.1
   WORKDIR /app
   # copy the contents of agent working directory on host to workdir in container
   COPY . ./
   # dotnet commands to build, test, and publish
   RUN dotnet restore
   RUN dotnet build -c Release
   RUN dotnet test dotnetcore-tests/dotnetcore-tests.csproj -c Release --logger "trx;LogFileName=testresults.trx"
   RUN dotnet publish -c Release -o out
   ENTRYPOINT dotnet dotnetcore-sample/out/dotnetcore-sample.dll
   

   Bu dosya, kod oluşturma ve testleri çalıştırma yönergelerini içerir. Testler daha sonra kapsayıcının içindeki testresults.trx bir dosyaya kopyalanır.

2. Yalnızca çalışma zamanı ve dağıtım yapıtlarını içeren son görüntüyü mümkün olduğunca küçük hale getirmek için, var olan Dockerfile içeriğini aşağıdakilerle değiştirin:

   # This Dockerfile creates the final image to be published to Docker or
   # Azure Container Registry
   # Create a container with the compiled asp.net core app
   FROM mcr.microsoft.com/dotnet/aspnet:2.1
   # Create app directory
   WORKDIR /app
   # Copy only the deployment artifacts
   COPY /out .
   ENTRYPOINT ["dotnet", "dotnetcore-sample.dll"]
   

Derleme işlem hattını tanımlama

YAML (YAML Türkçesi

1. Docker Hub hesabınız varsa ve görüntüyü Docker kayıt defterinize göndermek istiyorsanız, .vsts-ci.docker.yml dosyasının içeriğini aşağıdakilerle değiştirin:

   # Build Docker image for this app, to be published to Docker Registry
   pool:
     vmImage: 'ubuntu-latest'
   variables:
     buildConfiguration: 'Release'
   steps:
   - script: |
       docker build -f Dockerfile.build -t $(dockerId)/dotnetcore-build:$BUILD_BUILDID .
       docker run --name dotnetcoreapp --rm -d $(dockerId)/dotnetcore-build:$BUILD_BUILDID
       docker cp dotnetcoreapp:app/dotnetcore-tests/TestResults $(System.DefaultWorkingDirectory)
       docker cp dotnetcoreapp:app/dotnetcore-sample/out $(System.DefaultWorkingDirectory)
       docker stop dotnetcoreapp
   
   - task: PublishTestResults@2
     inputs:
       testRunner: VSTest
       testResultsFiles: '**/*.trx'
       failTaskOnFailedTests: true
   
   - script: |
       docker build -f Dockerfile -t $(dockerId)/dotnetcore-sample:$BUILD_BUILDID .
       docker login -u $(dockerId) -p $pswd
       docker push $(dockerId)/dotnetcore-sample:$BUILD_BUILDID
     env:
       pswd: $(dockerPassword)
   

   Alternatif olarak, bir Azure Container Registry yapılandırır ve görüntüyü bu kayıt defterine göndermek isterseniz, .vsts-ci.yml dosyasının içeriğini aşağıdakilerle değiştirin:

   # Build Docker image for this app to be published to Azure Container Registry
   pool:
     vmImage: 'ubuntu-latest'
   variables:
     buildConfiguration: 'Release'
   
   steps:
   - script: |
       docker build -f Dockerfile.build -t $(dockerId)/dotnetcore-build:$BUILD_BUILDID .
       docker run --name dotnetcoreapp --rm -d $(dockerId)/dotnetcore-build:$BUILD_BUILDID
       docker cp dotnetcoreapp:app/dotnetcore-tests/TestResults $(System.DefaultWorkingDirectory)
       docker cp dotnetcoreapp:app/dotnetcore-sample/out $(System.DefaultWorkingDirectory)
       docker stop dotnetcoreapp
   
   - task: PublishTestResults@2
     inputs:
       testRunner: VSTest
       testResultsFiles: '**/*.trx'
       failTaskOnFailedTests: true
   
   - script: |
       docker build -f Dockerfile -t $(dockerId).azurecr.io/dotnetcore-sample:$BUILD_BUILDID .
       docker login -u $(dockerId) -p $pswd $(dockerid).azurecr.io
       docker push $(dockerId).azurecr.io/dotnetcore-sample:$BUILD_BUILDID 
     env:
       pswd: $(dockerPassword)
   

2. Değişikliği deponuzdaki ana dala gönderin.

3. Azure Container Registry kullanıyorsanız Azure portalda kayıt defteri önceden oluşturduğunuzdan emin olun. Azure portalındaki kayıt defteri ayarlarının Erişim anahtarları bölümünde gösterilen yönetici kullanıcı adını ve parolasını kopyalayın.

4. Derleme işlem hattınızı aşağıdakilerle güncelleştirin

   • Aracısı havuzu: Hosted Ubuntu 1604
     • dockerId : Değeri DockerHub için Docker kimliğinize veya Azure Container Registry'nin yönetici kullanıcı adına ayarlayın.
     • dockerPassword : DockerHub için parolanıza veya Azure Container Registry yönetici parolasına değerini ayarlayın.
   • YAML dosya yolunu : /.vsts-ci.docker.yml

5. Yeni bir derlemeyi kuyruğa alın ve bir Docker görüntüsü oluşturup kayıt defterinize ve test sonuçlarını Azure DevOps'a gönderin.

Klasik

1. Boş işkullanarak yeni bir derleme işlem hattı oluşturun.

2. Derleme işlem hattı düzenleyicisinin Görevler sayfasında İşlem Hattı seçin ve özelliklerini aşağıdaki gibi düzenleyin

   • Aracısı kuyruğu: Hosted Ubuntu 1604

3. Bash görev ekleyin ve yapıtları derlemek ve konağa kopyalamak için aşağıdaki gibi yapılandırın:

   • Tür: Satır içi

   • Betik: Yapıtları oluşturmak, test etmek ve konağa kopyalamak için aşağıdaki betiği kullanın:

     docker build -f Dockerfile.build -t $(dockerId)/dotnetcore-build:$BUILD_BUILDID .
     docker run --name dotnetcoreapp --rm -d $(dockerId)/dotnetcore-build:$BUILD_BUILDID
     docker cp dotnetcoreapp:app/dotnetcore-tests/TestResults $(System.DefaultWorkingDirectory)
     docker cp dotnetcoreapp:app/dotnetcore-sample/out $(System.DefaultWorkingDirectory)
     docker stop dotnetcoreapp
     

4. sonuçları işlem hattında yayımlamak ve özelliklerini aşağıdaki gibi düzenlemek için Test Sonuçlarını Yayımla görevi ekleyin:

   • Test sonucu biçimi: VSTest
   • test sonuçları dosyalarını : **/*.trx

5. Son görüntüyü depoda yayımlamak ve özelliklerini aşağıdaki gibi düzenlemek için bir Bash görev ekleyin:

   • Tür: Inline

   • Betik:

     • Docker Hub'a göndermek için aşağıdaki betiği kullanın:

       docker build -f Dockerfile -t $(dockerId)/dotnetcore-sample:$BUILD_BUILDID .
       docker login -u $(dockerId) -p $(dockerPassword)
       docker push $(dockerId)/dotnetcore-sample:$BUILD_BUILDID
       

     • Azure Container Registry'ye göndermek için aşağıdaki betiği kullanın:

       docker build -t $(dockerId).azurecr.io/dotnetcore-sample:$BUILD_BUILDID . 
       docker login -u $(dockerId) -p $(dockerPassword) $(dockerId).azurecr.io 
       docker push $(dockerId).azurecr.io/dotnetcore-sample:$BUILD_BUILDID
       

6. Azure Container Registry kullanıyorsanız Azure portalda kayıt defteri önceden oluşturduğunuzdan emin olun. Azure Portal'da kayıt defteri ayarlarının Erişim anahtarları bölümünde gösterilen yönetici kullanıcı adını ve parolasını kopyalayın.

7. Derleme işlem hattının Değişkenleri sekmesinde iki değişken tanımlayın:

   • dockerId : Değeri DockerHub için Docker kimliğinize veya Azure Container Registry'nin yönetici kullanıcı adına ayarlayın.
   • dockerPassword : DockerHub veya yönetici parolası Azure Container Registry değerini parolanıza ayarlayın ve güvenli olarak işaretleyin.

8. İşlem hattını kaydedin ve bir derlemeyi kuyruğa alın. Kayıt defterinize bir Docker görüntüsü oluşturup göndermesini ve test sonuçlarını Azure DevOps'a göndermesini izleyin.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talepleri	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi bir
Ayarlanabilir değişkenleri	Herhangi bir
Aracı sürümü	2.0.0 veya üzeri
Görev kategorisi	Sınav