UniversalPackages@0 - Universele pakketten v0-taak

Gebruik deze taak om Universal Packages 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.

Ingangen

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

Hiermee geeft u de opdracht Universal Package uit te voeren.

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.

locatie van feedsToUse - 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 op.

externalFeedCredentials - organisatie-/verzamelingsverbinding
Invoeralias: externalEndpoint. string. Facultatief. Gebruiken 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 selecteren. Hiermee geeft u de FeedName- voor een feed met organisatiebereik en projectName/FeedName of ProjectID/FeedID- voor een feed met projectbereik.

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 die de versie bevat die moet worden gedownload. Deze vermelding kan ook een expressie met jokertekens zijn, zoals *, om de hoogste versie op te halen. Voorbeelden: 1.* krijgt de hoogste versie 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 worden Project/Feed, waarbij Project de naam of id van het project is en Feed de naam/id van de feed is. Voor feeds binnen het bereik van de organisatie mag de waarde alleen de naam van de feed zijn.

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

Hiermee geeft u de pakketnaam die moet worden gedownload.

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

Hiermee geeft u de pakketversie op of gebruikt u een variabele die de versie bevat die moet worden gedownload. Deze vermelding kan ook een expressie met jokertekens zijn, zoals *, om de hoogste versie op te halen. Voorbeelden: 1.* krijgt de hoogste versie met primaire versie 1 en 1.2.* krijgt de hoogste patchrelease met primaire versie 1 en secundaire versie 2. Jokertekenpatronen worden niet ondersteund met voorlopige pakketten.

publishDirectory - pad naar een of meer bestanden om te publiceren
string. Vereist wanneer command = publish. Standaardwaarde: $(Build.ArtifactStagingDirectory).

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

locatie van feedsToUsePublish - 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 op.

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

Hiermee geeft u de referenties 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 waarnaar u wilt publiceren.

publishPackageMetadata - metagegevens van pijplijn publiceren
boolean. Facultatief. Gebruiken wanneer command = publish && internalOrExternalPublish = internal. Standaardwaarde: true.

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

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

Hiermee geeft u een pakket-id op om een nieuwe pakket-id te publiceren of te maken als u nog nooit een versie van dit pakket hebt gepubliceerd. Pakketnamen moeten kleine letters zijn en mogen alleen letters, cijfers en streepjes (-) gebruiken.

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 te publiceren naar.

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

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

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

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

Hiermee geeft u een strategie voor incrementele versie op. De custom waarde voor het handmatig invoeren van uw pakketversie. Voor nieuwe pakketten is de eerste versie 1.0.0 als u major, 0.1.0 opgeeft als u minoropgeeft of 0.0.1 als u patchopgeeft. Zie de semantische versiebeheerspecificatie 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. Facultatief. Gebruiken wanneer command = publish.

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

verbosity - uitgebreidheids-
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 - pakketuitvoervariabele
string. Facultatief. Gebruiken wanneer command = publish.

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

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om Universal Packages te downloaden of te verpakken en te publiceren.

Mijn pijplijn moet toegang krijgen 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 aan 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 azure-pipelines.yml-bestand van uw project. In dit voorbeeld ziet u hoe u de YAML snel 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 te inkapselen en versieren. Als u een web-app in een universeel pakket verpakt, kunt u snel terugdraaien naar een specifieke versie van uw site en hoeft u de site niet meer te bouwen in de implementatiepijplijn.

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

Een pakket downloaden met de universal package-taak

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 buildstap om het formaat van afbeeldingen 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 universele pakkettaak en de opdracht om Downloadte Download.

3. Kies de doelmap te gebruiken voor het downloaden van het hulpprogramma.

4. Selecteer een bron-Feed- die het hulpprogramma bevat, stel de pakketnaam inen kies versie van het hulpprogramma imagemagick uit de bron-Feed-.

   

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

   

6. De Universal Package taakbouwer genereert vereenvoudigde YAML die niet-standaardwaarden bevat. Kopieer de gegenereerde YAML naar het 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 universele pakkettaak

In de laatste stap in deze voorbeeldpijplijn wordt de Universal Package-taak gebruikt om de gatsby PWA die gereed is voor productie te uploaden die door de Run gatsby build stap naar een feed is geproduceerd als een geversied Universeel pakket. Eenmaal in een feed hebt u een permanente kopie van uw volledige site die kan worden geïmplementeerd voor 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 te klikken op de knop Toevoegen om de taak toe te voegen aan uw pijplijn. Met deze taak worden alle assets verzameld die gereed zijn voor productie die door de Run gatsby build stap zijn geproduceerd, een versie van universeel pakket produceren en het pakket publiceren naar een feed.

   

2. Stel de opdracht in op Publish.

3. Stel pad naar een of meer bestanden in om te publiceren naar de map met de package.jsonvan uw GatsbyJS-project.

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 het azure-pipelines.yml-bestand zoals voorheen. Hieronder wordt de YAML voor dit voorbeeldproject 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 ziet u hoe u de opbouwfunctie voor pijplijnen gebruikt om snel de YAML te genereren voor de Universal Package-taak, 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 Universal Package taakargumenten.

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.

Eisen

Eis	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Enig
variabelen instellen	Enig
Agentversie	2.144.0 of hoger
Taakcategorie	Pak