Publicación desde la línea de comandos

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

Puede usar la CLI multiplataforma para Azure DevOps (tfx-cli) para publicar la extensión en Visual Studio Marketplace.

Para obtener más información, consulte la información general sobre la publicación, la instalación y el recurso compartido.

Requisitos previos

Obtenga la CLI de TFX de Node Administrador de paquetes y genere un token de acceso personal (PAT). Además, si aún no lo ha hecho, configure un publicador en la Galería.

Adquisición de la CLI multiplataforma para Azure DevOps

1. Si no lo tiene, descargue e instale NodeJS. Durante la configuración, asegúrese de dejar Agregar a PATH elegido.

2. Abra un símbolo del sistema y escriba npm i -g tfx-cli.

Si ya tiene instalada la CLI de TFX, puede actualizar a la versión más reciente ejecutando npm up -g tfx-cli.

Crear un token de acceso personal

1. Inicie sesión en su organización (https:dev.azure.com/{organization}).

2. En la página principal, abra el icono de configuración de usuario y, a continuación, seleccione Perfil.

   

3. En Seguridad, seleccione Tokens de acceso personal y, a continuación, seleccione Nuevo token.

   

4. Complete el formulario:

   • Asigne un nombre al token
   • Seleccione Todas las organizaciones accesibles, que es el único valor que funciona al publicar a través de la CLI. Si selecciona solo una organización, se producirá un error, incluso si el PAT es válido.
   • Seleccione un período de tiempo de expiración para el token. Esto es necesario porque las API de publicación de Visual Studio Marketplace funcionan fuera del contexto de una organización.
   • Establezca el ámbito de acceso asociado a este token. Asegúrese de seleccionar el ámbito de Marketplace (publicación). Este ámbito limita el token para que solo pueda publicar extensiones en Marketplace.
   • Seleccione Crear

   

5. Copie el token de acceso personal generado. Asegúrese de mantenerlo secreto.

   

Publicación desde la línea de comandos

Una vez instalada la CLI de TFX y que tenga su PAT, puede usar la herramienta para empaquetar y publicar la extensión.

1. Abra un símbolo del sistema en el directorio raíz de la extensión.
2. Ejecute el siguiente comando para publicar la extensión. Cuando se le solicite, escriba el token de acceso personal para autenticarse.

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

Es posible que reciba el siguiente error si la extensión ya se ha publicado:

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

Puede agregar la --rev-version marca para incrementar automáticamente la versión de revisión de la extensión. Esto también guarda la nueva versión en el manifiesto.

Nota:

Todas las opciones disponibles para create están disponibles para el publish comando .

Ejemplo

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