UniversalPackages@0 - Universele pakketten v0-taak

Gebruik deze taak om Universele pakketten te downloaden of te verpakken en te publiceren.

Syntaxis

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

Invoerwaarden

command - Opdracht
string. Vereist. Toegestane waarden: download, publish. Standaardwaarde: download.

Hiermee geeft u de NuGet-opdracht moet worden uitgevoerd.

downloadDirectory - Doelmap
string. Vereist wanneer command = download. Standaardwaarde: $(System.DefaultWorkingDirectory).

Hiermee geeft u het mappad op waar de taak de inhoud van het pakket downloadt.

feedsToUse - Locatie van feed
Invoeralias: internalOrExternalDownload. string. Vereist wanneer command = download. Toegestane waarden: internal (Deze organisatie/verzameling), external (Een andere organisatie/verzameling). Standaardwaarde: internal.

Hiermee geeft u een feed van deze verzameling of een andere verzameling in Azure Artifacts.

externalFeedCredentials - organisatie-/verzamelingsverbinding
Invoeralias: externalEndpoint. string. Optioneel. Gebruik wanneer internalOrExternalDownload = external && command = download.

Hiermee geeft u de referenties op die moeten worden gebruikt voor externe registers die zich in de geselecteerde NuGet.configbevinden. Laat dit leeg voor feeds in deze organisatie of verzameling. de referenties van de build worden automatisch gebruikt.

vstsFeed - Feed
Invoeralias: feedListDownload. string. Vereist wanneer internalOrExternalDownload = internal && command = download.

Bevat de geselecteerde feed. U moet Azure Artifacts hebben geïnstalleerd en een licentie hebben om hier een feed te kunnen selecteren. Hiermee geeft u de FeedName voor een feed binnen organisatiebereik en projectName/FeedName of ProjectID/FeedID voor een project-scoped feed.

vstsFeedPackage - Pakketnaam
Invoeralias: packageListDownload. string. Vereist wanneer internalOrExternalDownload = internal && command = download.

Hiermee geeft u de naam van het pakket voor de taak te downloaden.

vstsPackageVersion - Versie
Invoeralias: versionListDownload. string. Vereist wanneer internalOrExternalDownload = internal && command = download.

Hiermee geeft u de pakketversie op of gebruikt u een variabele met de versie die moet worden gedownload. Dit item kan ook een expressie met jokertekens zijn, zoals *, om de hoogste versie op te halen. Voorbeelden: 1.* haalt de hoogste versie op met primaire versie 1 en 1.2.* krijgt de hoogste patchrelease met primaire versie 1 en secundaire versie 2.

feedDownloadExternal - Feed (of Project/feed als de feed is gemaakt in een project)
string. Vereist wanneer internalOrExternalDownload = external && command = download.

Hiermee geeft u een feed in een andere organisatie/verzameling.

Voor feeds met projectbereik moet de waarde zijn Project/Feed, waarbij Project de naam of id van het project is en Feed de naam/id van de feed. Voor feeds binnen organisatiebereik mag de waarde alleen de naam van de feed zijn.

packageDownloadExternal - Pakketnaam
string. Vereist wanneer internalOrExternalDownload = external && command = download.

Hiermee geeft u de pakketnaam te downloaden.

versionDownloadExternal - Versie
string. Vereist wanneer internalOrExternalDownload = external && command = download.

Hiermee geeft u de pakketversie op of gebruikt u een variabele met de versie die moet worden gedownload. Dit item kan ook een expressie met jokertekens zijn, zoals *, om de hoogste versie op te halen. Voorbeelden: 1.* haalt de hoogste versie op met primaire versie 1 en 1.2.* krijgt de hoogste patchrelease met primaire versie 1 en secundaire versie 2. Jokertekenpatronen worden niet ondersteund met pre-releasepakketten.

publishDirectory - Pad naar te publiceren bestanden
string. Vereist wanneer command = publish. Standaardwaarde: $(Build.ArtifactStagingDirectory).

Hiermee geeft u het pad naar de lijst met bestanden die moeten worden gepubliceerd.

feedsToUsePublish - Locatie van feed
Invoeralias: internalOrExternalPublish. string. Vereist wanneer command = publish. Toegestane waarden: internal (Deze organisatie/verzameling), external (Een andere organisatie/verzameling). Standaardwaarde: internal.

