PublishTestResults@2 - 發佈測試結果 v2 工作

發行項
07/02/2024

將測試結果發佈至 Azure Pipelines。

將測試結果發佈至 Azure Pipelines/TFS。

Syntax

# 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.

# 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.
    #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.

# Publish Test Results v2
# Publish Test Results to Azure Pipelines/TFS.
- task: PublishTestResults@2
  inputs:
    testResultsFormat: 'JUnit' # 'JUnit' | 'NUnit' | 'VSTest' | 'XUnit'. 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.
    #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.

輸入

testResultsFormat - 測試結果格式
輸入別名： testRunner。 string. 必要。允許的值：JUnit、、、VSTestNUnitXUnit、、 CTest。預設值：JUnit。

指定您想要發佈的結果檔案格式。支援下列格式： CTest、 JUnit、NUnit 2、NUnit 3、Visual Studio Test (TRX) 和 xUnit 2。

testResultsFormat - 測試結果格式
輸入別名： testRunner。 string. 必要。允許的值：JUnit、、、NUnitVSTest。XUnit 預設值：JUnit。

指定您想要發佈的結果檔案格式。支援下列格式： CTest、 JUnit、NUnit 2、NUnit 3、Visual Studio Test (TRX) 和 xUnit 2。

testResultsFiles - 測試結果檔案
string. 必要。預設值：**/TEST-*.xml。

指定一或多個測試結果檔案。

您可以使用單一資料夾通配符 () * 和遞迴通配符 (**) 。例如， **/TEST-*.xml 搜尋名稱開頭 TEST- 為所有子目錄中的所有 XML 檔案。如果使用 VSTest 做為測試結果格式，則檔類型應該變更為 .trx ，例如 **/TEST-*.trx
您可以指定多個路徑，並以新行分隔。
此外，還接受迷你模式。

例如， !TEST[1-3].xml 排除名為 TEST1.xml、 TEST2.xml或的 TEST3.xml檔案。

searchFolder - 搜尋資料夾
string. 預設值：$(System.DefaultWorkingDirectory)。

選擇性。指定要搜尋測試結果檔案的資料夾。

mergeTestResults - 合併測試結果
boolean. 預設值：false。

當這個布爾值是 true時，工作會針對單一測試回合報告來自所有檔案的測試結果。如果值為 false，則工作會為每個測試結果檔案建立個別的測試回合。

注意

使用合併測試結果設定來合併來自相同測試架構的檔案，以確保正確計算結果對應和持續時間。

failTaskOnFailedTests - 如果測試失敗，則失敗
boolean. 預設值：false。

選擇性。當這個布爾值為 true時，如果結果檔中的任何測試標示為失敗，工作將會失敗。默認值為 false，只會從結果檔發佈結果。

failTaskOnFailureToPublishResults - 如果發佈測試結果失敗，則失敗
boolean. 預設值：false。

當時 true，如果發佈測試結果失敗，工作就會失敗。

failTaskOnMissingResultsFile - 如果找不到結果檔案，則失敗
boolean. 預設值：false。

如果找不到結果檔，工作就會失敗。

testRunTitle - 測試回合標題
string.

選擇性。指定將報告結果的測試回合名稱。您可以使用組建或發行管線中宣告的變數名稱。

buildPlatform - 建置平臺
輸入別名： platform。 string.

選擇性。指定應該報告測試回合的組建平臺。例如：x64 或 x86。如果您在建置工作中定義平臺的變數，請使用這裡。

buildConfiguration - 組建組態
輸入別名： configuration。 string.

選擇性。指定應該報告測試回合的組建組態。例如：Debug 或 Release。如果您在建置工作中定義組態的變數，請使用這裡。

publishRunAttachments - 上傳測試結果檔案
boolean. 預設值：true。

選擇性。當這個布爾值是 true時，工作會將所有測試結果檔案上傳為測試回合的附件。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制選項和一般工作屬性。

輸出變數

無。

