Partager via

ContainerStructureTest@0 - Tâche de test de structure de conteneur v0

Utilise le test de structure de conteneur (https://github.com/GoogleContainerTools/container-structure-test) pour valider la structure d’une image en fonction de quatre catégories de tests : tests de commande, tests d’existence de fichiers, tests de contenu de fichier et tests de métadonnées.

Syntaxe

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

Entrées

dockerRegistryServiceConnection - connexion au service de Registre Docker
string. Obligatoire.

Spécifiez une connexion de service de Registre Docker. Obligatoire pour les commandes qui doivent s’authentifier auprès d’un registre.


repository - référentiel de conteneurs
string. Obligatoire.

Nom du référentiel.


tag - balise
string. Valeur par défaut : $(Build.BuildId).

La balise est utilisée pour extraire l’image de la connexion du service de Registre Docker.


configFile - chemin d’accès au fichier config
string. Obligatoire.

Chemin d’accès au fichier de configuration qui contient des tests de structure de conteneur, dans les formats de fichier .yaml ou .json.


testRunTitle - titre d’exécution de test
string.

Spécifiez un nom pour l’exécution de test.


failTaskOnFailedTests - tâche d’échec s’il existe des échecs de test
boolean. Valeur par défaut : false.

Échec de la tâche s’il existe des échecs de test. Cochez cette option pour échouer la tâche si des échecs de test sont détectés.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Remarques

Cette tâche vous aide à exécuter des tests de structure de conteneur et à publier des résultats de test sur Azure Pipelines et fournit une expérience complète de création de rapports et d’analytique de test.

Remarque

Il s’agit d’une fonctionnalité en préversion anticipée. D’autres fonctionnalités à venir seront déployées dans les sprints à venir.

Les tests de structure de conteneur fournissent une infrastructure puissante pour valider la structure d’une image conteneur. Ces tests peuvent être utilisés pour vérifier la sortie des commandes dans une image, ainsi que pour vérifier les métadonnées et le contenu du système de fichiers. Les tests peuvent être exécutés via un fichier binaire autonome ou via une image Docker.

Les tests de cette infrastructure sont spécifiés via un fichier de configuration YAML ou JSON. Plusieurs fichiers de configuration peuvent être spécifiés dans une seule exécution de test. Le fichier de configuration est chargé par l’exécuteur de test, qui exécute les tests dans l’ordre. Dans ce fichier de configuration, quatre types de tests peuvent être écrits :

  • Tests de commande (test de sortie/erreur d’une commande spécifique émise)
  • Tests d’existence de fichier (s’assurer qu’un fichier est, ou n’est pas, présent dans le système de fichiers de l’image)
  • Tests de contenu de fichier (en veillant à ce que les fichiers du système de fichiers de l’image contiennent ou ne contiennent pas de contenu spécifique)
  • Test de métadonnées, singulier (assurez-vous que certaines métadonnées de conteneur sont correctes)

Générer, tester et publier un test

La tâche de test de structure de conteneur peut être ajoutée dans le pipeline classique, ainsi que dans le pipeline unifié (multi-phase) & pipelines YAML.

Dans le nouveau pipeline unifié BASÉ sur YAML, vous pouvez rechercher une tâche dans la fenêtre.

test de conteneur dans le de pipeline unifié

Une fois la tâche ajoutée, vous devez définir le chemin du fichier de configuration, la connexion de service docker registory, le référentiel de conteneurs et la balise, si nécessaire. L’entrée de tâche dans le pipeline yaml est créée.

test de conteneur dans le de pipeline basé sur YAML

Fichier YAML

fichier YAML 

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

Afficher le rapport de test

Une fois la tâche exécutée, vous pouvez accéder directement à l’onglet test pour afficher le rapport complet. Les résultats des tests publiés sont affichés sous l’onglet Tests dans le résumé du pipeline et vous aident à mesurer la qualité du pipeline, à vérifier la traçabilité, à résoudre les défaillances et à la propriété des défaillances de lecteur.

page de création de rapports de test

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.144.0 ou version ultérieure
Catégorie de tâche Essai
Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.0.0 ou version ultérieure
Catégorie de tâche Essai
  • Last updated on