Publier à partir de la ligne de commande

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Vous pouvez utiliser l’interface CLI multiplateforme pour Azure DevOps (tfx-cli) pour publier votre extension sur Visual Studio Marketplace.

Pour plus d’informations, consultez la vue d’ensemble de la publication, de l’installation et du partage.

Prérequis

Obtenez l’interface CLI TFX à partir de Node Gestionnaire de package et générez un jeton d’accès personnel (PAT). En outre, si vous ne l’avez pas déjà fait, configurez un serveur de publication dans la galerie.

Acquérir l’interface CLI multiplateforme pour Azure DevOps

1. Si vous ne l’avez pas, téléchargez et installez NodeJS. Pendant la configuration, vérifiez que vous laissez Ajouter au chemin d’accès choisi.

2. Ouvrez une invite de commandes et entrez npm i -g tfx-cli.

Si l’interface CLI TFX est déjà installée, vous pouvez effectuer une mise à jour vers la dernière version en exécutant npm up -g tfx-cli.

Créer un jeton d’accès personnel

1. Connectez-vous à votre organisation (https:dev.azure.com/{organization}).

2. Dans votre page d’accueil, ouvrez l’icône paramètres utilisateur, puis sélectionnez Profil.

   

3. Sous Sécurité, sélectionnez Jetons d’accès personnels, puis Nouveau jeton.

   

4. Remplissez le formulaire :

   • Nommez votre jeton
   • Sélectionnez toutes les organisations accessibles, qui est la seule valeur qui fonctionne lors de la publication via l’interface CLI. Si vous sélectionnez une seule organisation, elle génère une erreur, même si le mot de passe est valide
   • Sélectionnez un délai d’expiration pour votre jeton. Cela est nécessaire, car les API de publication visual Studio Marketplace fonctionnent en dehors du contexte d’une organisation
   • Définissez l’étendue de l’accès associé à ce jeton. Veillez à sélectionner l’étendue de la Place de marché (publication). Cette étendue limite le jeton à la seule possibilité de publier des extensions sur la Place de marché.
   • Sélectionnez Créer

   

5. Copiez votre jeton d’accès personnel généré. Veillez à le garder secret.

   

Publier à partir de la ligne de commande

Une fois que TFX CLI est installé et que vous disposez de votre PAT, vous pouvez utiliser l’outil pour empaqueter et publier votre extension.

1. Ouvrez une invite de commandes dans le répertoire racine de votre extension.
2. Exécutez la commande suivante pour publier votre extension. Lorsque vous y êtes invité, entrez votre jeton d’accès personnel pour vous authentifier.

tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

Vous pouvez recevoir l’erreur suivante si votre extension a déjà été publiée :

Failed Request: Internal Server Error(500) - Version number must increase each time an extension is published. Extension: fabrikam.my-extension  Current version: 0.1.9  Updated version: 0.1.9

Vous pouvez ajouter l’indicateur --rev-version pour incrémenter automatiquement la version corrective de votre extension. Cela enregistre également la nouvelle version dans votre manifeste.

Remarque

Toutes les options disponibles create sont disponibles pour la publish commande.

Exemple

C:\vso-team-calendar>tfx extension publish --publisher publishFabrikam --manifest-js fabrikam.config.js --share-with fabrikam --rev-version
Copyright Microsoft Corporation
> Personal access token:
Checking if this extension is already published
It is, update the extension
Waiting for server to validate extension package...
Sharing extension with fabrikam.

=== Completed operation: publish extension ===
 - Packaging: C:\vso-team-calendar\fabrikam.team-calendar-0.2.6.vsix
 - Publishing: success
 - Sharing: shared with fabrikam