ContainerStructureTest@0 - コンテナー構造テスト v0 タスク

[アーティクル]
07/02/2024

container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) を使用して、コマンドテスト、ファイル存在テスト、ファイルコンテンツテスト、メタデータテストの 4 つのカテゴリに基づいてイメージの構造を検証します。

構文

# 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 構成ファイルを使用して指定されます。 1 回のテスト実行で複数の構成ファイルを指定できます。構成ファイルはテストランナーによって読み込まれ、テストが順番に実行されます。この構成ファイル内では、次の 4 種類のテストを記述できます。

コマンドテスト (発行された特定のコマンドの出力/エラーのテスト)
ファイルの存在テスト (ファイルがイメージのファイルシステムに存在するか、存在しないことを確認する)
ファイルコンテンツテスト (イメージのファイルシステム内のファイルに特定のコンテンツが含まれているか、含まれていないか確認する)
メタデータテスト、単数形 (特定のコンテナーメタデータが正しいことを確認する)

テストのビルド、テスト、発行

コンテナー構造テストタスクは、クラシックパイプラインと、YAML ベースのパイプライン & 統合パイプライン (マルチステージ) に追加できます。

YAML
クラシック

新しい YAML ベースの統合パイプラインでは、ウィンドウでタスクを検索できます。

統合パイプラインでのコンテナーテスト

タスクが追加されたら、必要に応じて、構成ファイルパス、docker registory サービス接続、コンテナーリポジトリ、タグを設定する必要があります。 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、クラシックビルド、クラシックリリース
上で実行	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	2.144.0 以降
タスクのカテゴリ	テスト

要件	説明
パイプラインの種類	YAML、クラシックビルド、クラシックリリース
上で実行	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	2.0.0 以上
タスクのカテゴリ	テスト

次の方法で共有

ContainerStructureTest@0 - コンテナー構造テスト v0 タスク

構文