Partilhar via

Publicar a partir da linha de comando

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode usar a CLI de plataforma cruzada para Azure DevOps (tfx-cli) para publicar sua extensão no Visual Studio Marketplace.

Para obter mais informações, consulte a visão geral de publicar, instalar e compartilhar.

Pré-requisitos

Obtenha a CLI TFX do Node Package Manager e gere um token de acesso pessoal (PAT). Além disso, se ainda não o fez, configure um Editor na Galeria.

Adquira a CLI de plataforma cruzada para Azure DevOps

  1. Se você não tiver, baixe e instale o NodeJS. Durante a configuração, certifique-se de deixar Adicionar ao CAMINHO escolhido.

  2. Abra um prompt de comando e digite npm i -g tfx-cli.

Se você já tiver a CLI do TFX instalada, poderá atualizar para a versão mais recente executando npm up -g tfx-cli.

Criar um token de acesso pessoal

  1. Inicie sessão na sua organização (https:dev.azure.com/{organization}).

  2. Na página inicial, abra o ícone de configurações do usuário e selecione Perfil.

    Selecione Perfil depois de selecionar o ícone de configurações do usuário

  3. Em Segurança, selecione Tokens de acesso pessoais e, em seguida, selecione Novo token.

    Crie o seu novo token de acesso pessoal

  4. Preencha o formulário:

    • Dê um nome ao seu token
    • Selecione Todas as organizações acessíveis, que é o único valor que funciona ao publicar via CLI. Se selecionar apenas uma organização, isso resultará num erro, mesmo que a PAT seja válida
    • Selecione um período de expiração para o seu token. Isso é necessário porque as APIs de publicação do Visual Studio Marketplace funcionam fora do contexto de uma organização
    • Defina o escopo de acesso associado a esse token. Certifique-se de selecionar o escopo do Marketplace (publicar). Esse escopo limita o token a apenas poder publicar extensões no Marketplace.
    • Selecione Criar

    ..

  5. Copie o token de acesso pessoal gerado. Certifique-se de mantê-lo em segredo.

    Copie o seu token e mantenha-o em segredo

Publicar a partir da linha de comando

Uma vez que a CLI do TFX esteja instalada e você tenha seu PAT, você pode usar a ferramenta para empacotar e publicar sua extensão.

  1. Abra um prompt de comando para o diretório raiz da sua extensão.
  2. Execute o seguinte comando para publicar sua extensão. Quando solicitado, insira seu token de acesso pessoal para autenticar.
tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

Poderá receber o seguinte erro se a sua extensão já tiver sido publicada:

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

Você pode adicionar o --rev-version sinalizador para incrementar automaticamente a versão do patch da sua extensão. Isso também salva a nova versão no seu manifesto.

Nota

Todas as opções disponíveis para create estão disponíveis para o publish comando.

Exemplo

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