Instalar extensões

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

Instale, atribua, desabilite e desinstale extensões, que adicionam novos recursos e capacidades para o Azure DevOps.

Para obter mais informações sobre extensões, consulte as visões gerais de desenvolvimento e publicação .

Pré-requisitos

  • Você deve ser membro do Grupo de administradores da Coleção de Projetos para instalar uma extensão. Os proprietários da organização são automaticamente membros desse grupo. Se você não tiver permissões, poderá solicitar extensões em vez de procurar um administrador de coleção de projetos.
  • As extensões particulares devem ser compartilhadas com sua organização para serem instaladas. Confira a documentação de publicação para obter informações sobre como compartilhar extensões particulares.
  • Somente membros do grupo Administradores de Coleção de Projetos ou que tenham permissões "Editar informações no nível da coleção" podem instalar extensões. Os proprietários da organização são automaticamente membros desse grupo. Se você não tiver permissões, poderá solicitar extensões em vez de procurar um administrador de coleção de projetos.
  • As extensões particulares devem ser compartilhadas com sua organização para serem instaladas. Confira a documentação de publicação para obter informações sobre como compartilhar extensões particulares.

Observação

Para usar uma assinatura existente do Azure para cobrança, você deve ter pelo menos permissões de coadministrador para essa assinatura. Se você não tiver permissões, um Administrador de Conta do Azure ou Administrador de Serviço poderá adicioná-lo como coadministrador à assinatura do Azure no portal do Azure.

Sua coleção de projetos reutiliza sua assinatura do Azure para compras futuras do Marketplace. Onde posso encontrar mais informações sobre a cobrança do Azure?

Instalar uma extensão

Instale uma extensão para sua organização executando as etapas a seguir.

  1. Entrar em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione o ícone do saco de compras e, em seguida, selecione Procurar no Marketplace.

    Captura de tela mostrando o ícone do saco de compras realçado e a seleção do botão Procurar no Marketplace.

  3. Encontre a extensão que você deseja instalar e selecione Obter gratuitamente.

    Captura de tela mostrando o realce quadrado vermelho Botão Get it free.

  4. Selecione sua organização no menu suspenso e selecione Instalar para instalar a extensão.

    Selecione a organização para esta extensão

Sua extensão já está instalada! Agora você pode ir para sua organização para usar sua extensão. Além disso, informe sua equipe sobre essa extensão, para que eles possam começar a usar seus recursos.

