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 universal packages-taak in Azure Pipelines is ingesteld op gebruik $(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 hulpprogramma Bestanden kopiëren gebruiken om deze bestanden te kopiëren naar de publicatiemap.

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.
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 een kleine letter 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 de rol FeedUitgever (Inzender) hebben voor de feed. Zie Machtigingen voor pijplijnen voor 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 beheren voor meer informatie.

Klassiek

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 bestand(en) om te publiceren: het pad naar de lijst met bestanden die moeten worden gepubliceerd. Standaard: $(Build.ArtifactStagingDirectory).

• Feedlocatie: Publiceren naar 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 (als u een nieuwe versie van dat pakket wilt 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 een feeduitgever (inzender). Als uw build-pijplijn is geconfigureerd voor uitvoering met behulp van het bereik van de projectverzameling, voegt u de projectverzamelingsservice-identiteit toe als feedfeeduitgever (inzender).

Als uw build-pijplijn is geconfigureerd voor uitvoering met projectbereik, moet de Project Build Service-identiteit toegang 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 feedmachtigingen voor 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 beheren voor 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 volgende 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.

custom Als u deze optie 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.0 hebt en de primaire optie selecteert, wordt uw nieuwe pakket testPackage 2.0.0. Als u de secundaire optie selecteert, is uw pakketversie 1.1.0 en als u de patchoptie selecteert, is uw pakketversie 1.0.1.

Als u de custom optie kiest, moet u ook als volgt een versionPublish waarde 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 een kleine letter zijn. Gebruik alleen letters, cijfers en streepjes.
versionOption	Selecteer een versiebeheerstrategie. Opties: major, minor, , patch. custom
versionPublish	De aangepaste pakketversie.
packagePublishDescription	Beschrijving van de pakketinhoud.

Klassiek

Selecteer in het taakformulier Universal Packages een versiebeheerstrategie of selecteer Aangepast 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 download opdracht 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'

Argument	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
feedsToUse	Stel de waarde in op external bij het downloaden van een externe bron.
externalFeedCredentials	Naam van de serviceverbinding met de externe feed. Zie Serviceverbindingen beheren voor meer informatie.
feedDownloadExternal	Naam van de externe feed.
packageDownloadExternal	De pakketnaam die u wilt downloaden.
versionDownloadExternal	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).
• Feedlocatie: Download een universeel pakket uit een feed in uw organisatie of in een andere organisatie.
• Feed: de feed waaruit u wilt downloaden.
• Pakketnaam: de 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 De nieuwste versie downloaden voor meer informatie.

Verwante artikelen:

• Universal Packages upstream-bronnen
• Pakketten zoeken in upstream-bronnen
• Feedmachtigingen