DownloadPackage@1 — pobieranie zadania pakietu w wersji 1

To zadanie służy do pobierania pakietu ze źródła danych zarządzania pakietami w usłudze Azure Artifacts.

Składnia

# Download package v1
# Download a package from a package management feed in Azure Artifacts.
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget' # 'maven' | 'npm' | 'nuget' | 'pypi' | 'upack' | 'cargo'. Required. Package Type. Default: nuget.
    feed: # string. Required. Feed. 
    #view: # string. View. 
    definition: # string. Required. Package. 
    version: # string. Required. Version. 
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
  # Advanced
    #files: '**' # string. Optional. Use when packageType = maven || packageType = pypi || packageType = upack. Files. Default: **.
    #extract: true # boolean. Optional. Use when packageType = nuget || packageType = npm. Extract package contents. Default: true.

Wejścia

packageType - typ pakietu
string. Wymagane. Dozwolone wartości: maven, npm, nuget, pypi (Python), upack (universal), cargo. Wartość domyślna: nuget.

kanału informacyjnego
string. Wymagane.

W przypadku źródeł danych o zakresie projektu format jest projectID/feedID. Zapoznaj się z poniższymi uwagami , aby dowiedzieć się, jak uzyskać identyfikator źródła danych lub projektu, lub dowiedzieć się, jak zamiast tego używać nazwy projektu i kanału informacyjnego.

view - View
string.

Określa widok, który używa tylko wersji promowanych do tego określonego widoku.

pakietu
string. Wymagane.

Jeśli nie znajdziesz pakietu na liście, możesz podać identyfikator pakietu, który można znaleźć, korzystając z instrukcji tutaj.

version - wersja
string. Wymagane.

Określa wersję pakietu. Użyj latest, aby pobrać najnowszą wersję pakietu w czasie wykonywania. Użyj *, aby pobrać najnowszą wersję pakietu podczas packageType = upack.

files - Files
string. Fakultatywny. Użyj polecenia , gdy packageType = maven || packageType = pypi || packageType = upack. Wartość domyślna: **.

Określa pliki do pobrania przy użyciu wzorców dopasowania plików.

extract - wyodrębnianie zawartości pakietu
boolean. Fakultatywny. Użyj polecenia , gdy packageType = nuget || packageType = npm. Wartość domyślna: true.

Wyodrębnia zawartość pakietu i zawiera archiwum pakietu w folderze artefaktu.

katalogu docelowego
string. Wymagane. Wartość domyślna: $(System.ArtifactsDirectory).

Określa ścieżkę na maszynie agenta, na której jest pobierany pakiet.

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

Żaden.

Uwagi

To zadanie służy do pobierania pakietu ze źródła danych zarządzania pakietami w usłudze Azure Artifacts lub TFS.

Nuta

Wymaga rozszerzenia zarządzania pakietami .

Jak mogę znaleźć identyfikator źródła danych (lub projektu), z którego chcesz pobrać artefakt

Interfejs API pobierania źródła danych może służyć do pobierania źródła danych i identyfikatora projektu dla kanału informacyjnego. Interfejs API jest udokumentowany tutaj.

Czy mogę użyć nazwy projektu lub źródła danych zamiast identyfikatorów

Tak, możesz użyć nazwy projektu lub źródła danych w definicji. Jeśli jednak nazwa projektu lub kanału informacyjnego zostanie zmieniona w przyszłości, zadanie również będzie musiało zostać zaktualizowane lub może zakończyć się niepowodzeniem.

Przykłady

Pobieranie pakietu NuGet ze źródła danych o zakresie organizacji i wyodrębnianie do katalogu docelowego

# Download an artifact with id 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget'
    feed: '6a60ef3b-e29f-41b6-9885-7874278baac7'
    definition: 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' # Can also be package name
    version: '1.0.0'
    extract: true
    downloadPath: '$(System.ArtifactsDirectory)'

Pobieranie pakietu maven ze źródła danych o zakresie projektu i pobieranie tylko plików pom

# Download an artifact with name 'com.test:testpackage' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'maven'
    feed: '132f5c2c-2aa0-475a-8b47-02c79617954b/c85e5de9-7b12-4cfd-9293-1b33cdff540e' # <projectId>/<feedId>
    definition: 'com.test:testpackage' 
    version: '1.0.0-snapshot' # Should be normalized version
    files: '*.pom'
    downloadPath: '$(System.ArtifactsDirectory)'

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