Udostępnij za pośrednictwem

DownloadBuildArtifacts@1 — zadanie pobierania 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 usług Azure DevOps Services, zalecamy użycie pobieranie artefaktów 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
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 - Projekt
string. Wymagane, gdy buildType == specific.

Projekt, z którego mają zostać pobrane 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.

Określa, która wersja kompilacji ma zostać pobrana.

  • Wybierz latest , aby pobrać najnowszą dostępną wersję kompilacji.
  • Wybierz latestFromBranch , aby pobrać najnowszą dostępną wersję kompilacji gałęzi określonej przez branchName i tagów określonych przez tags.
  • Wybierz specific , aby pobrać wersję kompilacji określoną przez buildId.

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.

  • Wybierz single pozycję (Określony artefakt), jeśli chcesz, aby tylko jeden konkretny artefakt został określony przez artifactName
  • Wybierz specific pozycję (Określone pliki), jeśli chcesz mieć 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 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.

Aby uzyskać więcej informacji na temat System.ArtifactsDirectory, zobacz Używanie zmiennych w klasycznych potokach wydania.


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

Usuń 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.


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

Ustaw na true , aby wyodrębnić wszystkie pobrane pliki, które mają rozszerzenie .tar . Jest to przydatne, ponieważ musisz spakować pliki artefaktów do tar, jeśli chcesz zachować uprawnienia do plików systemu Unix. Włączenie tej StoreAsTar opcji w zadaniu Publikuj artefakty kompilacji spowoduje automatyczne przechowywanie artefaktów jako plików .tar .


Opcje sterowania zadania

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.

Uwagi

Uwaga / Notatka

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

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 2.191.1 lub nowsza
Kategoria zadań Użyteczność