Dela via


JenkinsDownloadArtifacts@1 – Jenkins laddar ned artefakter v1-uppgift

Använd den här uppgiften för att ladda ned artefakter som skapats av ett Jenkins-jobb.

Syntax

# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.

Ingångar

jenkinsServerConnection - Jenkins-tjänstanslutning
Indataalias: serverEndpoint. string. Obligatoriskt.

Anger tjänstanslutningen för Jenkins-instansen. Om du vill skapa en ny tjänstanslutning klickar du på länken Hantera.


jobName - jobbnamn
string. Obligatoriskt.

Anger namnet på Jenkins-jobbet som artefakter ska laddas ned från. Detta måste exakt matcha jobbnamnet på Jenkins-servern.


jenkinsJobType - Jenkins-jobbtyp
string. Valfritt. Använd när jobName = invalidjobName.

Anger automatiskt Jenkins-jobbtypen.


saveTo - Spara i
string. Obligatoriskt. Standardvärde: jenkinsArtifacts.

Anger katalogen där Jenkins-artefakter laddas ned och sparas. Den här katalogen skapas om den inte finns.


jenkinsBuild - Ladda ned artefakter som skapats av
string. Obligatoriskt. Tillåtna värden: LastSuccessfulBuild (senaste lyckade version), BuildNumber (versionsnummer). Standardvärde: LastSuccessfulBuild.

Laddar ned artefakter som skapats av den senaste lyckade versionen eller från en specifik bygginstans.


jenkinsBuildNumber - Jenkins-versionsnummer
string. Krävs när jenkinsBuild == BuildNumber. Standardvärde: 1.

Laddar ned artefakter som skapats av den här versionen.


itemPattern - objektmönster
string. Standardvärde: **.

Anger de filer som ska laddas ned som ett minimatchningsmönster med flera rader. Mer information om filmatchningsmönster.

Standardmönstret ** hämtar alla filer över alla artefakter som skapats av Jenkins-jobbet. Om du vill ladda ned alla filer i artefaktdroppen använder du drop/**.


downloadCommitsAndWorkItems - Ladda ned incheckningar och WorkItems-
boolean. Standardvärde: false.

Aktiverar nedladdning av incheckningar och arbetsobjektsinformation som är associerad med Jenkins-jobbet.


startJenkinsBuildNumber - Ladda ned incheckningar och arbetsobjekt från
string. Valfritt. Använd när downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber.

Startar versionsnumret för att ladda ned incheckningar och arbetsobjekt. Om det tillhandahålls hämtas alla incheckningar och arbetsobjekt mellan start build-numret och versionsnumret som anges som indata för att ladda ned artefakter.


artifactDetailsFileNameSuffix - Commit och WorkItem FileName
string. Valfritt. Använd när downloadCommitsAndWorkItems == invalid.

Anger filnamnssuffixet för incheckningar och bifogade filer för arbetsobjekt. Bifogade filer skapas med commits_{suffix}.json och workitem_{suffix}.json. Om den här indata inte anges skapas bifogade filer med namnen commits.json och workitems.json.


propagatedArtifacts - artefakter sprids till Azure
boolean. Standardvärde: false.

Använd dessa indata om Jenkins-artefakter har spridits till Azure. Om du vill ladda upp Jenkins-artefakter till Azure läser du det här Jenkins-plugin-programmet.


artifactProvider - Artefaktprovider
string. Krävs när propagatedArtifacts == notValid. Tillåtna värden: azureStorage (Azure Storage). Standardvärde: azureStorage.

Anger den externa lagringsprovider som används i Jenkins-jobbet för att ladda upp artefakterna.


ConnectedServiceNameARM - Azure-prenumeration
string. Krävs när propagatedArtifacts == true.

Anger Azure Resource Manager-prenumerationen för artefakterna.


storageAccountName - lagringskontonamn
string. Krävs när propagatedArtifacts == true.

Anger Azure Classic- eller Resource Manager-lagringskonton. Välj namnet på lagringskontot där artefakterna sprids.


containerName - containernamn
string. Krävs när propagatedArtifacts == true.

Anger namnet på containern i lagringskontot där artefakter laddas upp.


commonVirtualPath - common virtual path
string. Valfritt. Använd när propagatedArtifacts == true.

Anger sökvägen till artefakterna i Azure Storage-containern.


Kontrollalternativ för aktivitet

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

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att ladda ned artefakter som skapats av ett Jenkins-jobb.

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 Nytta
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 Alla agentversioner som stöds.
Aktivitetskategori Nytta