Publier et télécharger des packages universels dans Azure Artifacts
Azure DevOps Services
Les packages universels permettent aux développeurs de stocker un large éventail de types de packages au-delà des types traditionnels tels que NuGet, npm, packages Python, etc. À l’aide d’Azure CLI, vous pouvez publier et télécharger des packages universels directement à partir de la ligne de commande. Bien que la taille des packages publiés puisse varier, atteindre jusqu’à 4 To, elles doivent toujours maintenir l’exigence essentielle d’inclusion d’un nom et d’un numéro de version. Cet article vous guide tout au long des étapes de publication et de téléchargement des packages universels à partir de votre flux Azure Artifacts.
Prérequis
Un organization Azure DevOps et un projet. Créez un organization ou un projet si ce n’est pas déjà fait.
Installez l’extension Azure DevOps version 0.14.0 ou ultérieure.
Créer un flux
Si vous disposez déjà d’un flux, vous pouvez passer à la section suivante. Dans le cas contraire, suivez les étapes ci-dessous pour créer un flux Azure Artifacts :
Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Créer un flux.
Fournissez un nom descriptif pour votre flux et définissez sa visibilité (qui peut afficher les packages dans votre flux). Définissez l’étendue de votre flux, puis sélectionnez les sources en amont case activée box si vous souhaitez inclure des packages à partir de registres publics.
Sélectionnez Créer lorsque vous avez terminé.
Remarque
Par défaut, les flux nouvellement créés désignent le rôle Service de build du projet en tant que Flux et Lecteur en amont (Collaborateur).
Installer l’extension Azure DevOps
L’utilisation de l’interface CLI permet de simplifier vos tâches. Avant de continuer, vérifiez que vous avez installé Azure CLI (version 2.10.1 ou ultérieure). En outre, nous devons installer l’extension Azure DevOps pour gérer les services Azure DevOps à partir de la ligne de commande.
Exécutez la commande suivante pour installer l’extension Azure DevOps :
az extension add --name azure-devops
Si l’extension Azure DevOps est déjà installée et que vous souhaitez la mettre à jour vers la dernière version, exécutez la commande suivante :
az extension update --name azure-devops
Se connecter au flux
Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Connecter à alimenter, puis sélectionnez Packages universels dans le volet de navigation gauche.
Suivez les instructions de la section Configuration de Project pour vous connecter à votre flux.
Exécutez la commande suivante pour vous connecter à Azure CLI :
az login
Exécutez la commande suivante pour définir votre projet et votre organisation comme configuration par défaut de l’interface CLI :
az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME>
Publier des packages universels
Pour publier un package universel dans votre flux, vous devez fournir un nom de package et un numéro de version.
Le nom du package doit être en minuscules, démarrer et se terminer par des lettres ou des chiffres, et contenir uniquement des lettres, des chiffres et des tirets non décochables, des traits de soulignement et des points. La version du package doit également être en minuscules et ne doit pas inclure de métadonnées de build (suffixe+). Pour plus d’informations, consultez le contrôle de version sémantique.
Exécutez la commande suivante pour publier votre package universel sur votre flux :
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>
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>
Remarque
Si votre organisation utilise un pare-feu ou un serveur proxy, veillez à autoriser les URL et adresses IP du domaine Azure Artifacts.
Afficher les packages publiés
Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant. Une fois le processus de publication terminé, votre package doit être disponible dans votre flux.
Télécharger des packages universels
Exécutez la commande suivante pour télécharger un package universel particulier à partir de votre flux à l’aide d’Azure CLI :
Flux à l'échelle de l'organisation :
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
Flux à l'échelle du projet :
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
Télécharger des fichiers spécifiques
Si vous souhaitez télécharger uniquement des fichiers spécifiques, utilisez le --file-filter
paramètre pour extraire un sous-ensemble de fichiers. Pour plus d’informations, consultez les modèles de correspondance de fichier.
Flux à l'échelle de l'organisation :
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
Flux à l'échelle du projet :
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
Exemple : par exemple, l’utilisation de journaux --file-filter/.log correspond à n’importe quel fichier avec un nom de fichier contenant « journaux » et se terminant par l’extension « .log » (par exemple, build_logs.log).
Télécharger la version la plus récente
Vous pouvez utiliser des carte *
génériques pour télécharger la dernière version de vos packages universels.
Exemples :
--version '*'
: téléchargez la dernière version.--version '1.*'
: téléchargez la dernière version avec la version majeure 1.--version '1.2.*'
: téléchargez la dernière version du correctif avec la version majeure 1 et mineure 2.
Remarque
Les modèles wild carte ne sont pas pris en charge avec les versions préliminaires (packages avec un tiret dans leur numéro de version).