Publier des packages universels à partir de flux Azure Artifacts

Azure DevOps Services.

Les packages universels vous permettent de stocker de nombreux types de fichiers et de contenus de package au-delà de formats tels que NuGet, npm et Python packages. Vous pouvez les publier directement à partir de la ligne de commande à l’aide de Azure CLI. Un paquet universel peut avoir une taille maximale de 4 Tio et doit inclure un nom et une version. Cet article explique comment publier un package universel dans votre flux de Azure Artifacts.

Prérequis

Installer l’extension Azure DevOps

L’extension Azure DevOps pour Azure CLI vous permet de gérer les services Azure DevOps à partir de la ligne de commande. Avant de l’installer, vérifiez que vous avez installé Azure CLI version 2.10.1 ou ultérieure.

1. Pour installer l’extension Azure DevOps, exécutez :

   az extension add --name azure-devops
   

2. Pour mettre à jour une installation existante vers la dernière version, exécutez :

   az extension update --name azure-devops
   

Créer un flux

Avant de pouvoir publier un package universel, vous avez besoin d’un flux pour le publier. Un flux est un conteneur qui stocke et organise vos packages, et vous pouvez contrôler qui peut y accéder. Procédez comme suit pour créer un flux pour votre projet ou votre organisation.

1. Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.

2. Sélectionnez Artifacts, puis sélectionnez Create feed.

3. Entrez un nom pour votre flux.

4. Choisissez une option Visibilité pour contrôler qui peut afficher vos packages.

5. Sélectionnez Inclure des packages à partir de sources publiques courantes si vous souhaitez que votre flux extraye également des packages à partir de sources publiques telles que nuget.org ou npmjs.com.

6. Pour Étendue, choisissez si le flux s’applique uniquement à votre projet ou à l’ensemble de l’organisation.

7. Sélectionnez Créer lorsque vous avez terminé.

   

Publier des packages universels

Après avoir créé votre flux, vous êtes prêt à publier un package universel sur celui-ci. Chaque package que vous publiez a besoin d’un nom et d’un numéro de version, et les deux doivent respecter des règles de nommage spécifiques :

• Le nom du package doit être minuscule, démarrer et se terminer par une lettre ou un nombre, et peut inclure uniquement des lettres, des chiffres et des tirets non consécutifs (-), des traits de soulignement (_) ou des points (.).
• La version du package doit également être en minuscules et ne peut pas contenir de métadonnées de build, indiquées par un + suffixe. Pour plus d’informations, consultez gestion sémantique des versions.

1. Exécutez l’une des commandes suivantes pour publier votre package universel, selon que votre flux est limité à un projet ou à votre organisation :

   • Flux à l'échelle du projet :

     az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
     

   • Flux à l'échelle de l'organisation :

     az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
     

Afficher les packages publiés

Après avoir publié votre package, vous pouvez confirmer qu’il est disponible dans votre flux.

1. Connectez-vous à votre organization Azure DevOps, puis accédez à votre projet.

2. Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant. Si la publication s’est terminée correctement, votre package doit être disponible dans votre flux.

   

Contenu connexe

• Télécharger des packages universels

• publier et télécharger des packages universels avec Azure Pipelines (YAML/Classic)

• Sources amont des packages universels