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

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

Jeśli używasz Azure DevOps Services, zalecamy użycie funkcji Pobierz artefakty potoku i Publikowanie artefaktów potoku w celu uzyskania szybszej wydajności.

Składnia

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@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.
    #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.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

Dane wejściowe

buildType - Pobieranie artefaktów utworzonych przez firmę
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 mają być pobierane 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 kompilacji wyzwalającej.
boolean. Opcjonalny. Użyj polecenia , gdy buildType == specific. Wartość domyślna: false.

Jeśli trueto 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 (najnowsza z określonej gałęzi i określone tagi kompilacji), specific (określona wersja). Wartość domyślna: latest.

Określa, która wersja kompilacji do pobrania.

• Wybierz latest , aby pobrać najnowszą dostępną wersję kompilacji.
• Wybierz latestFromBranch opcję pobrania najnowszej dostępnej wersji kompilacji gałęzi określonej przez branchName i tagów określonych przez tagsprogram .
• Wybierz specific , aby pobrać wersję kompilacji określoną przez buildIdprogram .

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 trueto 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 należy filtrować dla 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.

• Wybierz single (określony artefakt), jeśli chcesz określić tylko jeden konkretny artefakt określony przez artifactName
• Wybierz specific (określone pliki), gdy chcesz, aby wszystkie artefakty wybranej 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 minimatu 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.

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

parallelizationLimit - Limit równoległych
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 prób ponawiania próby pobrania artefaktu kompilacji, jeśli pobieranie zakończy się niepowodzeniem.

extractTars - Wyodrębnianie wszystkich plików przechowywanych w archiwach tar
boolean.

Ustaw wartość , aby wyodrębnić true wszystkie pobrane pliki z rozszerzeniem tar . Jest to przydatne, ponieważ należy spakować pliki artefaktów do tar, jeśli chcesz zachować uprawnienia do plików systemu Unix. Włączenie StoreAsTar opcji w zadaniu Publikowanie artefaktów kompilacji spowoduje automatyczne przechowywanie artefaktów jako plików tar .

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.

Uwagi

Uwaga

Zespół usługi Azure Pipelines zaleca uaktualnienie artefaktów kompilacji do artefaktówpotoku w celu uzyskania szybszej wydajności.

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