共用方式為

ContainerStructureTest@0 - 容器結構測試 v0 工作

  • 發行項

使用 container-structure-test （https://github.com/GoogleContainerTools/container-structure-test）根據四種測試類別來驗證影像的結構-命令測試、檔案存在測試、檔案內容測試和元數據測試。

語法

# Container Structure Test v0
# Uses container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) to validate the structure of an image based on four categories of tests - command tests, file existence tests, file content tests and metadata tests.
- task: ContainerStructureTest@0
  inputs:
  # Container Repository
    dockerRegistryServiceConnection: # string. Required. Docker registry service connection. 
    repository: # string. Required. Container repository. 
    #tag: '$(Build.BuildId)' # string. Tag. Default: $(Build.BuildId).
    configFile: # string. Required. Config file path. 
    #testRunTitle: # string. Test run title. 
    #failTaskOnFailedTests: false # boolean. Fail task if there are test failures. Default: false.

輸入

dockerRegistryServiceConnection - Docker 登錄服務連線
string。 必須的。

指定 Docker 登錄服務連線。 需要用於需要向登錄進行驗證的命令。


repository - 容器存放庫
string。 必須的。

存放庫的名稱。


tag - 標籤
string。 預設值：$(Build.BuildId)。

標記用於從 Docker 登錄服務連線提取映像。


configFile - 設定檔路徑
string。 必須的。

包含容器結構測試的組態檔路徑，可以是 .yaml 或 .json 檔案格式。


testRunTitle - 測試回合標題
string。

指定測試回合的名稱。


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

如果有任何測試失敗，工作就會失敗。 如果偵測到測試失敗，請檢查此選項以讓工作失敗。


工作控制選項

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

輸出變數

沒有。

備註

這項工作可協助您執行容器結構測試，並將測試結果發佈至 Azure Pipelines，並提供完整的測試報告和分析體驗。

備註

這是早期預覽功能。 即將推出的功能將會在即將推出的短期衝刺中推出。

容器結構測試提供強大的架構來驗證容器映像的結構。 這些測試可用來檢查映像中命令的輸出，以及驗證檔案系統的元數據和內容。 測試可以透過獨立二進位檔或 Docker 映像來執行。

此架構內的測試是透過YAML或 JSON 組態檔來指定。 單一測試回合中可以指定多個組態檔。 測試執行器會載入組態檔，以順序執行測試。 在這裡組態檔中，可以撰寫四種類型的測試：

  • 命令測試 （測試發出之特定命令的輸出/錯誤）
  • 檔案存在測試（確定檔案在映像的檔案系統中存在或不存在）
  • 檔案內容測試（確定映像檔案系統中的檔案包含或不包含特定內容）
  • 元數據測試，單數（確定特定容器元數據正確）

建置、測試和發佈測試

容器結構測試工作可以新增至傳統管線，以及統一管線（多階段）& YAML 型管線中。

在新的 YAML 型整合管線中，您可以在視窗中搜尋工作。

在整合管線中 容器測試

新增工作之後，您必須視需要設定組態檔路徑、docker registory 服務連線、容器存放庫和標記。 會建立 yaml 型管線中的工作輸入。

在 YAML 型管線中 容器測試

YAML 檔案

YAML 檔案 

steps:
- task: ContainerStructureTest@0
  displayName: 'Container Structure Test '
  inputs:
    dockerRegistryServiceConnection: 'Container_dockerHub'
    repository: adma/hellodocker
    tag: v1
    configFile: /home/user/cstfiles/fileexisttest.yaml

檢視測試報告

執行工作之後，您可以直接移至 [測試] 索引標籤來檢視完整報表。 已發佈的測試結果會顯示在管線摘要中的 [測試] 索引標籤中，並協助您測量管線品質、檢閱可追蹤性、疑難解答失敗，以及驅動失敗擁有權。

測試報告頁面

需求

要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 2.144.0 或更新
工作類別 測試
要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 2.0.0 或更新
工作類別 測試