Universele pakketten publiceren en downloaden met Azure Pipelines

Azure DevOps Services-

Met Universal Packages kunt u een willekeurig aantal bestanden van elk type verpakken en delen met uw team. Met behulp van de Universal Package-taak in Azure Pipelines kunt u pakketten van verschillende grootten inpakken, publiceren en downloaden, tot 4 TB. Elk pakket wordt uniek geïdentificeerd met een naam en een versienummer. U kunt Azure CLI of Azure Pipelines gebruiken om pakketten te publiceren en te gebruiken vanuit uw Artifacts-feeds.

Notitie

Universele pakketten zijn alleen beschikbaar in Azure DevOps Services.

Bestanden kopiëren

De taak Universal Packages in Azure Pipelines is ingesteld op gebruik van $(Build.ArtifactStagingDirectory) als de standaardpubliceermap. Als u uw Universal Package wilt voorbereiden voor publicatie, verplaatst u de bestanden die u naar die map wilt publiceren. U kunt ook de taak Bestanden kopiëren hulpprogramma gebruiken om deze bestanden naar de publicatiemap te kopiëren.

Een universeel pakket publiceren

YAML

Als u een universeel pakket wilt publiceren naar uw Azure Artifacts-feed, voegt u de volgende taak toe aan het YAML-bestand van uw pijplijn.

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    packagePublishDescription: '<Package description>'

Argument	Beschrijving
publishDirectory	Locatie van de bestanden die u wilt publiceren.
vstsFeedPubliceren	De naam van het project en de feed waar u naar wilt publiceren. Als u met een feed met organisatiebereik werkt, geeft u alleen de naam van de feed op.
vstsFeedPackagePublish	De pakketnaam. Moet met kleine letters zijn. Gebruik alleen letters, cijfers en streepjes.
packagePublishDescription	Beschrijving van de pakketinhoud.

Als u pakketten vanuit uw pijplijn wilt publiceren naar een Azure Artifacts-feed, moet de pijplijnidentiteit over de rol Feed Publisher (Inzender) beschikken in de feed. Zie Pijplijnmachtigingenvoor meer informatie.

Als u wilt publiceren naar een externe feed, moet u eerst een serviceverbinding maken om te verifiëren met uw feed. Zie Serviceverbinding beherenvoor meer informatie.

Klassieke

Als u uw Universal Package wilt publiceren, voegt u de Universal Package- taak toe aan uw pijplijn en vult u de vereiste velden als volgt in:

• Opdracht: Publiceren

• pad naar een of meer bestanden die moeten worden gepubliceerd: het pad naar de lijst met bestanden die moeten worden gepubliceerd. Standaard: $(Build.ArtifactStagingDirectory).

• Feedlocatie: Publiceren op een Azure Artifacts-feed in uw huidige organisatie of in een andere organisatie.

• doelfeed: selecteer de feed waarnaar u wilt publiceren.

• pakketnaam: Selecteer een bestaand pakket (om een nieuwe versie van dat pakket te publiceren) of voer een nieuwe pakketnaam in (om de eerste versie van een nieuw pakket te publiceren).

  

Als u pakketten vanuit uw pijplijn wilt publiceren naar een Azure Artifacts-feed, stelt u de identiteit in waaronder de build wordt uitgevoerd als Feed Publisher (Inzender). Als uw build-pijplijn is geconfigureerd voor uitvoering met behulp van het bereik van de projectverzameling, voegt u de Project Collection Build Service identiteit toe als feed Feed Publisher (Inzender).

Als uw build-pijplijn is geconfigureerd voor uitvoering met projectbereik, moet de Project Build Service identiteit inzendertoegang krijgen tot de feed. U kunt het bereik controleren waarin uw builds worden uitgevoerd door de pijplijneditor te openen en het tabblad Opties te controleren. Zie pakketten beheren met feedmachtigingenvoor meer informatie over feedmachtigingen.

Als u naar een externe feed wilt publiceren, moet u eerst een serviceverbinding maken om naar die feed te verwijzen. Zie Serviceverbinding beherenvoor meer informatie.

Pakketversiebeheer

Universal Packages volgen de semantische versiebeheerspecificatie en kunnen worden geïdentificeerd door hun namen en versienummers. Semantische versienummers bestaan uit drie numerieke onderdelen, Major, Minor en Patch, in de notatie: Major.Minor.Patch.