當執行測試以提供完整的測試報告和分析體驗時，此工作會將測試結果發佈至 Azure Pipelines 或 TFS。您可以使用您選擇的測試執行器，以支援所需的結果格式。支持的結果格式包括 CTest、 JUnit (包括 PHPUnit) 、 NUnit 2、NUnit 3、Visual Studio Test (TRX) 和 xUnit 2。

其他內建工作，例如 Visual Studio 測試工作和 Dot NetCore CLI 工作會自動將測試結果發佈至管線。 Ant、Maven、Gulp、Grunt 和 Xcode 等工作會提供發佈結果做為工作內的選項，或建置 Cobertura 和 JaCoCo 等連結庫。如果您使用上述任何工作，則不需要管線中的個別 發行測試結果 工作。

已發佈的測試結果會顯示在管線摘要的 [ 測試 ] 索引標籤中。結果可協助您測量管線品質、檢閱可追蹤性、疑難解答失敗，以及驅動失敗擁有權。

下列範例顯示工作已設定為發佈測試結果。

開啟測試歷程記錄頁面

您也可以在組建管線中使用這項工作，將執行測試時所產生的程式 代碼涵蓋範圍結果發佈 至 Azure Pipelines 或 TFS，以取得涵蓋範圍報告。

必要條件

如果您使用 Windows 自我載入代理程式，您的電腦必須安裝此必要條件：

.NET Framework 4.6.2 或更新版本

工作預設值

默認選項會使用 JUnit 格式發佈測試結果。使用 VSTest 作為 testRunner 時， testResultsFiles 選項應變更為 **/TEST-*.trx。

testResultsFormat 是 testRunner 輸入名稱的別名。結果檔案可由多個執行器產生，而不只是特定執行器。例如，許多執行器都支援 jUnit 結果格式，而不只是 jUnit。

若要使用 YAML 發佈 Python 的測試結果，請參閱這些主題的生態系統中的 Python 一節，其中也包含其他語言的範例。

結果格式對應

下表列出組建或發行摘要中 [ 測試 ] 索引標籤中報告的欄位，以及與支援測試結果格式之屬性的對應。

範圍	欄位	Visual Studio Test (TRX)
測試執行	標題	在工作中指定的測試回合標題
	開始日期	/TestRun/Times.Attributes[“start”]。價值
	完成日期	/TestRun/Times.Attributes[“finish”]。價值
	持續時間	完成日期 - 開始日期
	附件	請參閱下方的附件支援一節
