Publicera och ladda ned pipelineartefakter

Azure DevOps Services

Med Hjälp av Azure Pipelines kan du ladda ned artefakter från tidigare steg i din pipeline eller från en annan pipeline. Du kan också publicera artefakten till en filresurs eller göra den tillgänglig som en pipelineartefakt.

Publicera artefakter

Du kan publicera dina artefakter med hjälp av YAML, den klassiska redigeraren eller Azure CLI:

steps:
- publish: $(System.DefaultWorkingDirectory)/bin/WebApp
  artifact: WebApp

steps:
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: $(System.DefaultWorkingDirectory)/bin/WebApp
    artifactName: WebApp

Även om artefaktens namn är valfritt är det en bra idé att ange ett namn som korrekt återspeglar innehållet i artefakten. Om du planerar att använda artefakten från ett jobb som körs på ett annat operativsystem måste du se till att alla filsökvägar är giltiga för målmiljön. Till exempel ett filnamn som innehåller tecknet \ eller * som inte kan laddas ned i Windows.

Sökvägen till den fil/mapp som du vill publicera krävs. Detta kan vara en absolut eller relativ sökväg till $(System.DefaultWorkingDirectory).

Paket i Azure Artifacts är oföränderliga. När du publicerar ett paket är dess version permanent reserverad. Det går inte att köra misslyckade jobb igen om paketet har publicerats. Ett bra sätt att närma dig detta om du vill kunna köra misslyckade jobb igen utan att det redan finns ett felpaket är att använda Villkor för att endast köra om det tidigare jobbet lyckades.

  jobs:
  - job: Job1
    steps:
      - script: echo Hello Job1!

  - job: Job2
    steps:
      - script: echo Hello Job2!
    dependsOn: Job1

Använda .artifactignore

.artifactignore använder en liknande syntax som .gitignore (med få begränsningar) för att ange vilka filer som ska ignoreras när artefakter publiceras. Kontrollera att .artifactignore-filen finns i katalogen som anges av targetPath-argumentet för aktiviteten Publicera pipelineartefakter.

Exempel: ignorera alla filer utom .exe filer:

**/*
!*.exe

Ladda ned artefakter

Du kan ladda ned artefakter med hjälp av YAML, den klassiska redigeraren eller Azure CLI.

steps:
- download: current
  artifact: WebApp

steps:
- task: DownloadPipelineArtifact@2
  inputs:
    artifact: WebApp

Om du vill ladda ned en pipelineartefakt från ett annat projekt i din organisation kontrollerar du att du har rätt behörigheter konfigurerade för både nedströmsprojektet och pipelinen som genererar artefakten. Som standard laddas filer ned till $(Pipeline.Workspace). Om ett artefaktnamn inte har angetts skapas en underkatalog för varje nedladdad artefakt. Du kan använda matchande mönster för att begränsa vilka filer som laddas ned. Mer information finns i Filmatchningsmönster .

steps:
- download: current
  artifact: WebApp
  patterns: |
    **/*.js
    **/*.zip

Markering av artefakter

Ett enda nedladdningssteg kan ladda ned en eller flera artefakter. Om du vill ladda ned flera artefakter lämnar du fältet artefaktnamn tomt och använder filmatchningsmönster för att begränsa vilka filer som ska laddas ned. ** är standardmönstret för filmatchning (alla filer i alla artefakter).

Enskild artefakt

När ett artefaktnamn anges:

1. Endast filer för den specifika artefakten laddas ned. Om artefakten inte finns misslyckas uppgiften.

2. Filmatchningsmönster utvärderas i förhållande till artefaktens rot. Mönstret *.jar matchar till exempel alla filer med ett .jar tillägg i artefaktens rot.

I följande exempel visas hur du laddar ned allt *.js från en artefakt WebApp:

steps:
- download: current
  artifact: WebApp
  patterns: '**/*.js'

steps:
- task: DownloadPipelineArtifact@2
  inputs:
    artifact: WebApp
    patterns: '**/*.js'
    path: $(Build.SourcesDirectory)/bin

Flera artefakter

När inget artefaktnamn har angetts:

1. Flera artefakter kan laddas ned och uppgiften misslyckas inte om inga filer hittas.

2. En underkatalog skapas för varje artefakt.

3. Filmatchningsmönster bör förutsätta att det första segmentet i mönstret är (eller matchar) ett artefaktnamn. Matchar till exempel WebApp/** alla filer från WebApp artefakten. Mönstret */*.dll matchar alla filer med ett .dll tillägg i roten för varje artefakt.

I följande exempel visas hur du laddar ned alla .zip filer från alla artefakter:

steps:
- download: current
  patterns: '**/*.zip'

steps:
- task: DownloadPipelineArtifact@2
  inputs:
    patterns: '**/*.zip'

Ladda ned en specifik artefakt

I följande exempel visas hur du laddar ned pipelineartefakter från en specifik version som skapats av en viss körning:

resources:
  pipelines:
  - pipeline: myPipeline
    project: 'xxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx'
    source: '79'
    version: '597'

steps:
- download: myPipeline
  artifact: drop
  patterns: '**'
  displayName: 'Download Pipeline Artifact'

steps:
- task: DownloadPipelineArtifact@2
  displayName: 'Download Pipeline Artifact'
  inputs:
    buildType: specific
    project: 'xxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx'
    definition: 79
    buildVersionToDownload: specific
    pipelineId: 597
    artifactName: drop

Artefakter i versions- och distributionsjobb

