ContainerStructureTest@0 – Container Structure Test v0-uppgift

Använder container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) för att verifiera strukturen för en bild 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.

Ingångar

dockerRegistryServiceConnection - Docker-registertjänstanslutning
string. Obligatoriskt.

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

repository - containerlagringsplats
string. Obligatoriskt.

Namnet på lagringsplatsen.

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

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

configFile - konfigurationsfilsökväg
string. Obligatoriskt.

Den konfigurationsfilsökväg som innehåller containerstrukturtester, antingen i .yaml- eller .json filformat.

testRunTitle - Testkörningstitel
string.

Ange ett namn för testkörningen.

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

Uppgiften misslyckas om det finns några testfel. Kontrollera det här alternativet för att 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

Ingen.

Anmärkningar

Den här uppgiften hjälper dig att köra containerstrukturtester och publicera testresultat till Azure Pipelines och ger en omfattande testrapportering och analysupplevelse.

Anmärkning

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 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 (se till att en fil finns eller inte finns i avbildningens filsystem)
• Filinnehållstester (se till att filer i filsystemet i 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 aktiviteter 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årningsbarhet, felsöka fel och ägarskap för enhetsfel.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.144.0 eller senare
Aktivitetskategori	Test