測試結果	標題	/TestRun/Results/UnitTestResult.Attributes[“testName”]。值或 /TestRun/Results/WebTestResult.Attributes[“testName”]。值或 /TestRun/Results/TestResultAggregation.Attributes[“testName”]。價值
	開始日期	/TestRun/Results/UnitTestResult.Attributes[“startTime”]。值或 /TestRun/Results/WebTestResult.Attributes[“startTime”]。值或 /TestRun/Results/TestResultAggregation.Attributes[“startTime”]。價值
	完成日期	/TestRun/Results/UnitTestResult.Attributes[“startTime”]。Value + /TestRun/Results/UnitTestResult.Attributes[“duration”]。值或 /TestRun/Results/WebTestResult.Attributes[“startTime”]。Value + /TestRun/Results/WebTestResult.Attributes[“duration”]。值或 /TestRun/Results/TestResultAggregation.Attributes[“startTime”]。Value + /TestRun/Results/TestResultAggregation.Attributes[“duration”]。價值
	持續時間	/TestRun/Results/UnitTestResult.Attributes[“duration”]。值或 /TestRun/Results/WebTestResult.Attributes[“duration”]。值或 /TestRun/Results/TestResultAggregation.Attributes[“duration”]。價值
	擁有者	/TestRun/TestDefinitions/UnitTest/Owner/Owner.Attributes[“name”]。價值
	成果	/TestRun/Results/UnitTestResult.Attributes[“result”]。值或 /TestRun/Results/WebTestResult.Attributes[“result”]。值或 /TestRun/Results/TestResultAggregation.Attributes[“result”]。價值
	錯誤訊息	/TestRun/Results/UnitTestResult/Output/ErrorInfo/Message.InnerText 或 /TestRun/Results/WebTestResultOutput/ErrorInfo/Message.InnerText 或 /TestRun/Results/TestResultAggregation/Output/ErrorInfo/Message.InnerText
	堆疊追蹤	/TestRun/Results/UnitTestResult/Output/ErrorInfo/StackTrace.InnerText 或 /TestRun/Results/WebTestResultOutput/ErrorInfo/StackTrace.InnerText 或 /TestRun/Results/TestResultAggregation/Output/ErrorInfo/StackTrace.InnerText
	附件	請參閱下方的附件支援一節
	主控台記錄	/TestRun/Results/UnitTestResult/Output/stdOut.InnerText 或 /TestRun/Results/WebTestResultOutput/Output/StdOut.InnerText 或 /TestRun/Results/TestResultAggregation/Output/stdOut.InnerText
	主控台錯誤記錄檔	/TestRun/Results/UnitTestResult/Output/StdErr.InnerText 或 /TestRun/Results/WebTestResultOutput/Output/StdErr.InnerText 或 /TestRun/Results/TestResultAggregation/Output/StdErr.InnerText
	代理程式名稱	/TestRun/Results/UnitTestResult.Attributes[“computerName”]。值或 /TestRun/Results/WebTestResult.Attributes[“computerName”]。值或 /TestRun/Results/TestResultAggregation.Attributes[“computerName”]。價值
	測試檔案	/TestRun/TestDefinitions/UnitTest.Attributes[“storage”]。價值
	優先順序	/TestRun/TestDefinitions/UnitTest.Attributes[“priority”]。價值

範圍	欄位	Junit
測試執行	標題	在工作中指定的測試回合標題
	開始日期	/testsuites/testsuite。Attributes[“timestamp”]。價值
	完成日期	/testsuites/testsuite。Attributes[“timestamp”]。值 + SUM (/testsuites/testsuite/testcase。Attributes[“time”]。測試套件中所有測試案例的值)
	持續時間	完成日期 - 開始日期
	附件	結果檔案，用來發佈測試結果
測試結果	標題	/testsuites/testsuite/testcase/Attributes[“name”]。價值
	開始日期	/testsuites/testsuite。Attributes[“timestamp”]。價值
	完成日期	/testsuites/testsuite。Attributes[“timestamp”]。值 + /testsuites/testsuite/testcase。Attributes[“time”]。價值
	持續時間	/testsuites/testsuite/testcase/。Attributes[“time”]。價值
	擁有者	/testsuites/testsuite/testcase/Attributes[“owner”]。價值
	成果	失敗：如果存在 /Testsuites/testsuite/testcase/failure 或 /Testsuites/testsuite/testcase/errorNot Executed：如果存在 Testsuites/testsuite/testcase/略過已通過：所有其他案例
	錯誤訊息	/Testsuites/testsuite/testcase/failure。Attributes[“message”]。值或 /Testsuites/testsuite/testcase/error。Attributes[“message”]。值或 /Testsuites/testsuite/testcase/略過。Attributes[“message”]。價值
	堆疊追蹤	/Testsuites/testsuite/testcase/failure。InnerText 或 /Testsuites/testsuite/testcase/error。InnerText
	附件	-
	主控台記錄	/Testsuites/testsuite/testcase/system-out
	主控台錯誤記錄檔	/Testsuites/testsuite/testcase/system-err
	代理程式名稱	/testsuites/testsuite。Attributes[“hostname”]。價值
	測試檔案	/testsuites/testsuite/testcase/Attributes[“classname”]。價值
	優先順序	-

範圍	欄位	NUnit 2
測試執行	標題	在工作中指定的測試回合標題
	開始日期	/test-results。Attributes[“date”]。值 + /test-results。Attributes[“time”]。價值
	完成日期	開始日期 + /test-results/results/test-case。Attributes[“time”]。所有測試案例的值
	持續時間	完成日期 - 開始日期
	附件	用來發佈測試結果的結果檔案
