UniversalPackages@0 – Universal packages v0 task

Använd den här uppgiften för att ladda ned eller paketera och publicera universella paket.

Syntax

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

Ingångar

command - kommando
string. Krävs. Tillåtna värden: download, publish. Standardvärde: download.

Anger kommandot Universal Package som ska köras.

downloadDirectory - Målkatalog
string. Krävs när command = download. Standardvärde: $(System.DefaultWorkingDirectory).

Anger mappsökvägen där uppgiften laddar ned paketets innehåll.

feedsToUse - feedplats
Indataalias: internalOrExternalDownload. string. Krävs när command = download. Tillåtna värden: internal (den här organisationen/samlingen), external (en annan organisation/samling). Standardvärde: internal.

Anger en feed från den här samlingen eller en annan samling i Azure Artifacts.

externalFeedCredentials - organisations-/samlingsanslutning
Indataalias: externalEndpoint. string. Valfri. Använd när internalOrExternalDownload = external && command = download.

Anger de autentiseringsuppgifter som ska användas för externa register som finns i den valda NuGet.config. Lämna detta tomt för feeds i den här organisationen eller samlingen. byggets autentiseringsuppgifter används automatiskt.

vstsFeed - Feed
Indataalias: feedListDownload. string. Krävs när internalOrExternalDownload = internal && command = download.

Innehåller den valda feeden. Du måste ha Azure Artifacts installerat och licensierat för att välja en feed här. Anger FeedName- för ett flöde med organisationsomfattning och projectName/FeedName eller ProjectID/FeedID- för ett projektomfångat flöde.

vstsFeedPackage - Paketnamn
Indataalias: packageListDownload. string. Krävs när internalOrExternalDownload = internal && command = download.

Anger namnet på paketet som aktiviteten ska laddas ned.

vstsPackageVersion - version
Indataalias: versionListDownload. string. Krävs när internalOrExternalDownload = internal && command = download.

Anger paketversionen eller använder en variabel som innehåller den version som ska laddas ned. Den här posten kan också vara ett jokerteckenuttryck, till exempel *, för att få den högsta versionen. Exempel: 1.* får den högsta versionen med huvudversion 1 och 1.2.* får den högsta korrigeringsversionen med huvudversion 1 och delversion 2.

feedDownloadExternal - feed (eller Project/Feed om feeden skapades i ett projekt)
string. Krävs när internalOrExternalDownload = external && command = download.

Anger ett flöde i en annan organisation/samling.

För feeds med projektomfattning ska värdet vara Project/Feed, där Project är projektets namn eller ID och Feed är feedens namn/ID. För feeds med organisationsomfattning ska värdet bara vara feednamnet.

packageDownloadExternal - Paketnamn
string. Krävs när internalOrExternalDownload = external && command = download.

Anger paketnamnet som ska laddas ned.

versionDownloadExternal - version
string. Krävs när internalOrExternalDownload = external && command = download.

Anger paketversionen eller använder en variabel som innehåller den version som ska laddas ned. Den här posten kan också vara ett jokerteckenuttryck, till exempel *, för att få den högsta versionen. Exempel: 1.* får den högsta versionen med huvudversion 1 och 1.2.* får den högsta korrigeringsversionen med huvudversion 1 och delversion 2. Jokerteckenmönster stöds inte med förhandsversionspaket.

publishDirectory - sökväg till filer som ska publiceras
string. Krävs när command = publish. Standardvärde: $(Build.ArtifactStagingDirectory).

Anger sökvägen till listan över filer som ska publiceras.

feedsToUsePublish - feedplats
Indataalias: internalOrExternalPublish. string. Krävs när command = publish. Tillåtna värden: internal (den här organisationen/samlingen), external (en annan organisation/samling). Standardvärde: internal.

Anger en feed från den här samlingen eller en annan samling i Azure Artifacts.

publishFeedCredentials - organisations-/samlingsanslutning
Indataalias: externalEndpoints. string. Krävs när internalOrExternalPublish = external && command = publish.

Anger de autentiseringsuppgifter som ska användas för externa feeds.

vstsFeedPublish - målflöde
Indataalias: feedListPublish. string. Krävs när internalOrExternalPublish = internal && command = publish.

Anger projektet och feedens namn/GUID som ska publiceras till.

publishPackageMetadata - Publicera pipelinemetadata
boolean. Valfri. Använd när command = publish && internalOrExternalPublish = internal. Standardvärde: true.

Associerar den här bygg-/versionspipelinens metadata (till exempel körningsnummer och källkodsinformation) med paketet.

vstsFeedPackagePublish - Paketnamn
Indataalias: packageListPublish. string. Krävs när internalOrExternalPublish = internal && command = publish.

Anger ett paket-ID för att publicera eller skapar ett nytt paket-ID om du aldrig har publicerat en version av det här paketet tidigare. Paketnamn måste vara gemener och kan bara använda bokstäver, siffror och bindestreck (-).

feedPublishExternal - feed (eller Project/Feed om feeden skapades i ett projekt)
string. Krävs när internalOrExternalPublish = external && command = publish.

Anger det externa flödesnamnet som ska publiceras till.

Om flödet skapades i ett projekt ska värdet vara Project/Feed, där Project är projektets namn eller ID och Feed är feedens namn. Om feeden inte skapades i ett projekt ska värdet bara vara feednamnet.

packagePublishExternal - Paketnamn
string. Krävs när internalOrExternalPublish = external && command = publish.

Anger paketnamnet när du publicerar till en extern feed.

