DownloadPipelineArtifact@1 — pobieranie artefaktu potoku w wersji 1 — zadanie

To zadanie służy do pobierania artefaktów potoku z wcześniejszych etapów tego potoku lub z innego potoku.

Jest dostępna nowsza wersja tego zadania. Aby uzyskać więcej informacji, zobacz DownloadPipelineArtifact@2.

Uwaga

Aby uzyskać więcej informacji, w tym poleceń interfejsu wiersza polecenia platformy Azure, zobacz pobieranie artefaktów.

Składnia

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

Dane wejściowe

buildType - Pobieranie artefaktów generowanych przez program
string. Wymagane. Dozwolone wartości: current (bieżąca kompilacja), specific (określona kompilacja). Wartość domyślna: current.

Pobiera artefakty generowane przez bieżące uruchomienie potoku lub z określonego uruchomienia potoku.

project - Projektu
string. Wymagane, gdy buildType == specific.

Określa nazwę projektu lub identyfikator GUID, z którego mają być pobierane artefakty potoku.

pipeline - Potok kompilacji
Alias wejściowy: definition. string. Wymagane, gdy buildType == specific.

Identyfikator definicji potoku. W uruchomionym potoku definitionId można znaleźć w zmiennej System.DefinitionId . Element definitionId można również pobrać z adresu URL na stronie przeglądu potoku w portalu usługi Azure DevOps. W poniższym przykładzie adresu URL wartość definitionId to 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Aby pobrać artefakty z określonej definicji potoku, przechwyć definitionId element z tego potoku i określić go jako pipeline parametr.

specificBuildWithTriggering - W razie potrzeby pobierz artefakty z wyzwalającej kompilacji.
boolean. Opcjonalny. Użyj polecenia , gdy buildType == specific. Wartość domyślna: false.

Jeśli to pole jest zaznaczone, zadanie pobiera artefakty z wyzwalającej kompilacji. Jeśli nie ma wyzwalania kompilacji z określonego potoku, zadanie pobiera artefakty z kompilacji określonej w poniższych opcjach.

buildVersionToDownload - Wersja kompilacji do pobrania
string. Wymagane, gdy buildType == specific. Dozwolone wartości: latest, latestFromBranch (Najnowsza wersja z określonej gałęzi i określonych tagów kompilacji), specific (określona wersja). Wartość domyślna: latest.

Określa wersję kompilacji do pobrania.

branchName - Nazwa gałęzi
string. Wymagane, gdy buildType == specific && buildVersionToDownload == latestFromBranch. Wartość domyślna: refs/heads/master.

Określa filtr dla gałęzi/nazwy ref. Na przykład: refs/heads/develop.

pipelineId - Budować
Alias wejściowy: buildId. string. Wymagane, gdy buildType == specific && buildVersionToDownload == specific.

Identyfikator uruchomienia potoku, z którego mają zostać pobrane artefakty. W uruchomionym potoku buildId można znaleźć w zmiennej Build.BuildId . Element buildId można również pobrać z adresu URL na stronie podsumowania przebiegu potoku w portalu usługi Azure DevOps. W poniższym przykładzie adresu URL parametr buildId to 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Aby pobrać artefakty z określonego uruchomienia potoku, przechwyć buildId go z tego uruchomienia i określić jako buildId parametr.

tags - Tagi kompilacji
string. Opcjonalny. Użyj polecenia , gdy buildType == specific && buildVersionToDownload != specific.

Rozdzielana przecinkami lista tagów używanych przez zadanie do zwracania oznakowanych kompilacji. Nie są zwracane nieoznaczone kompilacje.

artifactName - Nazwa artefaktu
string.

Określa nazwę artefaktu do pobrania. Jeśli wartość jest pozostawiona pusta, zadanie pobiera wszystkie artefakty skojarzone z uruchomieniem potoku.

itemPattern - Wzorzec dopasowywania
string. Wartość domyślna: **.

Wzorce dopasowywania plików, które ograniczają pobrane pliki. Wartość może być co najmniej jednym wzorcem dopasowywania plików, które są rozdzielane nowym wierszem. Dowiedz się więcej o wzorcach dopasowywania plików.

targetPath - Katalog docelowy
Alias wejściowy: downloadPath. string. Wymagane. Wartość domyślna: $(System.ArtifactsDirectory).

Ścieżka na maszynie agenta, na której zostaną pobrane artefakty.

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

Jest dostępna nowsza wersja tego zadania. Aby uzyskać więcej informacji, zobacz DownloadPipelineArtifact@2.

Ważne

To zadanie jest obsługiwane tylko w Azure DevOps Services. Jeśli używasz go w Azure DevOps Server, zostanie wyświetlony komunikat o błędzie podobny do Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. use Download Build Artifacts if you're using Azure DevOps Server or TFS 2018(Użyj pobierania artefaktów kompilacji), jeśli używasz Azure DevOps Server lub TFS 2018.

Domyślnie artefakty są pobierane do .$(Pipeline.Workspace) Jeśli nie określisz nazwy artefaktu, dla każdego pobranego artefaktu zostanie utworzony podkatalog. Możesz użyć wzorców dopasowywania plików , aby ograniczyć pliki, które chcesz pobrać.

Jak mogę znaleźć identyfikator potoku, z którego chcę pobrać artefakt?

Aby znaleźć identyfikator definitionId dla określonej definicji potoku

W uruchomionym potoku definitionId element można znaleźć w zmiennej System.DefinitionId . Element definitionId można również pobrać z adresu URL na stronie przeglądu potoku w portalu usługi Azure DevOps. W poniższym przykładzie adresu URL wartość definitionId to 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Aby pobrać artefakty z określonej definicji potoku, przechwyć definitionId element z tego potoku i określić go jako pipeline parametr.

Aby znaleźć identyfikator buildId dla określonego uruchomienia potoku

Identyfikator uruchomienia potoku, z którego mają zostać pobrane artefakty. W uruchomionym potoku buildId można znaleźć w zmiennej Build.BuildId . Element buildId można również pobrać z adresu URL na stronie podsumowania przebiegu potoku w portalu usługi Azure DevOps. W poniższym przykładzie adresu URL parametr buildId to 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Aby pobrać artefakty z określonego uruchomienia potoku, przechwyć buildId go z tego uruchomienia i określić jako buildId parametr.

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.155.1 lub nowsza
Kategoria zadania	Narzędzie