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.

Dane wejściowe

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

feed - Paszy
string. Wymagane.

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

view - Widok
string.

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

definition - Pakiet
string. Wymagane.

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

version - Wersja
string. Wymagane.

Określa wersję pakietu. Użyj polecenia latest , aby pobrać najnowszą wersję pakietu w czasie wykonywania.

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

Określa, które pliki mają być pobierane przy użyciu wzorców dopasowywania plików.

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

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

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

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

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

Brak.

Uwagi

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

Uwaga

Wymaga rozszerzenia zarządzanie pakietami.

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

Interfejs API pobierania źródła danych może służyć do pobierania źródła danych i identyfikatora projektu dla źródła danych. 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 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.144.0 lub nowsza
Kategoria zadania	Narzędzie