UniversalPackages@0 - Attività Pacchetti universali v0

Usare questa attività per scaricare o creare pacchetti e pubblicare pacchetti universali.

Sintassi

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

Input

command - Comando
string. Obbligatorio. Valori consentiti: download, publish. Valore predefinito: download.

Specifica il comando NuGet da eseguire.

downloadDirectory - Directory di destinazione
string. Obbligatorio quando command = download. Valore predefinito: $(System.DefaultWorkingDirectory).

Specifica il percorso della cartella in cui l'attività scarica il contenuto del pacchetto.

feedsToUse - Percorso feed
Alias di input: internalOrExternalDownload. string. Obbligatorio quando command = download. Valori consentiti: internal (questa organizzazione/raccolta), external (un'altra organizzazione/raccolta). Valore predefinito: internal.

Specifica un feed da questa raccolta o da un'altra raccolta in Azure Artifacts.

externalFeedCredentials - organizzazione/connessione alla raccolta
Alias di input: externalEndpoint. string. Facoltativa. Usare quando internalOrExternalDownload = external && command = download.

Specifica le credenziali da usare per i registri esterni che si trovano nell'oggetto selezionato NuGet.config. Per i feed in questa organizzazione o raccolta, lasciare vuoto questo campo; le credenziali della compilazione vengono usate automaticamente.

vstsFeed - Nutrire
Alias di input: feedListDownload. string. Obbligatorio quando internalOrExternalDownload = internal && command = download.

Include il feed selezionato. Per selezionare un feed, è necessario che Azure Artifacts sia installato e concesso in licenza. Specifica feedName per un feed con ambito organizzazione e projectName/FeedName o ProjectID/FeedID per un feed con ambito progetto.

vstsFeedPackage - Nome pacchetto
Alias di input: packageListDownload. string. Obbligatorio quando internalOrExternalDownload = internal && command = download.

Specifica il nome del pacchetto da scaricare per l'attività.

vstsPackageVersion - Versione
Alias di input: versionListDownload. string. Obbligatorio quando internalOrExternalDownload = internal && command = download.

Specifica la versione del pacchetto o usa una variabile contenente la versione da scaricare. Questa voce può anche essere un'espressione con caratteri jolly, ad esempio *, per ottenere la versione più recente. Esempi: 1.* ottiene la versione più recente con la versione principale 1 e 1.2.* ottiene la versione patch più alta con la versione principale 1 e la versione secondaria 2.

feedDownloadExternal - Feed (o Progetto/Feed se il feed è stato creato in un progetto)
string. Obbligatorio quando internalOrExternalDownload = external && command = download.

Specifica un feed in un'altra organizzazione/raccolta.

Per i feed con ambito progetto, il valore deve essere Project/Feed, dove Project è il nome o l'ID del progetto e Feed è il nome/ID del feed. Per i feed con ambito organizzazione, il valore deve essere solo il nome del feed.

packageDownloadExternal - Nome pacchetto
string. Obbligatorio quando internalOrExternalDownload = external && command = download.

Specifica il nome del pacchetto da scaricare.

versionDownloadExternal - Versione
string. Obbligatorio quando internalOrExternalDownload = external && command = download.

Specifica la versione del pacchetto o usa una variabile contenente la versione da scaricare. Questa voce può anche essere un'espressione con caratteri jolly, ad esempio *, per ottenere la versione più recente. Esempi: 1.* ottiene la versione più recente con la versione principale 1 e 1.2.* ottiene la versione patch più alta con la versione principale 1 e la versione secondaria 2. I modelli con caratteri jolly non sono supportati con i pacchetti non definitive.

publishDirectory - Percorso dei file da pubblicare
string. Obbligatorio quando command = publish. Valore predefinito: $(Build.ArtifactStagingDirectory).

Specifica il percorso dell'elenco di file da pubblicare.

feedsToUsePublish - Percorso feed
Alias di input: internalOrExternalPublish. string. Obbligatorio quando command = publish. Valori consentiti: internal (questa organizzazione/raccolta), external (un'altra organizzazione/raccolta). Valore predefinito: internal.

Specifica un feed da questa raccolta o da un'altra raccolta in Azure Artifacts.

publishFeedCredentials - organizzazione/connessione alla raccolta
Alias di input: externalEndpoints. string. Obbligatorio quando internalOrExternalPublish = external && command = publish.

Specifica le credenziali da utilizzare per i feed esterni.

vstsFeedPublish - Feed di destinazione
Alias di input: feedListPublish. string. Obbligatorio quando internalOrExternalPublish = internal && command = publish.

Specifica il progetto e il nome/GUID del feed da pubblicare.

publishPackageMetadata - Pubblicare metadati della pipeline
boolean. Facoltativa. Usare quando command = publish && internalOrExternalPublish = internal. Valore predefinito: true.

Associa i metadati della pipeline di compilazione/rilascio , ad esempio eseguire # e informazioni sul codice sorgente, al pacchetto.

vstsFeedPackagePublish - Nome pacchetto
Alias di input: packageListPublish. string. Obbligatorio quando internalOrExternalPublish = internal && command = publish.

Specifica un ID pacchetto da pubblicare o crea un nuovo ID pacchetto se non è mai stata pubblicata una versione di questo pacchetto prima. I nomi dei pacchetti devono essere minuscoli e possono usare solo lettere, numeri e trattini (-).

feedPublishExternal - Feed (o Project/Feed se il feed è stato creato in un progetto)
string. Obbligatorio quando internalOrExternalPublish = external && command = publish.

Specifica il nome del feed esterno da pubblicare.

Se il feed è stato creato in un progetto, il valore deve essere Project/Feed, dove Project è il nome o l'ID del progetto e Feed è il nome del feed. Se il feed non è stato creato in un progetto, il valore deve essere solo il nome del feed.

packagePublishExternal - Nome pacchetto
string. Obbligatorio quando internalOrExternalPublish = external && command = publish.

Specifica il nome del pacchetto durante la pubblicazione in un feed esterno.

versionOption - Versione
Alias di input: versionPublishSelector. string. Obbligatorio quando command = publish. Valori consentiti: major (Next major), (Next minor), minor (Next patch), patchcustom. Valore predefinito: patch.

Specifica una strategia di incremento della versione. Valore custom per inserire manualmente la versione del pacchetto. Per i nuovi pacchetti, la prima versione sarà 1.0.0 se si specifica , 0.1.0 se si specifica , o 0.0.1 se si specifica majorminorpatch. Per altre informazioni, vedere la specifica di controllo delle versioni semantiche .

versionPublish - Versione personalizzata
string. Obbligatorio quando versionPublishSelector = custom && command = publish.

Specifica uno schema di versione personalizzato per il pacchetto.

packagePublishDescription - Descrizione
string. Facoltativa. Usare quando command = publish.

Specifica la descrizione del contenuto del pacchetto e/o le modifiche apportate in questa versione del pacchetto.

verbosity - Dettaglio
string. Valori consentiti: TraceNone, DebugInformationWarningErrorCritical. Valore predefinito: None.

Specifica la quantità di dettagli visualizzati nell'output.

publishedPackageVar - Variabile di output del pacchetto
string. Facoltativa. Usare quando command = publish.

Specifica un nome per la variabile che conterrà il nome e la versione del pacchetto pubblicati.

Opzioni di controllo delle attività

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

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per scaricare o creare pacchetti o pubblicare pacchetti universali.

La pipeline personale deve accedere a un feed in un progetto diverso

Se la pipeline è in esecuzione in un progetto diverso dal progetto che ospita il feed, è necessario configurare l'altro progetto per concedere l'accesso in lettura/scrittura al servizio di compilazione. Per altre informazioni, vedere Autorizzazioni del pacchetto in Azure Pipelines .

Esempio

Il modo più semplice per iniziare a usare l'attività Pacchetto universale consiste nell'usare l'editor attività Pipelines per generare YAML. È quindi possibile copiare il codice generato nel file del azure-pipelines.yml progetto. In questo esempio viene illustrato come generare rapidamente YAML usando una pipeline che compila un'app Web progressiva GatsbyJS (PWA).

I pacchetti universali sono un modo utile per incapsulare e versione di un'app Web. La creazione di un'app Web in un pacchetto universale consente il rollback rapido in una versione specifica del sito ed elimina la necessità di compilare il sito nella pipeline di distribuzione.

Questa pipeline di esempio illustra come recuperare uno strumento da un feed all'interno del progetto. L'attività Pacchetto universale viene usata per scaricare lo strumento, eseguire una compilazione e usa di nuovo l'attività Pacchetto universale per pubblicare l'intera pwA GatsbyJS compilata in un feed come pacchetto universale con versione.

Scaricare un pacchetto con l'attività Pacchetto universale

La seconda attività nel progetto di esempio usa l'attività Pacchetto universale per recuperare uno strumento, imagemagick, da un feed che si trova all'interno di un progetto diverso nella stessa organizzazione. Lo strumento, imagemagick, è richiesto dal passaggio di compilazione successivo per ridimensionare le immagini.

1. Aggiungere l'attività Pacchetto universale facendo clic sull'icona più, digitando "universale" nella casella di ricerca e facendo clic sul pulsante Aggiungi per aggiungere l'attività alla pipeline.

   

2. Fare clic sull'attività Pacchetto universale appena aggiunta e sul comando su Download.

3. Scegliere la directory Destinazione da usare per il download dello strumento.

4. Selezionare un feed di origine contenente lo strumento, impostare il nome del pacchetto e scegliere Versione dello strumento imagemagick dal feed di origine.

   

5. Dopo aver completato i campi, fare clic su Visualizza YAML per visualizzare l'YAML generato.

   

6. Il generatore di attività pacchetto universale genera yaML semplificato che contiene valori non predefiniti. Copiare il file YAML generato nella azure-pipelines.ymlradice del repository Git del progetto.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

Pubblicare un pacchetto con l'attività Pacchetto universale

L'ultimo passaggio in questa pipeline di esempio usa l'attività Pacchetto universale per caricare l'oggetto Gatsby PWA pronto per la produzione prodotto dal Run gatsby build passaggio a un feed come pacchetto universale con versione. Una volta in un feed, è disponibile una copia permanente del sito completo che può essere distribuito nel provider di hosting e avviato con gatsby serve.

1. Aggiungere un'altra attività pacchetto universale alla fine della pipeline facendo clic sull'icona più, digitando "universale" nella casella di ricerca e facendo clic sul pulsante Aggiungi per aggiungere l'attività alla pipeline. Questa attività raccoglie tutti gli asset pronti per la produzione prodotti dal Run gatsby build passaggio, produce un pacchetto universale con versione e pubblica il pacchetto in un feed.

   

2. Impostare il comando su Publish.

3. Impostare Path to file(s) per pubblicare nella directory contenente il progetto GatsbyJS.package.json

4. Scegliere un feed di destinazione, un nome del pacchetto e impostare la strategia di controllo delle versioni.

   

5. Dopo aver completato i campi obbligatori, fare clic su Visualizza YAML.

6. Copiare lo YAML risultante nel azure-pipelines.yml file come prima. YaML per questo progetto di esempio viene visualizzato di seguito.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

In questo esempio è stato illustrato come usare il generatore di attività Pipelines per generare rapidamente YAML per l'attività Pacchetto universale, che può quindi essere inserita nel azure-pipelines.yml file. Il generatore di attività pacchetto universale supporta tutte le configurazioni avanzate che possono essere create con gli argomenti dell'attività pacchetto universale .

Nota

La pubblicazione di un pacchetto direttamente in una visualizzazione non è supportata in Azure Artifacts. È prima necessario pubblicare il pacchetto nel feed, quindi alzarlo di livello a una visualizzazione.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.144.0 o versione successiva
Categoria attività	Pacchetto