Extensão instalada

  1. Vá para Marketplace.visualstudio.com.

  2. Entre usando suas credenciais de DevOps do Azure.

  3. Encontre a extensão que você deseja instalar. Use a caixa de pesquisa para filtrar a lista de extensões.

    Captura de tela de Selecionando uma extensão.

  4. Selecione a extensão e selecione Obter ou Obter gratuitamente. Ou, para algumas extensões de terceiros, selecione Introdução para mostrar informações de preços e instruções de instalação específicas da extensão.

    Captura de tela de obter as extensões.

    Se você não tiver permissão para instalar a extensão, poderá solicitar que um administrador a instale para você. Sua solicitação é armazenada no Servidor de DevOps do Azure e está pronta para receber atenção de um administrador.

  5. Selecione Download para baixar o arquivo vsix.

  6. Carregue o vsix no seu Marketplace local local. Abra a home page do Servidor de DevOps do Azure (https://{server}:DefaultCollection).

  7. Vá para Configurações da>coleção Procurar extensões locais.

    Captura de tela da seleção, botão Procurar extensões locais.

  8. Selecione Gerenciar extensões e, em seguida, Carregar o arquivo vsix.

    Captura de tela da seleção, Gerenciar extensões.

  9. Instale a extensão em sua coleção de projetos na página Gerenciar extensões . Selecione a coleção de projetos onde você deseja instalar a extensão e escolha Instalar.

Captura de tela de Selecionar coleção de projetos e escolha Instalar.

  1. Após a conclusão da instalação, vá para a coleção de projetos ou retorne ao Marketplace para encontrar outras extensões.

Captura de tela mostrando a instalação concluída da extensão.

Desinstalar ou desabilitar uma extensão

  1. Entre em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione ícone de engrenagem Configurações da organização.

    Captura de tela mostrando as configurações de Abrir organização.

  3. Selecione Extensões e, em seguida, selecione a extensão que você deseja desinstalar ou desabilitar.

    Captura de tela mostrando Selecionar desinstalar ou desativar para extensão.

  4. Selecione Desinstalar ou selecione as reticências (...) e, em seguida, selecione Desativar.

    Captura de tela mostrando as ações de desativação ou desinstalação da extensão.


Para desinstalar extensões em uma coleção, execute as seguintes etapas.

  1. Vá para o portal de gerenciamento de galeria local (http://{server}:8080/tfs/_gallery/manage).

  2. Para a extensão desejada, selecione as reticências (...) e, em seguida, selecione Remover.

    Captura de tela mostrando a ação Remover extensão.

Habilitar ou listar extensões por meio da linha de comando

Habilite uma extensão com o comando az devops extension enable . Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

Parâmetros - ativar extensão

  • extension-name: O nome da extensão a ser habilitada.
  • publisher-name: O nome do editor da extensão.
  • org: URL da organização do Azure DevOps. Configure a organização padrão com az devops configure -d organization=ORG_URLo . Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - habilitar extensão

O comando a seguir habilita a extensão Timetracker e mostra o resultado em formato de tabela.

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

Extensões de lista

Você pode listar as extensões instaladas em sua organização com o comando az devops extension list . Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

Parâmetros opcionais - extensões de lista

  • include-built-in: Inclua as extensões internas. Os valores aceitos são true (padrão) e false.
  • include-disabled: Inclua as extensões desabilitadas. Os valores aceitos são true (padrão) e false.
  • org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - extensões de lista

O comando a seguir lista as extensões em sua organização. Ele exclui as extensões desabilitadas e internas e mostra os resultados em formato de tabela.

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

Listar informações de extensão

Você pode listar os detalhes sobre uma extensão com o comando az devops extension show . Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension show --extension-name
                         --publisher-name
                         [--org]

Parâmetros - informações de extensão de lista

  • extension-name: O nome da extensão.
  • publisher-name: O nome do editor da extensão.
  • org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - informações de extensão de lista

O comando a seguir mostra informações sobre a extensão Timetracker em formato de tabela.

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Perguntas frequentes (FAQs)

P: Por que não vejo minha organização na página de instalação do Marketplace?

R: Se você não vir sua organização ao comprar no Azure DevOps Marketplace, tente as seguintes etapas:

  1. Verifique a identidade que você usa para entrar no Visual Studio Marketplace. No canto superior direito, selecione seu nome de usuário para visualizar seu perfil.
  2. Verifique se o endereço de e-mail e o diretório estão corretos.
  3. Feche todas as janelas do navegador.
  4. Abra uma sessão de navegação privada ou anônima.
  5. Entre no Visual Studio Marketplace. Use a identidade de um usuário na organização desejada.

Dica

O Azure DevOps pode solicitar que você escolha entre "conta corporativa ou de estudante" ou "conta pessoal". Em caso afirmativo, você usou um endereço de email que é o mesmo para uma conta da Microsoft e uma "conta corporativa ou de estudante" que sua organização gerencia no Microsoft Entra ID. Embora essas identidades tenham o mesmo endereço de email, elas ainda são identidades separadas com perfis, configurações de segurança e permissões diferentes. Escolha a identidade do usuário na organização que você deseja selecionar.

P: Por que não consigo instalar uma extensão?

R: Não é possível instalar extensões por um dos seguintes motivos.

  • Você deve ser membro do grupo Administradores de Coleção de Projetos ou ser o proprietário da Organização. Se você não tiver permissões, mas for membro do projeto, poderá solicitar extensões .
  • Para um erro "já instalado ou solicitado", consulte o Administrador da Coleção de Projetos e peça que ele atribua a extensão a você.

P: Por que os usuários não podem acessar os recursos de extensão?

R: Os usuários não podem acessar uma extensão por um dos seguintes motivos.

  • A maioria das extensões exige que os usuários tenham pelo menos acesso Básico, não Stakeholder. Por exemplo, você pode instalar a extensão gratuita de Pesquisa de Código, mas cada usuário deve ter pelo menos acesso Básico para procurar código. Para ajudar sua equipe a melhorar a qualidade do aplicativo, você pode instalar a extensão gratuita Test & Feedback. Você experimenta recursos diferentes, com base no seu nível de acesso e se trabalha offline ou conectado aos Serviços de DevOps do Azure ou ao Servidor de DevOps do Azure local. Para obter mais informações, consulte a descrição da extensão no Visual Studio Marketplace, guia Azure DevOps.

  • Se você estiver usando uma organização e tiver iniciado uma avaliação de extensão gratuita, sua avaliação pode ter expirado. Verifique se a versão de avaliação expirou.

    1. Na barra de ferramentas da organização, selecione Usuários.
    2. Vá para o painel de extensão.
    3. Verifique se há uma mensagem de expiração para descobrir se ou quando sua extensão expirou.
  • Se você estiver usando uma organização e pagou por essa extensão, certifique-se de ter atribuído essa extensão aos usuários.

    1. Na barra de ferramentas da sua organização, vá para Usuários.
    2. Vá para o painel de extensão.
    3. Verifique se a extensão está atribuída ao usuário. Se não estiver, atribua a extensão ao usuário.

Para obter mais informações, consulte Atribuir extensões a usuários.

P: O que aconteceu com minha extensão de visualização?

R: Sua extensão pode estar fora da visualização. Após um período de visualização, uma extensão mais longa geralmente está disponível como uma extensão paga. Um período de carência pode ser oferecido antes de você ter que comprar a extensão. Todas as extensões de visualização são convertidas automaticamente em uma avaliação gratuita antes que você tenha que comprar a extensão.

P: Por que não consigo instalar extensões para o Servidor de DevOps do Azure?

R: Não é possível instalar extensões para o Azure DevOps Server por um dos seguintes motivos:

  • Você deve ser membro do grupo Administradores de Coleção de Projetos ou ter a permissão Editar informações em nível de coleção definida como Permitir na coleção de projetos onde deseja instalar extensões. Se você não tiver permissões, poderá solicitar extensões .
  • Você pode receber um erro dizendo que você já instalou ou solicitou a extensão. Em caso afirmativo, verifique com um membro do grupo Administradores da Coleção de Projetos e peça-lhes que atribuam a extensão a você. Para obter mais informações, consulte Solicitar um aumento nos níveis de permissão.

P: Por que não vejo a coleção de projetos que desejo (local)?

R: Você deve ser um membro da sua coleção de projetos. Siga estas etapas para verificar sua identidade que você usa para entrar no Marketplace.

  1. Na home page do portal da Web do Servidor de DevOps do Azure (https://{server}:8080/tfs/), vá para o canto superior direito da página e selecione seu nome de usuário para exibir seu perfil.

  2. No lado esquerdo do seu perfil, verifique se o endereço de e-mail e o diretório estão corretos.

  3. Feche todas as janelas do navegador.

  4. Abra uma sessão de navegação privada ou anônima.

  5. Entre na home page do Servidor de DevOps do Azure (https://{server}:8080/tfs/) com a identidade de um usuário na coleção de projetos onde você deseja instalar a extensão.

    O Azure DevOps pode solicitar que você escolha entre uma "organização corporativa ou escolar" ou "conta pessoal". Essa mensagem significa que você usou um endereço de email igual para uma conta da Microsoft e uma "conta corporativa ou de estudante" gerenciada por sua organização no Microsoft Entra ID. Embora essas identidades tenham o mesmo endereço de email, elas ainda são identidades separadas com perfis, configurações de segurança e permissões diferentes. Escolha a identidade que é o usuário em sua coleção de projetos.

  6. Na sua coleção de projetos, acesse o Marketplace.

P: Por que a extensão desejada não mostra um botão de download (local)?

R: Algumas extensões funcionam apenas com os Serviços de DevOps do Azure por um dos seguintes motivos:

  • A extensão usa recursos do Azure DevOps que ainda não foram lançados para o Azure DevOps Server.
  • O manifesto de extensão indica que a extensão está disponível apenas para os Serviços de DevOps do Azure (destinos = Microsoft.Visualstudio.Services.Cloud).
  • O manifesto de extensão indica que a extensão é uma integração (destinos = Microsoft.Visualstudio.Services.Integration).

P: Por que não consigo carregar extensões no Servidor de DevOps do Azure?

R: Você deve ser membro do grupo Administradores do Team Foundation. Você também deve ter permissões Editar informações em nível de instância para o Servidor de DevOps do Azure onde deseja carregar extensões.

P: Como posso obter suporte para subscrições, faturação e Marketplace do Azure?

R: Dependendo do suporte que você precisa, escolha entre os seguintes artigos:

Observação

A equipe de suporte do Azure DevOps não oferece suporte a extensões do Visual Studio Marketplace. Para obter suporte em extensões do marketplace, localize a extensão que você está usando no Visual Studio Marketplace. Na página de extensão, você pode encontrar um link para o repositório do GitHub, onde você pode criar um problema, ou obter um link para obter suporte da comunidade.

Próximas etapas