Publier et télécharger des packages universels avec Azure Pipelines

Pour publier un package universel dans votre flux Azure Artifacts, ajoutez la tâche suivante au fichier YAML de votre pipeline.

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

Pour publier des packages sur un flux Azure Artifacts à partir de votre pipeline, l’identité du pipeline doit avoir le rôle Éditeur de flux (Contributeur) sur le flux. Pour plus d’informations, consultez Autorisations des pipelines.

Pour publier sur un flux externe, vous devez d’abord créer une connexion de service pour vous authentifier auprès de votre flux. Pour plus d’informations, veuillez consulter la section Gérer la connexion au service.

Pour publier votre package universel, ajoutez la tâche Package universel à votre pipeline et remplissez les champs obligatoires comme suit :

• Commande : Publier

• Chemin d’accès au(x) fichier(s) à publier : le chemin d’accès à la liste des fichiers à publier. Par défaut : $(Build.ArtifactStagingDirectory).

• Emplacement du flux : publiez sur un flux Azure Artifacts dans votre organisation actuelle ou dans une autre organisation.

• Flux de destination : sélectionnez le flux dans lequel vous souhaitez publier.

• Nom du package : sélectionnez un package existant (pour publier une nouvelle version de ce package) ou entrez un nouveau nom de package (pour publier la première version d’un nouveau package).

  

Pour publier des packages sur un flux Azure Artifacts à partir de votre pipeline, définissez l’identité sous laquelle la build s’exécute en tant que Éditeur de flux (contributeur). Si votre pipeline de build est configuré pour s’exécuter à l’aide de l’étendue de collection de projets, ajoutez l’identité Service de build de la collection de projets en tant que Éditeur de flux (contributeur) sur le flux.

Si votre pipeline de build est configuré pour s’exécuter à l’échelle du projet, l’identité du service de build du projet doit avoir un accès contributeur au flux. Vous pouvez vérifier l’étendue dans laquelle vos builds s’exécutent en ouvrant l’éditeur de pipeline et en vérifiant l’onglet Options. Pour plus d’informations sur les autorisations de flux, consultez Gérer les packages avec des autorisations de flux.

Pour publier sur un flux externe, vous devez d'abord créer une connexion de service qui pointe vers ce flux. Pour plus d’informations, veuillez consulter la section Gérer la connexion au service.

Pour activer le contrôle de version pour votre package, ajoutez une entrée versionOption à votre fichier YAML. Les options de publication d’une nouvelle version de package sont les suivantes : major, minor, patch ou custom.

Sélectionner custom vous permet de spécifier manuellement la version de votre package. Les autres options permettent d’obtenir la dernière version du package à partir de votre flux et d’incrémenter le segment de version choisi de 1. Par conséquent, si vous avez un testPackage 1.0.0et sélectionnez l’option principale, votre nouveau package sera testPackage 2.0.0. Si vous sélectionnez l’option mineur, la version de votre package est 1.1.0et, si vous sélectionnez l’option correctif, la version de votre package est 1.0.1.

Si vous choisissez l’option custom, vous devez également spécifier une valeur versionPublish comme suit :

- 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>'

Dans le formulaire de tâche Packages universels, sélectionnez une stratégie de contrôle de version ou sélectionnez Personnalisé pour entrer manuellement votre version de package.

Pour télécharger un package universel à partir d’un flux dans votre organisation, utilisez la tâche package universel avec la commande download comme suit :

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

Pour télécharger un package universel à partir d’une source externe, utilisez l’extrait de code suivant :

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

Pour télécharger un package universel, ajoutez la tâche package universel à votre pipeline et remplissez les champs requis comme suit :

• Commande : Télécharger
• Répertoire de destination : chemin d’accès au dossier où les packages seront téléchargés. Valeur par défaut : $(System.DefaultWorkingDirectory).
• Emplacement du flux : téléchargez un package universel à partir d’un flux dans votre organisation ou dans une autre organisation.
• Flux : flux à partir duquel vous souhaitez télécharger.
• Nom du package : nom du package à télécharger.
• Version : version du package que vous souhaitez télécharger.