Hiermee geeft u een feed van deze verzameling of een andere verzameling in Azure Artifacts.

publishFeedCredentials - organisatie-/verzamelingsverbinding
Invoeralias: externalEndpoints. string. Vereist wanneer internalOrExternalPublish = external && command = publish.

Hiermee geeft u de referenties op die moeten worden gebruikt voor externe feeds.

vstsFeedPublish - Doelfeed
Invoeralias: feedListPublish. string. Vereist wanneer internalOrExternalPublish = internal && command = publish.

Hiermee geeft u het project en de naam/GUID van de feed naar te publiceren.

publishPackageMetadata - Metagegevens van pijplijn publiceren
boolean. Optioneel. Gebruik wanneer command = publish && internalOrExternalPublish = internal. Standaardwaarde: true.

Koppelt de metagegevens van deze build/release-pijplijn (zoals run # en broncode-informatie) aan het pakket.

vstsFeedPackagePublish - Pakketnaam
Invoeralias: packageListPublish. string. Vereist wanneer internalOrExternalPublish = internal && command = publish.

Hiermee geeft u een pakket-id te publiceren of maakt u een nieuwe pakket-id als u nog nooit een versie van dit pakket hebt gepubliceerd. Pakketnamen moeten uit kleine letters bestaan en mogen alleen letters, cijfers en streepjes (-) bevatten.

feedPublishExternal - Feed (of Project/feed als de feed is gemaakt in een project)
string. Vereist wanneer internalOrExternalPublish = external && command = publish.

Hiermee geeft u de naam van de externe feed naar te publiceren.

Als de feed in een project is gemaakt, moet de waarde zijn Project/Feed, waarbij Project de naam of id van het project is en Feed de naam van de feed. Als de feed niet in een project is gemaakt, moet de waarde alleen de naam van de feed zijn.

packagePublishExternal - Pakketnaam
string. Vereist wanneer internalOrExternalPublish = external && command = publish.

Hiermee geeft u de pakketnaam bij het publiceren naar een externe feed.

versionOption - Versie
Invoeralias: versionPublishSelector. string. Vereist wanneer command = publish. Toegestane waarden: major (Volgende primaire), minor (Volgende secundaire versie), patch (Volgende patch), custom. Standaardwaarde: patch.

Hiermee geeft u een strategie voor het verhogen van de versie op. De custom waarde voor het handmatig invoeren van uw pakketversie. Voor nieuwe pakketten is de eerste versie 1.0.0 als u opgeeft major, 0.1.0 als u opgeeft minorof 0.0.1 als u opgeeft patch. Zie de specificatie Semantic Versioning (Semantic Versioning) voor meer informatie.

versionPublish - Aangepaste versie
string. Vereist wanneer versionPublishSelector = custom && command = publish.

Hiermee geeft u een aangepast versieschema voor het pakket.

packagePublishDescription - Beschrijving
string. Optioneel. Gebruik wanneer command = publish.

Hiermee geeft u de beschrijving van de inhoud van het pakket en/of de wijzigingen die zijn aangebracht in deze versie van het pakket.

verbosity - Uitgebreidheid
string. Toegestane waarden: None, Trace, Debug, Information, Warning, Error, . Critical Standaardwaarde: None.

Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.

publishedPackageVar - Uitvoervariabele van pakket
string. Optioneel. Gebruik wanneer command = publish.

Hiermee geeft u een naam voor de variabele die de gepubliceerde pakketnaam en versie bevat.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om Universele pakketten te downloaden of te verpakken en te publiceren.

Mijn pijplijn moet toegang hebben tot een feed in een ander project

Als de pijplijn wordt uitgevoerd in een ander project dan het project dat als host fungeert voor de feed, moet u het andere project instellen om lees-/schrijftoegang te verlenen tot de buildservice. Zie Pakketmachtigingen in Azure Pipelines voor meer informatie.

Voorbeelden

De eenvoudigste manier om aan de slag te gaan met de Universal Package-taak is door de taakeditor Pijplijnen te gebruiken om de YAML te genereren. Vervolgens kunt u de gegenereerde code kopiëren naar het bestand van azure-pipelines.yml uw project. In dit voorbeeld laat het voorbeeld zien hoe u snel de YAML kunt genereren met behulp van een pijplijn waarmee een GatsbyJS progressive web app (PWA) wordt gebouwd.

Universele pakketten zijn een handige manier om een web-app in te kapselen en te versien. Door een web-app in een universeel pakket te verpakken, kunt u snel terugdraaien naar een specifieke versie van uw site en hoeft u de site niet te bouwen in de implementatiepijplijn.

In deze voorbeeldpijplijn ziet u hoe u een hulpprogramma ophaalt uit een feed in uw project. De taak Universeel pakket wordt gebruikt om het hulpprogramma te downloaden, een build uit te voeren en gebruikt opnieuw de taak Universeel pakket om de volledige gecompileerde GatsbyJS PWA naar een feed te publiceren als een versie van universeel pakket.

Een pakket downloaden met de taak Universeel pakket

De tweede taak in het voorbeeldproject maakt gebruik van de universal package-taak om een hulpprogramma, imagemagick, op te halen uit een feed die zich binnen een ander project in dezelfde organisatie bevindt. Het hulpprogramma, imagemagick, is vereist voor de volgende build-stap om het formaat van installatiekopieën te wijzigen.

1. Voeg de taak Universeel pakket toe door op het pluspictogram te klikken, 'universeel' in het zoekvak te typen en op de knop Toevoegen te klikken om de taak toe te voegen aan uw pijplijn.

   

2. Klik op de zojuist toegevoegde universal package-taak en de opdracht op Download.

3. Kies de doelmap die u wilt gebruiken voor het downloaden van het hulpprogramma.

4. Selecteer een bronfeed die het hulpprogramma bevat, stel de pakketnaam in en kies Versie van het hulpprogramma imagemagick in de bronfeed.

   

5. Nadat u de velden hebt voltooid, klikt u op YAML weergeven om de gegenereerde YAML weer te geven.

   

6. De opbouwfunctie voor universal package genereert vereenvoudigde YAML die niet-standaardwaarden bevat. Kopieer de gegenereerde YAML naar uw azure-pipelines.yml bestand in de hoofdmap van de Git-opslagplaats van uw project.

   # 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
   

Een pakket publiceren met de taak Universeel pakket

In de laatste stap in deze voorbeeldpijplijn wordt de taak Universeel pakket gebruikt om de productieklare Gatsby PWA die door de Run gatsby build stap is geproduceerd, te uploaden naar een feed als een universeel pakket met versie. Eenmaal in een feed hebt u een permanente kopie van uw volledige site die kan worden geïmplementeerd naar de hostingprovider en die kan worden gestart met gatsby serve.

1. Voeg nog een universele pakkettaak toe aan het einde van de pijplijn door op het pluspictogram te klikken, 'universeel' in het zoekvak te typen en op de knop Toevoegen te klikken om de taak toe te voegen aan uw pijplijn. Deze taak verzamelt alle productieklare assets die door de Run gatsby build stap zijn geproduceerd, produceert een universeel pakket met versie en publiceert het pakket naar een feed.

   

2. Stel de opdracht in op Publish.

3. Stel Pad in naar bestand(en) om te publiceren naar de map met de van uw GatsbyJS-project package.json.

4. Kies een doelfeed, een pakketnaam en stel uw versiebeheerstrategie in.

   

5. Nadat u de vereiste velden hebt voltooid, klikt u op YAML weergeven.

6. Kopieer de resulterende YAML naar uw azure-pipelines.yml bestand zoals voorheen. De YAML voor dit voorbeeldproject wordt hieronder weergegeven.

   # 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 dit voorbeeld is gedemonstreerd hoe u de opbouwfunctie voor pijplijnen gebruikt om snel de YAML voor de universele pakkettaak te genereren, die vervolgens in uw azure-pipelines.yml bestand kan worden geplaatst. De opbouwfunctie voor universal package-taken ondersteunt alle geavanceerde configuraties die kunnen worden gemaakt met de argumenten van de universal package-taak .

Notitie

Het rechtstreeks publiceren van een pakket naar een weergave wordt niet ondersteund in Azure Artifacts. U moet het pakket eerst publiceren naar uw feed en het vervolgens promoveren naar een weergave.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.144.0 of hoger
Taakcategorie	Pakket