versionOption - version
Indataalias: versionPublishSelector. string. Krävs när command = publish. Tillåtna värden: major (nästa huvud), minor (nästa mindre), patch (nästa korrigering), custom. Standardvärde: patch.

Anger en strategi för versionsökning. Det custom värdet för att ange paketversionen manuellt. För nya paket blir den första versionen 1.0.0 om du anger major, 0.1.0 om du anger minoreller 0.0.1 om du anger patch. Mer information finns i semantisk versionsspecifikation.

versionPublish - Anpassad version
string. Krävs när versionPublishSelector = custom && command = publish.

Anger ett schema för anpassad version för paketet.

packagePublishDescription - Beskrivning
string. Valfri. Använd när command = publish.

Anger beskrivningen av paketinnehållet och/eller ändringarna som gjorts i den här versionen av paketet.

verbosity - utförlighet
string. Tillåtna värden: None, Trace, Debug, Information, Warning, Error, Critical. Standardvärde: None.

Anger mängden information som visas i utdata.

publishedPackageVar - -paketutdatavariabel
string. Valfri. Använd när command = publish.

Anger ett namn på variabeln som ska innehålla det publicerade paketnamnet och versionen.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att ladda ned eller paketera och publicera universella paket.

Min pipeline måste komma åt en feed i ett annat projekt

Om pipelinen körs i ett annat projekt än det projekt som är värd för flödet måste du konfigurera det andra projektet för att bevilja läs-/skrivåtkomst till byggtjänsten. Mer information finns i Paketbehörigheter i Azure Pipelines.

Exempel

Det enklaste sättet att komma igång med uppgiften Universellt paket är att använda pipelines-aktivitetsredigeraren för att generera YAML. Du kan sedan kopiera den genererade koden till projektets azure-pipelines.yml fil. I det här exemplet visar exemplet hur du snabbt genererar YAML med hjälp av en pipeline som skapar en progressiv GatsbyJS-webbapp (PWA).

Universella paket är ett användbart sätt att både kapsla in och version en webbapp. Om du paketerar en webbapp i ett universellt paket kan du snabbt återställa en viss version av webbplatsen och eliminerar behovet av att skapa platsen i distributionspipelinen.

Den här exempelpipelinen visar hur du hämtar ett verktyg från en feed i projektet. Universal Package-uppgiften används för att ladda ned verktyget, köra en version och använder återigen universalpaketaktiviteten för att publicera hela kompilerade GatsbyJS PWA till en feed som ett versionsutförande universalpaket.

Ladda ned ett paket med uppgiften Universellt paket

Den andra aktiviteten i exempelprojektet använder uppgiften Universellt paket för att hämta ett verktyg, imagemagick, från ett flöde som finns i ett annat projekt i samma organisation. Verktyget imagemagick krävs av det efterföljande byggsteget för att ändra storlek på avbildningar.

1. Lägg till uppgiften Universellt paket genom att klicka på plusikonen, skriva "universell" i sökrutan och klicka på knappen Lägg till för att lägga till uppgiften i pipelinen.

   

2. Klicka på den nyligen tillagda uppgiften Universal Package och Command för att Download.

3. Välj den målkatalog som ska användas för nedladdningen av verktyget.

4. Välj en källa Feed som innehåller verktyget, ange Paketnamnoch välj version av verktyget imagemagick från källan Feed.

   

5. När du har slutfört fälten klickar du på Visa YAML- för att se den genererade YAML:en.

   

6. Universal Package task builder genererar förenklad YAML som innehåller icke-standardvärden. Kopiera den genererade YAML:en till din azure-pipelines.yml-fil i roten på projektets git-lagringsplats.

   # 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
   

Publicera ett paket med uppgiften Universellt paket

Det sista steget i den här exempelpipelinen använder uppgiften Universellt paket för att ladda upp den produktionsklara Gatsby PWA som producerades av Run gatsby build steg till en feed som ett versionsbaserat universalpaket. En gång i ett flöde har du en permanent kopia av din fullständiga webbplats som kan distribueras till värdleverantören och startas med gatsby serve.

1. Lägg till ytterligare en universalpaketaktivitet i slutet av pipelinen genom att klicka på plusikonen, skriva "universell" i sökrutan och klicka på knappen Lägg till för att lägga till uppgiften i pipelinen. Den här uppgiften samlar in alla produktionsklara tillgångar som produceras av Run gatsby build steg, skapar ett versionsbaserat universellt paket och publicerar paketet i en feed.

   

2. Ange kommandot till Publish.

3. Ange sökväg till filer för att publicera till katalogen som innehåller GatsbyJS-projektets package.json.

4. Välj ett målflöde, ett paketnamn och ange din versionsstrategi.

   

5. När du har slutfört de obligatoriska fälten klickar du på Visa YAML-.

6. Kopiera den resulterande YAML-filen till din azure-pipelines.yml-fil som tidigare. YAML för det här exempelprojektet visas nedan.

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

Det här exemplet visade hur du använder pipelines-aktivitetsverktyget för att snabbt generera YAML för uppgiften Universellt paket, som sedan kan placeras i din azure-pipelines.yml-fil. Universal Package-aktivitetsverktyget stöder alla avancerade konfigurationer som kan skapas med Universellt paket uppgiftsargument.

Not

Publicering av ett paket direkt till en vy stöds inte i Azure Artifacts. Du måste publicera paketet i feeden först och sedan flytta upp det till en vy.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Någon
variabler som kan	Någon
Agentversion	2.144.0 eller senare
Aktivitetskategori	Paket