ContainerStructureTest@0: tarea Prueba de estructura de contenedor v0

Usa container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) para validar la estructura de una imagen basada en cuatro categorías de pruebas: pruebas de comandos, pruebas de existencia de archivos, pruebas de contenido de archivos y pruebas de metadatos.

Syntax

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

Entradas

dockerRegistryServiceConnection - Conexión del servicio del registro de Docker
string. Obligatorio.

Especifique una conexión de servicio del registro de Docker. Obligatorio para los comandos que necesitan autenticarse con un registro.

repository - Repositorio de contenedores
string. Obligatorio.

El nombre del repositorio.

tag - Etiqueta
string. Valor predeterminado: $(Build.BuildId).

La etiqueta se usa para extraer la imagen de la conexión del servicio del registro de Docker.

configFile - Ruta de acceso del archivo de configuración
string. Obligatorio.

Ruta de acceso del archivo de configuración que contiene pruebas de estructura de contenedor, ya sea en formatos de archivo .yaml o .json.

testRunTitle - Título de la ejecución de pruebas
string.

Especifique un nombre para la ejecución de pruebas.

failTaskOnFailedTests - Error en la tarea si hay errores de prueba
boolean. Valor predeterminado: false.

Se produce un error en la tarea si hay errores de prueba. Active esta opción para producir un error en la tarea si se detectan errores de prueba.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Esta tarea le ayuda a ejecutar pruebas de estructura de contenedor y a publicar los resultados de las pruebas en Azure Pipelines, y proporciona una experiencia completa de informes y análisis de pruebas.

Nota:

Se trata de una característica de versión preliminar temprana. En los próximos sprints se implementarán más características.

Las pruebas de estructura de contenedor proporcionan un marco eficaz para validar la estructura de una imagen de contenedor. Estas pruebas se pueden usar para comprobar la salida de comandos en una imagen, así como para comprobar los metadatos y el contenido del sistema de archivos. Las pruebas se pueden ejecutar a través de un binario independiente o a través de una imagen de Docker.

Las pruebas de este marco se especifican a través de un archivo de configuración YAML o JSON. Se pueden especificar varios archivos de configuración en una sola ejecución de prueba. El ejecutor de pruebas cargará el archivo de configuración, que ejecutará las pruebas en orden. Dentro de este archivo de configuración, se pueden escribir cuatro tipos de pruebas:

• Pruebas de comandos (pruebas de salida o error de un comando específico emitido)
• Pruebas de existencia de archivos (para asegurarse de que un archivo está, o no, presente en el sistema de archivos de la imagen)
• Pruebas de contenido de archivos (para asegurarse de que los archivos del sistema de archivos de la imagen contienen, o no, contenido específico)
• Prueba de metadatos, singular (para asegurarse de que determinados metadatos de contenedor son correctos)

Compilación, prueba y publicación de pruebas

La tarea de prueba de estructura de contenedor se puede agregar en la canalización clásica, así como en canalizaciones unificadas (varias fases) & canalizaciones basadas en YAML.

YAML

En la nueva canalización unificada basada en YAML, puede buscar la tarea en la ventana.

Una vez agregada la tarea, debe establecer el trazado del archivo de configuración, la conexión del servicio de registro de Docker, el repositorio de contenedor y la etiqueta, si es necesario. Se crea la entrada de tarea en la canalización basada en YAML.

Archivo YAML

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

Clásico

En la canalización clásica, puede agregar esta tarea desde la vista del diseñador.

Visualización del informe de prueba

Una vez ejecutada la tarea, puede ir directamente a la pestaña Prueba para ver el informe completo. Los resultados de las pruebas publicados se muestran en la pestaña Pruebas del resumen de la canalización y ayudan a medir la calidad de la canalización, revisar la trazabilidad, solucionar errores y controlar la propiedad de los errores.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	2.144.0 o superior
Categoría de la tarea:	Prueba