DownloadPackage@1 - Scaricare l'attività pacchetto v1

Usare questa attività per scaricare un pacchetto da un feed di gestione pacchetti in Azure Artifacts.

Sintassi

# 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.

Ingressi

packageType - tipo di pacchetto
string. Obbligatorio. Valori consentiti: maven, npm, nuget, pypi (Python), upack (universale), cargo. Valore predefinito: nuget.

feed - feed
string. Obbligatorio.

Per i feed con ambito progetto, il formato è projectID/feedID. Vedere le osservazioni seguenti per informazioni su come ottenere un feed o un ID progetto oppure su come usare un progetto e un nome di feed.

visualizzazione
string.

Specifica una visualizzazione che utilizza solo le versioni alzate di livello a tale visualizzazione specifica.

definition - pacchetto
string. Obbligatorio.

Se non si trova il pacchetto nell'elenco, è possibile specificare l'ID pacchetto, che è possibile trovare usando le istruzioni qui.

version - versione
string. Obbligatorio.

Specifica la versione del pacchetto. Usare latest per scaricare la versione più recente del pacchetto in fase di esecuzione. Usare * per scaricare la versione più recente di un pacchetto quando packageType = upack.

files - File
string. Opzionale. Usare quando packageType = maven || packageType = pypi || packageType = upack. Valore predefinito: **.

Specifica i file da scaricare usando criteri di corrispondenza dei file.

extract - estrarre il contenuto del pacchetto
boolean. Opzionale. Usare quando packageType = nuget || packageType = npm. Valore predefinito: true.

Estrae il contenuto del pacchetto e contiene l'archivio pacchetti nella cartella artefatto.

downloadPath - directory di destinazione
string. Obbligatorio. Valore predefinito: $(System.ArtifactsDirectory).

Specifica il percorso nel computer dell'agente in cui viene scaricato il pacchetto.

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per scaricare un pacchetto da un feed di gestione pacchetti in Azure Artifacts o TFS.

Nota

Richiede l'estensione gestione pacchetti .

Come trovare l'ID del feed (o del progetto) da cui scaricare l'artefatto

L'API get feed può essere usata per recuperare il feed e l'ID progetto per il feed. L'API è documentata qui.

È possibile usare il nome del progetto o del feed anziché gli ID

Sì, è possibile usare il nome del progetto o del feed nella definizione. Tuttavia, se il progetto o il feed viene rinominato in futuro, l'attività dovrà anche essere aggiornata o potrebbe non riuscire.

Esempi

Scaricare un pacchetto NuGet da un feed con ambito organizzazione ed estrarre nella directory di destinazione

# 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)'

Scaricare un pacchetto maven da un feed con ambito progetto e scaricare solo i file 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)'

Fabbisogno

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	2.144.0 o versione successiva
Categoria attività	Utilità