ContainerStructureTest@0 – Container Structure Test v0-uppgift

Använder containerstrukturtest (https://github.com/GoogleContainerTools/container-structure-test) för att verifiera strukturen för en avbildning baserat på fyra kategorier av tester – kommandotester, filexistenstester, filinnehållstester och metadatatester.

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.

Indata

dockerRegistryServiceConnection - Docker-registertjänstanslutning
string. Krävs.

Ange en Docker-registertjänstanslutning. Krävs för kommandon som behöver autentiseras med ett register.

repository - Containerlagringsplats
string. Krävs.

Lagringsplatsens namn.

tag - Etiketten
string. Standardvärde: $(Build.BuildId).

Taggen används för att hämta avbildningen från docker-registertjänstanslutningen.

configFile - Konfigurationsfilsökväg
string. Krävs.

Konfigurationsfilens sökväg som innehåller tester av containerstruktur, antingen i filformaten .yaml eller .json.

testRunTitle - Testkörningsrubrik
string.

Ange ett namn för testkörningen.

failTaskOnFailedTests - Misslyckad uppgift om det finns testfel
boolean. Standardvärde: false.

Uppgiften misslyckas om det uppstår testfel. Kontrollera det här alternativet om du vill misslyckas med uppgiften om testfel identifieras.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Den här uppgiften hjälper dig att köra tester av containerstrukturen och publicera testresultat till Azure Pipelines och ger en omfattande testrapporterings- och analysupplevelse.

Anteckning

Det här är en funktion för tidig förhandsversion. Fler kommande funktioner kommer att lanseras i kommande sprintar.

Containerstrukturtesterna tillhandahåller ett kraftfullt ramverk för att verifiera strukturen för en containeravbildning. Dessa tester kan användas för att kontrollera utdata från kommandon i en bild, samt för att verifiera metadata och innehåll i filsystemet. Tester kan köras antingen via en fristående binärfil eller via en Docker-avbildning.

Tester inom det här ramverket anges via en YAML- eller JSON-konfigurationsfil. Flera konfigurationsfiler kan anges i en enda testkörning. Konfigurationsfilen läses in av testköraren, som kör testerna i ordning. I den här konfigurationsfilen kan fyra typer av tester skrivas:

• Kommandotester (testa utdata/fel för ett specifikt kommando som utfärdats)
• Filexistenstester (kontrollera att en fil finns eller inte finns i avbildningens filsystem)
• Filinnehållstester (se till att filer i filsystemet för avbildningen innehåller, eller inte innehåller, specifikt innehåll)
• Metadatatest, singular (se till att vissa containermetadata är korrekta)

Skapa, testa och publicera test

Testuppgiften för containerstruktur kan läggas till i den klassiska pipelinen samt i enhetlig pipeline (flera steg) & YAML-baserade pipelines.

YAML

I den nya YAML-baserade enhetliga pipelinen kan du söka efter uppgift i fönstret.

När uppgiften har lagts till måste du ange konfigurationsfilsökvägen, docker registory-tjänstanslutningen, containerlagringsplatsen och taggen om det behövs. Uppgiftsindata i den yaml-baserade pipelinen skapas.

YAML-fil

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

Klassisk

I den klassiska pipelinen kan du lägga till den här uppgiften från designervyn.

Visa testrapport

När uppgiften har körts kan du gå direkt till testfliken för att visa den fullständiga rapporten. De publicerade testresultaten visas på fliken Tester i pipelinesammanfattningen och hjälper dig att mäta pipelinekvalitet, granska spårbarhet, felsöka fel och driva ägarskap för fel.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.144.0 eller senare
Uppgiftskategori	Test