JenkinsDownloadArtifacts@1 – Jenkins-Aufgabe zum Herunterladen von Artefakten v1

Verwenden Sie diese Aufgabe, um Artefakte herunterzuladen, die von einem Jenkins-Auftrag erstellt wurden.

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.

Eingaben

jenkinsServerConnection - Jenkins-Dienstverbindung
Eingabealias: serverEndpoint. string. Erforderlich.

Gibt die Dienstverbindung für Ihre Jenkins-instance an. Um eine neue Dienstverbindung zu erstellen, klicken Sie auf den Link Verwalten.

jobName - Auftragsname
string. Erforderlich.

Gibt den Namen des Jenkins-Auftrags an, aus dem Artefakte heruntergeladen werden sollen. Dieser muss genau mit dem Auftragsnamen auf dem Jenkins-Server übereinstimmen.

jenkinsJobType - Jenkins-Auftragstyp
string. Optional. Verwenden Sie , wenn jobName = invalidjobName.

Gibt automatisch den Jenkins-Auftragstyp an.

saveTo - Speichern in
string. Erforderlich. Standardwert. jenkinsArtifacts.

Gibt das Verzeichnis an, in dem Jenkins-Artefakte heruntergeladen und gespeichert werden. Dieses Verzeichnis wird erstellt, wenn es nicht vorhanden ist.

jenkinsBuild - Herunterladen von Artefakten, die von erstellt wurden
string. Erforderlich. Zulässige Werte: LastSuccessfulBuild (Letzter erfolgreicher Build), BuildNumber (Buildnummer). Standardwert. LastSuccessfulBuild.

Lädt Artefakte herunter, die vom letzten erfolgreichen Build oder aus einem bestimmten Build instance erstellt wurden.

jenkinsBuildNumber - Jenkins Buildnummer
string. Erforderlich, wenn jenkinsBuild == BuildNumber. Standardwert. 1.

Lädt Artefakte herunter, die von diesem Build erstellt wurden.

itemPattern - Elementmuster
string. Standardwert. **.

Gibt die Dateien an, die als mehrzeiliges Minimatchmuster heruntergeladen werden sollen. Weitere Informationen zu Dateiabgleichsmustern.

Das Standardmuster ** lädt alle Dateien für alle Artefakte herunter, die vom Jenkins-Auftrag erstellt wurden. Verwenden drop/**Sie zum Herunterladen aller Dateien innerhalb des Artefakt-Drops .

downloadCommitsAndWorkItems - Herunterladen von Commits und WorkItems
boolean. Standardwert. false.

Ermöglicht das Herunterladen der Commits und Arbeitselementdetails, die dem Jenkins-Auftrag zugeordnet sind.

startJenkinsBuildNumber - Herunterladen von Commits und Arbeitselementen aus
string. Optional. Verwenden Sie , wenn downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber.

Startet die Buildnummer zum Herunterladen von Commits und Arbeitselementen. Falls angegeben, werden alle Commits und Arbeitselemente zwischen der Startbuildnummer und der Buildnummer heruntergeladen, die als Eingabe zum Herunterladen von Artefakten angegeben wird.

artifactDetailsFileNameSuffix - Commit und WorkItem FileName
string. Optional. Verwenden Sie , wenn downloadCommitsAndWorkItems == invalid.

Gibt das Dateinamensuffix für Commits und Arbeitselementanlagen an. Anlagen werden mit commits_{suffix}.json und workitem_{suffix}.jsonerstellt. Wenn diese Eingabe nicht bereitgestellt wird, werden Anlagen mit den Namen commits.json und workitems.jsonerstellt.

propagatedArtifacts - Artefakte werden an Azure weitergegeben
boolean. Standardwert. false.

Verwenden Sie diese Eingabe, wenn Jenkins-Artefakte an Azure weitergegeben wurden. Informationen zum Hochladen von Jenkins-Artefakten in Azure finden Sie in diesem Jenkins-Plug-In.

artifactProvider - Artefaktanbieter
string. Erforderlich, wenn propagatedArtifacts == notValid. Zulässige Werte: azureStorage (Azure Storage). Standardwert. azureStorage.

Gibt den externen Speicheranbieter an, der im Jenkins-Auftrag zum Hochladen der Artefakte verwendet wird.

ConnectedServiceNameARM - Azure-Abonnement
string. Erforderlich, wenn propagatedArtifacts == true.

Gibt das Azure Resource Manager-Abonnement für die Artefakte an.

storageAccountName - Speicherkontoname
string. Erforderlich, wenn propagatedArtifacts == true.

Gibt klassische Azure- oder Resource Manager-Speicherkonten an. Wählen Sie den Namen des Speicherkontos aus, in dem die Artefakte weitergegeben werden.

containerName - Containername
string. Erforderlich, wenn propagatedArtifacts == true.

Gibt den Namen des Containers im Speicherkonto an, in das Artefakte hochgeladen werden.

commonVirtualPath - Allgemeiner virtueller Pfad
string. Optional. Verwenden Sie , wenn propagatedArtifacts == true.

Gibt den Pfad zu den Artefakten im Azure-Speichercontainer an.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um Artefakte herunterzuladen, die von einem Jenkins-Auftrag erstellt wurden.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.144.0 oder höher
Aufgabenkategorie	Hilfsprogramm