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

To zadanie służy do pobierania plików zapisanych jako artefakty ukończonej kompilacji.

Jeśli używasz usług Azure DevOps Services, zalecamy użycie pobieranie artefaktów potoku i publikowanie artefaktów potoku w celu uzyskania szybszej wydajności.

Uwaga

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

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 utworzonych przez
string. To jest 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 - Project
string. Wymagane, gdy buildType == specific.

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

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

Określa nazwę potoku kompilacji.

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

Jeśli true, to zadanie kompilacji próbuje pobrać artefakty z kompilacji wyzwalającej. Jeśli nie ma wyzwalania 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 (najnowsze z określonej gałęzi i określone tagi kompilacji), specific (określona wersja). Wartość domyślna: latest.

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

Jeśli true, to zadanie kompilacji próbuje pobrać artefakty, czy kompilacja zakończy się powodzeniem, czy częściowo zakończy się 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 - Tworzenie
string. Wymagane, gdy buildType == specific && buildVersionToDownload == specific.

Kompilacja, z której chcesz pobrać artefakty.

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

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

typ pobierania downloadType -
string. To jest 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 minimatch wielowierszowy. Aby uzyskać więcej informacji, zobacz Odwołania do 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 drop/**.

.

katalogu docelowego
string. To jest 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 - limitu 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 true, to 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, jeśli pobieranie na podstawie przekierowania zakończy się niepowodzeniem. Jeśli sieć nie zezwala na wykonanie przekierowania, możesz ustawić tę opcję na -1, aby zawsze pobierać strumieniowo odpowiedź z usługi Azure DevOps.

extractTars - Wyodrębnij wszystkie pliki przechowywane wewnątrz archiwów tar
boolean.

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

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli 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ą 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 na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadań	Użyteczność