Het secundaire versienummer wordt verhoogd wanneer nieuwe functies worden toegevoegd die compatibel zijn met eerdere versies. In dit geval gaat u de secundaire versie verhogen en de patchversie opnieuw instellen op 0 (1.4.17 naar 1.5.0). Het primaire versienummer wordt verhoogd wanneer er aanzienlijke wijzigingen zijn die de compatibiliteit met eerdere versies kunnen verbreken. In dit geval gaat u de primaire versie verhogen en de secundaire en patchversies opnieuw instellen op 0 (2.6.5 naar 3.0.0). Het versienummer van de patch moet worden verhoogd wanneer alleen bugfixes of andere kleine wijzigingen worden aangebracht die geen invloed hebben op de compatibiliteit met eerdere versies (1.0.0 naar 1.0.1).

Wanneer u een nieuw pakket publiceert, selecteert de taak Universal Packages automatisch de volgende primaire, secundaire of patchversie voor u.

YAML

Als u versiebeheer voor uw pakket wilt inschakelen, voegt u een versionOption invoer toe aan uw YAML-bestand. De opties voor het publiceren van een nieuwe pakketversie zijn: major, minor, patchof custom.

Als u custom selecteert, kunt u de pakketversie handmatig opgeven. De andere opties krijgen de nieuwste pakketversie van uw feed en verhogen het gekozen versiesegment met 1. Dus als u een testPackage 1.0.0hebt en de primaire optie selecteert, wordt uw nieuwe pakket testPackage 2.0.0. Als u de optie secundaire selecteert, wordt uw pakketversie 1.1.0en als u de optie patch selecteert, wordt uw pakketversie 1.0.1.

Als u de optie custom kiest, moet u ook een versionPublish waarde als volgt opgeven:

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    versionOption: custom
    versionPublish: '<Package version>'
    packagePublishDescription: '<Package description>'

Argument	Beschrijving
publishDirectory	Locatie van de bestanden die u wilt publiceren.
vstsFeedPublish	De naam van het project en de feed waar u naar wilt publiceren. Als u met een feed met organisatiebereik werkt, geeft u alleen de naam van de feed op.
vstsFeedPackagePublish	De pakketnaam. Moet met een kleine letter zijn. Gebruik alleen letters, cijfers en streepjes.
versieOptie	Selecteer een versiebeheerstrategie. Opties: major, minor, patch, custom.
versiePubliceer	De aangepaste pakketversie.
pakketPublicatieBeschrijving	Beschrijving van de pakketinhoud.

Klassieke

Selecteer in het taakformulier Universal Packages een versiebeheerstrategie of selecteer Aangepaste om uw pakketversie handmatig in te voeren.

Een universeel pakket downloaden

YAML

Als u een universeel pakket wilt downloaden van een feed in uw organisatie, gebruikt u de taak Universal Package met de opdracht download als volgt:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    vstsFeed: '<projectName>/<feedName>'
    vstsFeedPackage: '<packageName>'
    vstsPackageVersion: '<packageVersion>'
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'

Discussie	Beschrijving
vstsFeed	De Artifacts-feed die als host fungeert voor het pakket dat moet worden gedownload.
vstsFeedPackage	De naam van het pakket dat moet worden gedownload.
vstsPackageVersion	Versie van het pakket dat moet worden gedownload.
downloadDirectory	De doelmap van het pakket. Standaardwaarde: $(System.DefaultWorkingDirectory).

Als u een universeel pakket wilt downloaden van een externe bron, gebruikt u het volgende codefragment:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    feedsToUse: external
    externalFeedCredentials: 'MSENG2'
    feedDownloadExternal: 'fabrikamFeedExternal'
    packageDownloadExternal: 'fabrikam-package'
    versionDownloadExternal: 1.0.0

Argument	Beschrijving
feedsOmTeGebruiken	Stel de waarde in op external bij het downloaden van een externe bron.
externalFeedCredentials	Naam van de serviceverbinding met de externe feed. Zie voor meer informatie serviceverbindingen beheren.
feedDownloadExternal	Naam van de externe feed.
packageDownloadExternal	De pakketnaam die u wilt downloaden.
versieDownloadExtern	De versie van het pakket dat u wilt downloaden.

Klassiek

Als u een Universeel pakket wilt downloaden, voegt u de Universal Package- taak toe aan uw pijplijn en vult u de vereiste velden als volgt in:

• Opdracht: Downloaden
• doelmap: mappad waar de pakketten worden gedownload. Standaardwaarde: $(System.DefaultWorkingDirectory).
• locatie van feed: Een universeel pakket downloaden van een feed in uw organisatie of in een andere organisatie.
• feed: de feed waaruit u wilt downloaden.
• pakketnaam: naam van het pakket dat moet worden gedownload.
• versie: de versie van het pakket dat u wilt downloaden.

Tip

U kunt jokertekens gebruiken om de nieuwste versie van een Universal Package te downloaden. Zie Download de nieuwste versievoor meer informatie.

Verwante artikelen

• Universal Packages upstream-bronnen
• Zoeken naar pakketten in upstream-bronnen
• Feedmachtigingen