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.
# 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'. 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
, , nuget
npm
, pypi
(Python), upack
(Universal), cargo
. Wartość domyślna: nuget
.
packageType
- Typ pakietu
string
. Wymagane. Dozwolone wartości: maven
, , nuget
npm
, pypi
(Python), upack
(Universal). 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
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 |
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.115.0 lub nowsza |
Kategoria zadania | Narzędzie |