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

Azure DevOps Services

Les packages universels vous permettent de mettre en package un nombre quelconque de fichiers de tout type et de les partager avec votre équipe. À l’aide de la tâche Universal Package dans Azure Pipelines, vous pouvez empaqueter, publier et télécharger des packages de différentes tailles, jusqu’à 4 To. Chaque package est identifié de manière unique par un nom et un numéro de version. Vous pouvez utiliser Azure CLI ou Azure Pipelines pour publier et consommer des packages à partir de vos flux Artifacts.

Notes

Les packages universels sont disponibles uniquement dans Azure DevOps Services.

Copie des fichiers

La tâche Universal Packages dans Azure Pipelines est configurée pour utiliser $(Build.ArtifactStagingDirectory) comme répertoire de publication par défaut. Pour préparer votre package universel pour la publication, déplacez les fichiers que vous souhaitez publier dans ce répertoire. Vous pouvez également utiliser la tâche d’utilitaire Copier des fichiers pour copier ces fichiers dans le répertoire de publication.

Publier un package universel

YAML

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

Argument	Description
publishDirectory	Emplacement des fichiers que vous souhaitez publier.
vstsFeedPublish	Le nom du projet et du flux sur lesquels publier. Si vous utilisez un flux à l’échelle de l’organisation, spécifiez uniquement le nom du flux.
vstsFeedPackagePublish	Nom du package. Doit être en minuscules. Utilisez uniquement des lettres, des chiffres et des tirets.
packagePublishDescription	Description du contenu du package.

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.

Classique

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.

Contrôle de version des packages

Les packages universels suivent la spécification sémantique de contrôle de version et peuvent être identifiés par leurs noms et numéros de version. Les numéros de version sémantique sont composés de trois composants numériques, Principal, Mineur et Correctif, au format : Major.Minor.Patch.

Le numéro de version mineure est incrémenté lorsque de nouvelles fonctionnalités qui sont rétrocompatibles avec les versions précédentes sont ajoutées, dans ce cas, vous incrémentez la version mineure et réinitialisez la version du correctif à 0 (1.4.17 à 1.5.0). Le numéro de version principale est incrémenté lorsqu’il existe des modifications significatives susceptibles d’interrompre la compatibilité avec les versions précédentes. Dans ce cas, vous incrémentez la version principale et réinitialisez les versions mineures et correctives à 0 (2.6.5 à 3.0.0). Le numéro de version du correctif doit être incrémenté lorsque seules des corrections de bogues ou d’autres modifications mineures sont apportées, n’affectant pas la compatibilité avec les versions précédentes (1.0.0 à 1.0.1).

Lors de la publication d’un nouveau package, la tâche Packages universels sélectionne automatiquement la version principale, mineure ou corrective suivante pour vous.

YAML

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

Argument	Description
publishDirectory	Emplacement des fichiers que vous souhaitez publier.
vstsFeedPublish	Le nom du projet et du flux sur lesquels publier. Si vous utilisez un flux à l’échelle de l’organisation, spécifiez uniquement le nom du flux.
vstsFeedPackagePublish	Nom du package. Doit être en minuscules. Utilisez uniquement des lettres, des chiffres et des tirets.
versionOption	Sélectionnez une stratégie de contrôle de version. Options : major, minor, patch, custom.
versionPublish	La version du package personnalisé.
packagePublishDescription	Description du contenu du package.

Classique

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.

Télécharger un package universel

YAML

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'

Argument	Description
vstsFeed	Le flux Artifacts hébergeant le package à télécharger.
vstsFeedPackage	Nom du package à télécharger.
vstsPackageVersion	Version du package à télécharger.
downloadDirectory	Le dossier de destination du package. Valeur par défaut : $(System.DefaultWorkingDirectory).

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

Argument	Description
feedsToUse	Définissez la valeur sur external si vous téléchargez à partir d'une source externe.
externalFeedCredentials	Nom de la connexion de service au flux externe. Pour plus d’informations, veuillez consulter la section Gérer des connexions de service.
feedDownloadExternal	Nom du flux externe.
packageDownloadExternal	Nom du package que vous souhaitez télécharger.
versionDownloadExternal	Version du package que vous souhaitez télécharger.

Classique

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.

Conseil

Vous pouvez utiliser des caractères génériques pour télécharger la dernière version d’un package universel. Pour plus d’informations, consulter Télécharger la dernière version.

Articles connexes

• Sources amont des packages universels
• Rechercher des packages dans des sources amont
• Autorisations de flux