JenkinsDownloadArtifacts@1 — zadanie pobierania artefaktów usługi Jenkins w wersji 1
To zadanie służy do pobierania artefaktów utworzonych przez zadanie narzędzia Jenkins.
Składnia
# 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.
Dane wejściowe
jenkinsServerConnection
- Połączenie usługi Jenkins
Alias wejściowy: serverEndpoint
. string
. Wymagane.
Określa połączenie usługi dla wystąpienia serwera Jenkins. Aby utworzyć nowe połączenie z usługą, kliknij link Zarządzaj.
jobName
- Nazwa zadania
string
. Wymagane.
Określa nazwę zadania serwera Jenkins do pobierania artefaktów. Musi to być dokładnie zgodne z nazwą zadania na serwerze Jenkins.
jenkinsJobType
- Typ zadania narzędzia Jenkins
string
. Opcjonalny. Użyj polecenia , gdy jobName = invalidjobName
.
Automatycznie określa typ zadania narzędzia Jenkins.
saveTo
- Zapisz w
string
. Wymagane. Wartość domyślna: jenkinsArtifacts
.
Określa katalog, w którym są pobierane i zapisywane artefakty narzędzia Jenkins. Ten katalog jest tworzony, jeśli nie istnieje.
jenkinsBuild
- Pobieranie artefaktów generowanych przez program
string
. Wymagane. Dozwolone wartości: LastSuccessfulBuild
(Ostatnia pomyślna kompilacja), BuildNumber
(numer kompilacji). Wartość domyślna: LastSuccessfulBuild
.
Pobiera artefakty utworzone przez ostatnią pomyślną kompilację lub z określonego wystąpienia kompilacji.
jenkinsBuildNumber
- Numer kompilacji usługi Jenkins
string
. Wymagane, gdy jenkinsBuild == BuildNumber
. Wartość domyślna: 1
.
Pobiera artefakty utworzone przez tę kompilację.
itemPattern
- Wzorzec elementu
string
. Wartość domyślna: **
.
Określa pliki do pobrania jako wzorzec minipasmowy wielowierszowy. Więcej informacji o wzorcach dopasowywania plików.
Domyślny wzorzec **
pobiera wszystkie pliki we wszystkich artefaktach generowanych przez zadanie serwera Jenkins. Aby pobrać wszystkie pliki w ramach upuszczania artefaktu, użyj polecenia drop/**
.
downloadCommitsAndWorkItems
- Pobieranie zatwierdzeń i elementów roboczych
boolean
. Wartość domyślna: false
.
Umożliwia pobieranie zatwierdzeń i szczegółów elementów roboczych skojarzonych z zadaniem narzędzia Jenkins.
startJenkinsBuildNumber
- Pobieranie zatwierdzeń i elementów roboczych z
string
. Opcjonalny. Użyj polecenia , gdy downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber
.
Uruchamia numer kompilacji do pobierania zatwierdzeń i elementów roboczych. W przypadku podania wszystkie zatwierdzenia i elementy robocze między numerem kompilacji początkowej a numerem kompilacji podanym jako dane wejściowe do pobrania artefaktów są pobierane.
artifactDetailsFileNameSuffix
- Commit i WorkItem FileName
string
. Opcjonalny. Użyj polecenia , gdy downloadCommitsAndWorkItems == invalid
.
Określa sufiks nazwy pliku dla zatwierdzeń i załączników elementów roboczych. Załączniki są tworzone za pomocą poleceń commits_{suffix}.json
i workitem_{suffix}.json
. Jeśli te dane wejściowe nie zostaną podane, załączniki są tworzone przy użyciu nazw commits.json
i workitems.json
.
propagatedArtifacts
- Artefakty są propagowane na platformę Azure
boolean
. Wartość domyślna: false
.
Użyj tych danych wejściowych, jeśli artefakty narzędzia Jenkins zostały rozpropagowane na platformę Azure. Aby przekazać artefakty serwera Jenkins na platformę Azure, zapoznaj się z tą wtyczką serwera Jenkins.
artifactProvider
- Dostawca artefaktów
string
. Wymagane, gdy propagatedArtifacts == notValid
. Dozwolone wartości: azureStorage
(Azure Storage). Wartość domyślna: azureStorage
.
Określa zewnętrznego dostawcę magazynu używanego w zadaniu serwera Jenkins w celu przekazania artefaktów.
ConnectedServiceNameARM
- Subskrypcja platformy Azure
string
. Wymagane, gdy propagatedArtifacts == true
.
Określa subskrypcję usługi Azure Resource Manager dla artefaktów.
storageAccountName
- Nazwa konta magazynu
string
. Wymagane, gdy propagatedArtifacts == true
.
Określa klasyczne lub Resource Manager konta magazynu platformy Azure. Wybierz nazwę konta magazynu, w którym są propagowane artefakty.
containerName
- Nazwa kontenera
string
. Wymagane, gdy propagatedArtifacts == true
.
Określa nazwę kontenera na koncie magazynu, na którym są przekazywane artefakty.
commonVirtualPath
- Wspólna ścieżka wirtualna
string
. Opcjonalny. Użyj polecenia , gdy propagatedArtifacts == true
.
Określa ścieżkę do artefaktów wewnątrz kontenera usługi Azure Storage.
Opcje sterowania zadania
Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.
Zmienne wyjściowe
Brak.
Uwagi
To zadanie służy do pobierania artefaktów utworzonych przez zadanie narzędzia Jenkins.
Wymagania
Wymaganie | Opis |
---|---|
Typy potoków | YAML, klasyczna kompilacja, wersja klasyczna |
Działa w | Agent, DeploymentGroup |
Wymagania | Brak |
Możliwości | To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu. |
Ograniczenia poleceń | Dowolne |
Zmienne ustawialne | Dowolne |
Wersja agenta | 2.144.0 lub nowsza |
Kategoria zadania | Narzędzie |
Wymaganie | Opis |
---|---|
Typy potoków | YAML, kompilacja klasyczna, wersja klasyczna |
Działa na | Agent, DeploymentGroup |
Wymagania | Brak |
Możliwości | To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu. |
Ograniczenia poleceń | Dowolne |
Zmienne w formie tabeli settable | Dowolne |
Wersja agenta | Wszystkie obsługiwane wersje agentów. |
Kategoria zadania | Narzędzie |