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

Avec les packages universels, vous pouvez stocker différents types de packages autres que ceux couramment utilisés tels que les packages NuGet, npm, Maven ou Python. À l’aide d’Azure CLI, vous pouvez publier et télécharger des packages universels à partir de la ligne de commande. Les packages chargés peuvent varier en taille (jusqu’à 4 To), mais doivent toujours avoir un nom et un numéro de version. Cet article vous guide tout au long des étapes de publication et de téléchargement de vos packages universels pour Azure Artifacts flux.

Prérequis

  1. Installez l’interface de ligne de commande Azure.
  2. Si vous utilisez Linux, veillez à installer . NET sur la version linux.
  3. Azure DevOps Services compte.
  4. flux Azure Artifacts.

Configuration de la connexion

  1. Pour vérifier la version des modules et extensions Azure CLI dont vous disposez actuellement, exécutez la commande suivante :

    az --version
    
  2. Installez l’extension Azure DevOps.

    az extension add --name azure-devops
    
  3. Si vous disposez déjà de l’extension Azure DevOps, mais que vous souhaitez effectuer une mise à jour vers la dernière version, exécutez la commande suivante :

    az extension update --name azure-devops
    
  4. Connectez-vous à Azure.

    az login
    

Conseil

Pour accéder aux locataires sans abonnements, exécutez az login --allow-no-subscription.

  1. Définissez votre projet et votre organisation comme valeur 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, exécutez la commande suivante dans une invite de commandes avec élévation de privilèges. Les noms de package doivent être en minuscules, commencer et se terminer par des lettres ou des chiffres, et contenir uniquement des lettres, des chiffres et des tirets non consécutifs, des traits de soulignement et des points. Les versions de package doivent être en minuscules sans métadonnées de build (suffixe+ ). Pour en savoir plus sur le contrôle de version sémantique, consultez SemVer .

La commande suivante publiera un package universel dans un flux d’étendue de l’organisation :

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

Afficher les packages publiés

  1. Accédez à votre organisation Azure DevOps.

  2. Sélectionnez votre projet, puis Artifacts.

  3. Sélectionnez votre flux dans le menu déroulant.

    A screenshot showing the newly published universal package.

Télécharger des packages universels

Pour télécharger un package universel à l’aide d’Azure CLI, exécutez la commande suivante dans une invite de commandes avec élévation de privilèges.

az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME>  --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>

Télécharger des fichiers spécifiques

Si vous souhaitez uniquement télécharger des fichiers spécifiques, vous pouvez utiliser le --file-filter paramètre pour télécharger un sous-ensemble de fichiers.

Exemple : --file-filter *logs/*.log correspond à n’importe quel fichier se terminant par les journaux et avec l’extension .log (exemple : build123_logs.log). Pour plus d’informations, consultez les informations de référence sur les modèles de correspondance de fichier.

az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION>  --path <DOWNLOAD_PATH>  --file-filter <MATCH_PATTERN>

Téléchargez la dernière version

Vous pouvez utiliser des caractères génériques pour télécharger la dernière version de vos packages universels.

Exemples :

  • --version '*': la dernière version.

  • --version '1.*': la dernière version avec la version principale 1.

  • --version '1.2.*': la dernière version du correctif avec la version majeure 1 et mineure 2.

Notes

Les caractères génériques ne sont pas pris en charge dans les pipelines de préversion.