ContainerStructureTest@0 – Tarefa teste de estrutura de contêiner v0

Usa container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) para validar a estrutura de uma imagem com base em quatro categorias de testes - testes de comando, testes de existência de arquivo, testes de conteúdo de arquivo e testes de metadados.

Sintaxe

# 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

de conexão do serviço de registro do Docker dockerRegistryServiceConnection -
string. Obrigatório

Especifique uma conexão de serviço do Registro do Docker. Necessário para comandos que precisam ser autenticados com um registro.

repository - de repositório de contêineres
string. Obrigatório

O nome do repositório.

tag -
string. Valor padrão: $(Build.BuildId).

A marca é usada para extrair a imagem da conexão de serviço do Registro do Docker.

de caminho do arquivo de configuração configFile -
string. Obrigatório

O caminho do arquivo de configuração que contém testes de estrutura de contêiner, em formatos de arquivo .yaml ou .json.

testRunTitle - Test run title
string.

Especifique um nome para a Execução de Teste.

tarefa failTaskOnFailedTests - Fail se houver falhas de teste
boolean. Valor padrão: false.

Falha na tarefa se houver falhas de teste. Verifique esta opção para falhar na tarefa se forem detectadas falhas de teste.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Essa tarefa ajuda você a executar testes de estrutura de contêineres e publicar resultados de teste no Azure Pipelines e fornece uma experiência abrangente de análise e relatórios de teste.

Observação

Este é um recurso de visualização antecipada. Mais recursos futuros serão lançados nos próximos sprints.

Os Testes de Estrutura de Contêiner fornecem uma estrutura poderosa para validar a estrutura de uma imagem de contêiner. Esses testes podem ser usados para verificar a saída de comandos em uma imagem, bem como verificar metadados e conteúdo do sistema de arquivos. Os testes podem ser executados por meio de um binário autônomo ou por meio de uma imagem do Docker.

Os testes nessa estrutura são especificados por meio de um arquivo de configuração YAML ou JSON. Vários arquivos de configuração podem ser especificados em uma única execução de teste. O arquivo de configuração será carregado pelo executor de teste, que executará os testes em ordem. Nesse arquivo de configuração, quatro tipos de testes podem ser gravados:

• Testes de comando (testando saída/erro de um comando específico emitido)
• Testes de existência de arquivo (certificando-se de que um arquivo esteja ou não está presente no sistema de arquivos da imagem)
• Testes de conteúdo de arquivo (certificando-se de que os arquivos no sistema de arquivos da imagem contêm ou não contêm conteúdo específico)
• Teste de metadados, singular (certificando-se de que certos metadados de contêiner estão corretos)

Compilar, testar e publicar teste

A tarefa de teste de estrutura de contêiner pode ser adicionada no pipeline clássico, bem como em pipeline unificado (multi-estágio) & pipelines baseados em YAML.

YAML

No novo pipeline unificado baseado em YAML, você pode pesquisar a tarefa na janela.

Teste de contêiner de Pipeline Unificado

Depois que a tarefa for adicionada, você precisará definir o caminho do arquivo de configuração, a conexão de serviço do registório do Docker, o repositório de contêineres e a marca, se necessário. A entrada da tarefa no pipeline baseado em yaml é criada.

teste de contêiner

Arquivo 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ássico

No pipeline clássico, você pode adicionar essa tarefa no modo de exibição do designer.

Teste de contêiner de Pipeline Clássico

Exibir relatório de teste

Depois que a tarefa for executada, você poderá acessar diretamente a guia de teste para exibir o relatório completo. Os resultados do teste publicado são exibidos na guia Testes no resumo do pipeline e ajudam você a medir a qualidade do pipeline, examinar a rastreabilidade, solucionar problemas de falhas e a propriedade da falha de unidade.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.144.0 ou superior
Categoria de tarefa	Teste