測試結果	標題	/test-results/results/test-case。Attributes[“name”]。價值
	開始日期	/test-results。Attributes[“date”]。值 + /test-results。Attributes[“time”]。價值
	完成日期	開始日期 + /test-results/results/test-case。Attributes[“time”]。價值
	持續時間	/test-results/results/test-case。Attributes[“time”]。價值
	擁有者	針對使用者要求的組建或發行
	成果	失敗：如果存在 /test-results/results/test-case/failureNot Executed：如果存在 /test-results/results/test-case，則為失敗。Attributes[“result”]。Value==“Ignored” Passed：所有其他案例
	錯誤訊息	/test-results/results/test-casefailure/message。InnerText
	堆疊追蹤	/test-results/results/test-case/failure/stack-trace。InnerText
	附件	-
	主控台記錄	/test-results/results/test-case/failure/message。InnerText
	主控台錯誤記錄檔	/test-results/results/test-case/output。InnerText
	代理程式名稱	/test-results/environment。Attributes[“machine-name”]。價值
	測試檔案	/test-results/test-suite。Attributes[“name”]。價值
	優先順序	-

範圍	欄位	NUnit 3
測試執行	標題	在工作中指定的測試回合標題
	開始日期	/test-run/start-time
	完成日期	/test-run/end-time
	持續時間	完成日期 - 開始日期
	附件	請參閱下方的附件支援一節
測試結果	標題	/test-suite[@type='Assembly']/test-case。Attributes[“name”]。價值
	開始日期	/test-suite[@type='Assembly']/test-case。Attributes[“start-time”]。價值
	完成日期	/test-suite[@type='Assembly']/test-case。Attributes[“end-time”]。價值
	持續時間	/test-suite[@type='Assembly']/test-case。Attributes[“duration”]。價值
	擁有者	針對使用者要求的組建或發行
	成果	/test-results/test-suite/results/test-case。Attributes[“result”]。價值
	錯誤訊息	/test-suite[@type='Assembly']/test-case/failure/message
	堆疊追蹤	/test-suite[@type='Assembly']//test-case/failure/stack-trace
	附件	請參閱下方的附件支援一節
	主控台記錄	/test-suite[@type='Assembly']/test-case/failure/output
	主控台錯誤記錄檔	-
	代理程式名稱	/test-suite[@type='Assembly']/environment。Attributes[“machine-name”]。價值
	測試檔案	/test-suite[@type='Assembly']。Attributes[“name”]。價值
	優先順序	-

範圍	欄位	xUnit 2
測試執行	標題	在工作中指定的測試回合標題
	開始日期	/assemblyies/assembly/run-date + /assemblyies/assembly/run-time
	完成日期	開始日期 + /assemblyies/assembly/time
	持續時間	完成日期 - 開始日期
	附件	用來發佈測試結果的結果檔案
測試結果	標題	/assemblyies/assembly/collection/test。Attributes[“method”]。價值
	開始日期	/assemblyies/assembly/run-date + /assemblyies/assembly/run-time
	完成日期	開始日期 + /assemblyies/assembly/collection/test。Attributes[“time”]。價值
	持續時間	/assemblyies/assembly/collection/test。Attributes[“time”]。價值
	擁有者	/assemblyies/assembly/collection/test/traits/trait[@name='owner']。Attributes[“value”]。價值
	成果	/assemblyies/assembly/collection/test/failure。Attributes[“result”]。價值
	錯誤訊息	/assemblyies/assembly/collection/test/failure/message
	堆疊追蹤	/assemblyies/assembly/collection/test/failure/stack-trace
	附件	-
	主控台記錄	/assemblyies/assembly/collection/test/failure/output
	主控台錯誤記錄檔	-
	代理程式名稱	-
	測試檔案	/assemblyies/assembly。Attributes[“name”]。價值
	優先順序	/testcaseNode/traits/trait[@name='priority']。Attributes[“value”]。價值

