UniversalPackages@0 – Universal packages v0-uppgift

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.

Indata

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

Anger nuget-kommandot 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 - organisation/samlingsanslutning
Indataalias: externalEndpoint. string. Valfritt. 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 - Foder
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ångsflöde.

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

Anger namnet på paketet som uppgiften 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.* hämtar 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.* hämtar 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 - organisation/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 att publicera till.

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

Associerar den här bygg-/versionspipelinens metadata (till exempel kör # 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 namnet på den externa feeden 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 har skapats 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 del), patch (Nästa korrigering), custom. Standardvärde: patch.

Anger en strategi för versionssteg. Värdet custom 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 minor, eller 0.0.1 om du anger patch. Mer information finns i specifikationen för semantisk versionshantering .

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

Anger ett anpassat versionsschema för paketet.

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

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

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

Anger mängden information som visas i utdata.

publishedPackageVar - Utdatavariabel för paket
string. Valfritt. Använd när command = publish.

Anger ett namn för variabeln som ska innehålla det publicerade paketnamnet och versionen.

Kontrollalternativ för aktivitet

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

Utdatavariabler

Inga.

Kommentarer

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 feeden måste du konfigurera det andra projektet för att bevilja läs- och 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 aktivitetsredigeraren Pipelines 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 versionera en webbapp. Om du paketerar en webbapp i ett universalpaket kan du snabbt återställa till 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 uppgiften Universal Package för att publicera hela kompilerade GatsbyJS PWA till en feed som ett versionsutfärdat universalpaket.

Ladda ned ett paket med uppgiften Universal Package

Den andra uppgiften i exempelprojektet använder uppgiften Universal Package för att hämta ett verktyg, imagemagick, från en feed 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 "universal" 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 universalpaketaktiviteten och kommandot till Download.

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

4. Välj en källfeed som innehåller verktyget, ange paketnamnet och välj Version av verktyget imagemagick från källflödet.

   

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

   

6. Universal Package-aktivitetsverktyget genererar förenklad YAML som innehåller icke-standardvärden. Kopiera den genererade YAML:en azure-pipelines.yml till filen 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 Universal Package

Det sista steget i den här exempelpipelinen använder uppgiften Universal Package för att ladda upp den produktionsklara Gatsby PWA som skapades av Run gatsby build steget till en feed som ett versionsbaserat universalpaket. En gång i en feed 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 "universal" 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 skapas av Run gatsby build steget, skapar ett versionsbaserat universellt paket och publicerar paketet i ett flöde.

   

2. Ange kommandot till Publish.

3. Ange Sökväg till filer som ska publiceras i katalogen som innehåller GatsbyJS-projektets package.json.

4. Välj en målfeed, 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 Universal Package, som sedan kan placeras i filen azure-pipelines.yml . Universal Package-uppgiftsverktyget stöder alla avancerade konfigurationer som kan skapas med universalpaketaktivitetens argument.

Anteckning

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 höja upp det till en vy.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.144.0 eller senare
Uppgiftskategori	Paket