JenkinsDownloadArtifacts@1 – Úloha Stažení artefaktů Jenkinse v1
Pomocí této úlohy můžete stáhnout artefakty vytvořené úlohou Jenkinse.
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.
# 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.
Vstupy
jenkinsServerConnection
- Připojení služby Jenkins
Vstupní alias: serverEndpoint
. string
. Povinná hodnota.
Určuje připojení služby pro instanci Jenkinse. Pokud chcete vytvořit nové připojení služby, klikněte na odkaz Spravovat.
jobName
- Název úlohy
string
. Povinná hodnota.
Určuje název úlohy Jenkinse, ze které se mají stahovat artefakty. Musí přesně odpovídat názvu úlohy na serveru Jenkins.
jenkinsJobType
- Typ úlohy Jenkinse
string
. Nepovinný parametr. Použijte, když jobName = invalidjobName
.
Automaticky určuje typ úlohy Jenkinse.
saveTo
- Uložit do
string
. Povinná hodnota. Výchozí hodnota: jenkinsArtifacts
.
Určuje adresář, do kterého se stahují a ukládají artefakty Jenkinse. Tento adresář se vytvoří, pokud neexistuje.
jenkinsBuild
- Stažení artefaktů vytvořených uživatelem
string
. Povinná hodnota. Povolené hodnoty: LastSuccessfulBuild
(Poslední úspěšné sestavení), BuildNumber
(číslo sestavení). Výchozí hodnota: LastSuccessfulBuild
.
Stahuje artefakty vytvořené posledním úspěšným sestavením nebo z konkrétní instance sestavení.
jenkinsBuildNumber
- Číslo buildu Jenkinse
string
. Vyžaduje se, když jenkinsBuild == BuildNumber
. Výchozí hodnota: 1
.
Stahuje artefakty vytvořené tímto buildem.
itemPattern
- Vzor položky
string
. Výchozí hodnota: **
.
Určuje soubory, které se mají stáhnout jako vzor minimatch s více řádky. Další informace o vzorech porovnávání souborů.
Výchozí vzor **
stáhne všechny soubory napříč všemi artefakty vytvořenými úlohou Jenkinse. Pokud chcete stáhnout všechny soubory v rámci odstraňování artefaktů, použijte drop/**
.
downloadCommitsAndWorkItems
- Stažení potvrzení a pracovních položek
boolean
. Výchozí hodnota: false
.
Umožňuje stahování potvrzení a podrobností pracovních položek přidružených k úloze Jenkinse.
startJenkinsBuildNumber
- Stažení potvrzení a pracovních položek z
string
. Nepovinný parametr. Použijte, když downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber
.
Spustí číslo sestavení pro stahování potvrzení a pracovních položek. Pokud je k dispozici, stáhnou se všechna potvrzení a pracovní položky mezi počátečním číslem buildu a číslem sestavení zadaným jako vstup ke stažení artefaktů.
artifactDetailsFileNameSuffix
- Commit a WorkItem FileName
string
. Nepovinný parametr. Použijte, když downloadCommitsAndWorkItems == invalid
.
Určuje příponu názvu souboru pro potvrzení a přílohy pracovních položek. Přílohy se vytvářejí pomocí commits_{suffix}.json
a workitem_{suffix}.json
. Pokud tento vstup není zadaný, vytvoří se přílohy s názvy commits.json
a workitems.json
.
propagatedArtifacts
- Artefakty se šíří do Azure.
boolean
. Výchozí hodnota: false
.
Tento vstup použijte, pokud se artefakty Jenkinse rozšířily do Azure. Pokud chcete nahrát artefakty Jenkinse do Azure, projděte si tento modul plug-in Jenkinse.
artifactProvider
- Zprostředkovatel artefaktů
string
. Vyžaduje se, když propagatedArtifacts == notValid
. Povolené hodnoty: azureStorage
(Azure Storage). Výchozí hodnota: azureStorage
.
Určuje externího poskytovatele úložiště použitého v úloze Jenkinse k nahrání artefaktů.
ConnectedServiceNameARM
- Předplatné Azure
string
. Vyžaduje se, když propagatedArtifacts == true
.
Určuje předplatné Azure Resource Manager pro artefakty.
storageAccountName
- Název účtu úložiště
string
. Vyžaduje se, když propagatedArtifacts == true
.
Určuje účty úložiště Azure Classic nebo Resource Manager. Vyberte název účtu úložiště, ve kterém se artefakty šíří.
containerName
- Název kontejneru
string
. Vyžaduje se, když propagatedArtifacts == true
.
Určuje název kontejneru v účtu úložiště, kam se artefakty nahrávají.
commonVirtualPath
- Společná virtuální cesta
string
. Nepovinný parametr. Použijte, když propagatedArtifacts == true
.
Určuje cestu k artefaktům uvnitř kontejneru úložiště Azure.
Možnosti ovládání úloh
Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.
Výstupní proměnné
Žádné
Poznámky
Pomocí této úlohy můžete stáhnout artefakty vytvořené úlohou Jenkinse.
Požadavky
Požadavek | Popis |
---|---|
Typy kanálů | YAML, classic build, verze Classic |
Spustí se | Agent, DeploymentGroup |
Požadavky | Žádné |
Možnosti | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
Omezení příkazů | Všechny |
Nastavitelné proměnné | Všechny |
Verze agenta | 2.144.0 nebo vyšší |
Kategorie úloh | Nástroj |
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasický build, klasická verze |
Běží na | Agent, DeploymentGroup |
Požadavky | Žádné |
Možnosti | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
Omezení příkazů | Všechny |
Nastavitelné proměnné | Všechny |
Verze agenta | Všechny podporované verze agenta. |
Kategorie úloh | Nástroj |