範圍	欄位	CTest
測試執行	標題	在工作中指定的測試回合標題
	開始日期	/Site/Testing/StartTestTime.InnerText
	完成日期	/Site/Testing/EndTestTime.InnerText
	持續時間	完成日期 - 開始日期
	附件	結果檔案，用來發佈測試結果
測試結果	標題	/Site/Testing/Test/Name.InnerText
	開始日期	/Site/Testing/StartTestTime.InnerText
	完成日期	開始日期 + /Site/Testing/Test/Results/NamedMeasurement[@name= '運行時間']/Value.InnerText
	持續時間	/Site/Testing/Test/Results/NamedMeasurement[@name= '運行時間']/Value.InnerText
	擁有者	針對使用者要求建置或發行
	成果	/Site/Testing/Test.Attributes[“Status”]。價值
	錯誤訊息	-
	堆疊追蹤	/Site/Testing/Test/Results/Measurement/Value.InnerText
	附件	-
	主控台記錄	-
	主控台錯誤記錄檔	-
	代理程式名稱	-
	測試檔案	/Site/Testing/Test/Path.InnerText
	優先順序	-

注意

只有在 [開始日期] 和 [日期完成] 無法使用時，才會使用持續時間。

testName 的完整名稱格式為 Namespace.Testclass.Methodname，字元限制為 512。如果測試是數據驅動且具有參數，字元限制將會包含參數。

發佈測試結果時，您可能會收到此錯誤：無法發佈測試結果：指定的優先順序無效

如果任何測試方法的優先順序設定在 255 以上，請修正程式代碼中的測試方法優先順序，然後再次執行測試，就會發生此錯誤。您可以檢閱產生的 trx 檔案，以查看優先順序大於 255 的所有測試。

附件支援

[發佈測試結果] 工作提供下列格式之測試回合和測試結果附件的支援。針對公用項目，我們支援 2GB 的總附件。

Visual Studio Test (TRX)

範圍	類型	路徑
測試執行	資料收集器	/TestRun/ResultSummary/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes[“href”]。價值
	測試結果	/TestRun/ResultSummary/ResultFiles/ResultFile.Attributes[“path”]。價值
	程式碼涵蓋範圍	/TestRun/TestSettings/Execution/AgentRule/DataCollectors/DataCollector/Configuration/CodeCoverage/Regular/CodeCoverageItem.Attributes[“binaryFile”]。值和 /TestRun/TestSettings/Execution/AgentRule/DataCollectors/DataCollector/Configuration/CodeCoverage/Regular/CodeCoverageItem.Attributes[“pdbFile”]。價值
測試結果	數據收集器	/TestRun/Results/UnitTestResult/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes[“href”]。值或 /TestRun/Results/WebTestResult/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes[“href”]。值或 /TestRun/Results/TestResultAggregation/CollectorDataEntries/Collector/UriAttachments/UriAttachment/A.Attributes[“href”]。價值
	測試結果	/TestRun/Results/UnitTestResult/ResultFiles/ResultFile.Attributes[“path”]。值或 /TestRun/Results/WebTestResult/ResultFiles/ResultFile.Attributes[“path”]。值或 /TestRun/Results/TestResultAggregation/ResultFiles/ResultFile.Attributes[“path”]。價值

範圍	路徑
測試執行	/test-suite/attachments/attachment/filePath
測試執行	/test-suite[@type='Assembly']/test-case/attachments/attachment/filePath

Junit

JUnit 附件支援已新增至 Azure DevOps 短期衝刺 229，且無法在 Azure DevOps Server 2022.1 和更低版本中使用。

範圍	路徑
測試結果	/testsuites/testsuite/testcase/system-out/ -> 內容比對模式 [[ATTACHMENT\|filePath]]

注意

將測試結果檔案上傳為附件的選項是工作的預設選項，適用於所有格式。

範例

Docker

針對 Docker 型應用程式，有許多方式可以建置您的應用程式並執行測試：