Artefakter laddas bara ned automatiskt i distributionsjobb. Som standard laddas artefakter ned till $(Pipeline.Workspace). Nedladdningsartefaktuppgiften matas bara in automatiskt när du använder deploy livscykelkroken i distributionen. Om du vill förhindra att artefakter laddas ned automatiskt lägger du till ett download steg och anger dess värde till inget. I ett vanligt byggjobb måste du uttryckligen download använda stegets nyckelord eller uppgiften Ladda ned pipelineartefakt. Se livscykelkrokar för att lära dig mer om de andra typerna av krokar.

steps:
- download: none

Använda artefakter i olika faser

Om du vill kunna komma åt artefakten i olika steg i pipelinen kan du nu publicera artefakten i ett steg och sedan ladda ned den i nästa steg med hjälp av beroenden. Mer information finns i Steg-till-steg-beroenden.

Exempel

I följande exempel kopierar och publicerar vi en skriptmapp från lagringsplatsen till $(Build.ArtifactStagingDirectory). I den andra fasen laddar vi ned och kör skriptet.

trigger:
- main
stages:
- stage: build
  jobs:
  - job: run_build
    pool:
      vmImage: 'windows-latest'
    steps:
    - task: VSBuild@1
      inputs:
        solution: '**/*.sln'
        msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:DesktopBuildPackageLocation="$(build.artifactStagingDirectory)\WebApp.zip" /p:DeployIisAppPath="Default Web Site"'
        platform: 'Any CPU'
        configuration: 'Release'

    - task: CopyFiles@2
      displayName: 'Copy scripts'
      inputs:
        contents: 'scripts/**'
        targetFolder: '$(Build.ArtifactStagingDirectory)'

    - publish: '$(Build.ArtifactStagingDirectory)/scripts'
      displayName: 'Publish script'
      artifact: drop

- stage: test
  dependsOn: build
  jobs:
  - job: run_test
    pool:
      vmImage: 'windows-latest'
    steps:
    - download: current
      artifact: drop
    - task: PowerShell@2
      inputs:
        filePath: '$(Pipeline.Workspace)\drop\test.ps1'

Migrera från byggartefakter

Pipelineartefakter är nästa generations byggartefakter och är det rekommenderade sättet att arbeta med artefakter. Artefakter som publicerats med uppgiften Publicera byggartefakter kan fortfarande laddas ned med hjälp av Ladda ned byggartefakter, men vi rekommenderar att du använder den senaste åtgärden Ladda ned pipelineartefakt i stället.

När du migrerar från byggartefakter till pipelineartefakter:

1. Som standard laddar aktiviteten Ladda ned pipelineartefakt ned filer till $(Pipeline.Workspace). Det här är standardsökvägen och den rekommenderade sökvägen för alla typer av artefakter.

2. Filmatchningsmönster för aktiviteten Hämta byggartefakter förväntas börja med (eller matcha) artefaktnamnet, oavsett om en specifik artefakt har angetts eller inte. I aktiviteten Ladda ned pipelineartefakt bör mönster inte innehålla artefaktnamnet när ett artefaktnamn redan har angetts. Mer information finns i enkel artefaktval.

Exempel

- task: PublishPipelineArtifact@1
  displayName: 'Publish pipeline artifact'
  inputs:
    targetPath: '$(Pipeline.Workspace)'
    ${{ if eq(variables['Build.SourceBranchName'], 'main') }}:
        artifact: 'prod'
    ${{ else }}:
        artifact: 'dev'
    publishLocation: 'pipeline'

• targetPath: (Krävs) Sökvägen till filen eller katalogen som ska publiceras. Kan vara absolut eller i förhållande till standardarbetskatalogen. Kan innehålla variabler, men jokertecken stöds inte. Standard: $(Pipeline.Workspace).

• publishLocation: (Krävs) Artefakter publicerar plats. Välj om artefakten ska lagras i Azure Pipelines eller kopiera den till en filresurs som måste vara tillgänglig från pipelineagenten. Alternativ: pipeline, filepath. Standard: pipeline.

• artefakt: (valfritt) Namnet på artefakten som ska publiceras. Om det inte anges är standardvärdet ett unikt ID som är begränsat till jobbet.

Visa publicerade artefakter

När pipelinekörningen är klar följer du de här stegen för att visa eller ladda ned den publicerade artefakten:

1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

2. Välj Pipelines, välj pipelinekörningen och välj sedan fliken Sammanfattning .

3. I det relaterade avsnittet väljer du den publicerade artefakten.

   

4. Expandera mappen drop för att hitta artefakten. Du kan sedan ladda ned artefakten och utforska dess innehåll.

   

Vanliga frågor

F: Vad är byggartefakter?

S: Skapa artefakter är de filer som genereras av din version. Mer information om hur du publicerar och använder byggartefakter finns i Skapa artefakter .

F: Kan jag ta bort pipelineartefakter när misslyckade jobb körs igen?

S: Pipelineartefakter är inte borttagningsbara eller överskrivningsbara. Om du vill återskapa artefakter när du kör ett misslyckat jobb igen kan du inkludera jobb-ID:t i artefaktnamnet. $(system.JobId) är lämplig variabel för detta ändamål. Mer information om fördefinierade variabler finns i Systemvariabler .

F: Hur kan jag komma åt artefakter feeds bakom en brandvägg?

S: Om din organisation använder en brandvägg eller en proxyserver ser du till att du tillåter URL:er och IP-adresser för Azure Artifacts-domäner.

Relaterade artiklar

• Skapa artefakter
• Versioner i Azure Pipelines
• Versionsartefakter och artefaktkällor
• Så här minskar du risken när du använder privata paketfeeds