DownloadBuildArtifacts@0 — pobieranie artefaktów kompilacji w wersji 0

To zadanie służy do pobierania plików, które zostały zapisane jako artefakty ukończonej kompilacji.

Jeśli używasz Azure DevOps Services, zalecamy użycie opcji Pobieranie artefaktów potoku i Publikowanie artefaktów potoku w celu zwiększenia wydajności.

Uwaga

Wyłącz uwierzytelnianie podstawowe usług IIS, jeśli używasz Azure DevOps Server, aby zezwolić na uwierzytelnianie przy użyciu osobistego tokenu dostępu. Aby uzyskać więcej informacji, zobacz Podstawowe uwierzytelnianie usług IIS i usługi PAT .

Składnia

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

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.

Czy pobierać artefakty generowane przez bieżącą kompilację, czy z określonej kompilacji.

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

Projekt, z którego chcesz pobrać artefakty kompilacji.

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

Określa nazwę potoku kompilacji.

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

Jeśli true, to zadanie kompilacji próbuje pobrać artefakty z wyzwalającej kompilacji. Jeśli nie ma wyzwalającej kompilacji z określonego potoku, 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.

allowPartiallySucceededBuilds - Pobieranie artefaktów nawet z częściowo zakończonych powodzeniem kompilacji.
boolean. Opcjonalny. Użyj polecenia , gdy buildType == specific && buildVersionToDownload != specific. Wartość domyślna: false.

Jeśli trueprogram , to zadanie kompilacji próbuje pobrać artefakty, niezależnie od tego, czy kompilacja zakończy się powodzeniem, czy częściowym powodzeniem.

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

Określa, czy filtrować według gałęzi/nazwy ref, na przykład: refs/heads/develop.

buildId - Budować
string. Wymagane, gdy buildType == specific && buildVersionToDownload == specific.

Kompilacja, z której chcesz pobrać artefakty.

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

Rozdzielana przecinkami lista tagów. Zwracane są tylko kompilacje z tymi tagami.

downloadType - Typ pobierania
string. Wymagane. Dozwolone wartości: single (określony artefakt), specific (określone pliki). Wartość domyślna: single.

Pobiera określony artefakt lub określone pliki z kompilacji.

artifactName - Nazwa artefaktu
string. Wymagane, gdy downloadType == single.

Nazwa artefaktu do pobrania.

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

Określa pliki do pobrania jako wzorzec minimatchu wielowierszowego. Aby uzyskać więcej informacji, zobacz Dokumentacja wzorców dopasowywania plików.

Domyślny wzorzec \*\* pobiera wszystkie pliki we wszystkich artefaktach w kompilacji, jeśli wybierzesz opcję Określone pliki . Aby pobrać wszystkie pliki w ramach upuszczania artefaktu, użyj polecenia drop/**.

.

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

Ścieżka na maszynie agenta, na której są pobierane artefakty.

cleanDestinationFolder - Wyczyść folder docelowy
boolean. Wartość domyślna: false.

Usuwa wszystkie istniejące pliki w folderze docelowym przed pobraniem artefaktu.

parallelizationLimit - Limit przetwarzania równoległego
string. Wartość domyślna: 8.

Liczba plików do pobrania jednocześnie.

checkDownloadedFiles - Sprawdzanie pobranych plików
boolean. Wartość domyślna: false.

Jeśli trueto zadanie kompilacji sprawdza, czy wszystkie pliki są w pełni pobierane.

retryDownloadCount - Liczba ponownych prób
string. Wartość domyślna: 4.

Liczba ponownych prób pobrania artefaktu kompilacji w przypadku niepowodzenia pobierania.

retryRedirectDownloadCount - Liczba ponownych prób pobierania przekierowania
string. Wartość domyślna: 0.

Opcjonalna liczba ponownych prób pobrania artefaktu kompilacji w przypadku niepowodzenia pobierania na podstawie przekierowania. Jeśli sieć nie zezwala na wykonanie przekierowania, możesz ustawić tę wartość na -1, aby zawsze pobierać strumieniową odpowiedź z usługi Azure DevOps.

extractTars - Wyodrębnianie wszystkich plików przechowywanych wewnątrz archiwów tar
boolean.

Wyodrębnia wszystkie pobrane pliki z .tar rozszerzeniem. Jest to przydatne, ponieważ należy spakować pliki artefaktów do .tar pliku, jeśli chcesz zachować uprawnienia do plików systemu Unix. Włączenie StoreAsTar opcji w zadaniu PublishBuildArtifacts powoduje automatyczne przechowywanie artefaktów jako .tar plików.

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

To zadanie definiuje następujące zmienne wyjściowe, które można używać w krokach podrzędnych, zadaniach i etapach.

BuildNumber
Przechowuje numer kompilacji źródła artefaktu kompilacji.

Należy pamiętać, że te dane wejściowe zwracają wartość BuildId ze względu na zgodność z poprzednimi wersjami. Aby uzyskać więcej informacji, zobacz Zmienne.

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	Wszystkie obsługiwane wersje agenta.
Kategoria zadania	Narzędzie