在組建管線中建置和測試：建置和測試會在管線中執行，並使用 [發佈測試結果 ] 工作發佈測試結果。
使用多階段 Dockerfile 建置和測試：使用多階段 Docker 檔案在容器內執行組建和測試，例如測試結果不會發佈回管線。
使用 Dockerfile 建置、測試及發佈結果：建置和測試會在容器內執行，並將結果發佈回管線。請參閱下方的範例。

使用 Docker 檔案建置、測試及發佈結果

在此方法中，您會使用 Docker 檔案在容器內建置程式代碼並執行測試。然後，測試結果會複製到要發佈至管線的主機。若要將測試結果發佈至 Azure Pipelines，您可以使用 [發佈測試結果] 工作。最終映像將會發佈至 Docker 或 Azure Container Registry。

取得程式碼

Dockerfile.build使用下列項目目錄的根目錄建立檔案：

# 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

此檔案包含建置程式代碼和執行測試的指示。然後，測試會複製到容器內的檔案 testresults.trx 。

若要讓最終映射盡可能小，只包含運行時間和部署成品，請使用下列專案取代現有的 Dockerfile 內容：

# 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"]

定義組建管線

YAML
傳統

如果您有 Docker Hub 帳戶，而且想要將映像推送至 Docker 登錄，請使用下列內容取代檔案的內容.vsts-ci.docker.yml：

# 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)

或者，如果您設定 Azure Container Registry，並想要將映像推送至該登錄，請使用下列內容取代檔案的內容.vsts-ci.yml：

# 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)

將變更推送至存放庫中的主要分支。
如果您使用 Azure Container Registry，請確定您已在 Azure 入口網站中預先建立登錄。複製 Azure 入口網站中登入設定的 [存取金鑰] 區段中顯示的系統管理員使用者名稱和密碼。
使用下列專案更新您的組建管線
- 代理程式集區： Hosted Ubuntu 1604
  - dockerId：將值設定為 DockerHub 的 Docker 識別符，或 Azure Container Registry 的系統管理員用戶名稱。
  - dockerPassword：將值設定為 DockerHub 的密碼或系統管理員密碼 Azure Container Registry。
- YAML 檔案路徑： /.vsts-ci.docker.yml
將新組建排入佇列，並 watch 建立 Docker 映射推送至您的登錄，並將測試結果推送至 Azure DevOps。

使用 空白作業建立新的組建管線。
在組建管線編輯器的 [工作] 頁面上選取 [管線]，然後編輯其屬性，如下所示
- 代理程式佇列： Hosted Ubuntu 1604

新增 Bash工作，並將其設定如下，以建置成品並將成品複製到主機：

類型：內嵌

文稿：若要建置、測試和複製成品以裝載，請使用下列腳本：

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

新增 發佈測試結果 工作以將結果發佈至管線，並編輯其屬性，如下所示：
- 測試結果格式： VSTest
- 測試結果檔案： **/*.trx

新增 Bash工作以將最終映像發佈至存放庫，並編輯其屬性，如下所示：

類型：Inline

指令碼：

若要推送至 Docker Hub，請使用下列腳本：

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，請使用下列腳本：

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

如果您使用 Azure Container Registry，請確定您已在 Azure 入口網站中預先建立登錄。複製 Azure 入口網站中登錄設定的 [ 存取金鑰 ] 區段中顯示的系統管理員使用者名稱和密碼。
在組建管線的 [ 變數 ] 索引標籤中，定義兩個變數：
- dockerId：將值設定為 DockerHub 的 Docker 識別符，或 Azure Container Registry 的系統管理員用戶名稱。
- dockerPassword：將值設定為 DockerHub 的密碼或系統管理員密碼 Azure Container Registry，並將其標示為安全。
儲存管線並將組建排入佇列。觀看它建立 Docker 映射，並將 Docker 映射推送至您的登錄，並將測試結果推送至 Azure DevOps。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在上執行	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	2.0.0 或更新版本
工作類別	測試

共用方式為