Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Serviços de DevOps do Azure | 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
Categoria | Requerimentos |
---|---|
Permissões | Membro do grupo de Administradores da Coleção de Projetos. Os proprietários da organização são automaticamente membros deste grupo. Se você não tiver permissões, poderá solicitar extensões ou procurar um administrador de coleção de projetos. |
Compartilhamento de extensão | Extensões privadas partilhadas com a sua organização. |
Categoria | Requerimentos |
---|---|
Permissões | Membro do grupo Administradores da Coleção de Projetos ou com permissões para editar informações ao nível da coleção. Os proprietários da organização são automaticamente membros deste grupo. Se você não tiver permissões, poderá solicitar extensões ou procurar um administrador de coleção de projetos. |
Compartilhamento de extensão | Extensões privadas partilhadas com a sua organização. |
Nota
Para usar uma assinatura existente do Azure para cobrança, tenha 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 faturação do Azure?
Instalar uma extensão
Instale uma extensão para sua organização executando as etapas a seguir.
Inicie sessão na sua organização (
https://dev.azure.com/{Your_Organization}
).Selecione o ícone do saco de compras e, em seguida, selecione Procurar no Marketplace.
Encontre a extensão que deseja instalar e selecione Obter gratuitamente.
Selecione sua organização no menu suspenso e, em seguida, selecione Instalar para instalar a extensão.
A 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.
Privilégio elevado, decoradores de pipeline e extensões não publicadas
Extensões com escopos de alto privilégio, decoradores de pipeline ou status não publicado podem representar riscos potenciais de segurança se não forem devidamente examinadas. Escopos de alto privilégio concedem amplo acesso aos recursos da sua organização, enquanto os decoradores de pipeline podem modificar todos os pipelines em sua organização. As extensões não publicadas podem não ser mais mantidas por seus editores. Para obter mais informações sobre como gerenciar esses tipos de extensões, consulte Gerenciar escopos de alto privilégio, decoradores de pipeline e extensões não publicadas.
Desinstalar ou desativar uma extensão
Inicie sessão na sua organização (
https://dev.azure.com/{Your_Organization}
).Selecione
Configurações da organização.
Selecione Extensões e, em seguida, selecione a extensão que pretende desinstalar ou desativar.
Selecione Desinstalar ou selecione as reticências (...) e depois selecione Desativar.
Para desinstalar extensões em uma coleção, execute as seguintes etapas:
Vá para o portal de gerenciamento de galeria local (
http://{server}:8080/tfs/_gallery/manage
).Para a extensão desejada, selecione as reticências (...) e, em seguida, selecione Remover.
Habilitar ou listar extensões através da linha de comando
Habilite uma extensão com o comando az devops extension enable . Para começar, consulte 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 de extensão.
-
org: URL da organização do Azure DevOps. Configure a organização padrão com
az devops configure -d organization=ORG_URL
. Obrigatório se não estiver configurado como predefinido ou coletado usandogit config
. Exemplo:--org https://dev.azure.com/MyOrganizationName/
.
Exemplo - ativar 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
Listar extensões
Você pode listar as extensões instaladas em sua organização com o comando az devops extension list . Para começar, consulte 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 integradas. 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: 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 predefinido ou coletado usandogit config
. Exemplo:--org https://dev.azure.com/MyOrganizationName/
.
Exemplo - extensões de lista
O comando a seguir lista 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, consulte Introdução à CLI do Azure DevOps.
az devops extension show --extension-name
--publisher-name
[--org]
Parâmetros - listar informações de extensão
- extension-name: O nome da extensão.
- publisher-name: O nome do editor de extensão.
-
org: 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 predefinido ou coletado usandogit config
. Exemplo:--org https://dev.azure.com/MyOrganizationName/
.
Exemplo - informações sobre a extensão da 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
Solucionar problemas de instalação da extensão
Para resolver problemas comuns, siga estas etapas de solução de problemas:
Falha na instalação da extensão:
- Verifique as permissões: Para instalar extensões, certifique-se de que é um Administrador de Coleção de Projetos ou de que tem as permissões necessárias concedidas por um administrador.
- Verifique a compatibilidade da extensão: Verifique se a extensão é compatível com sua versão do Azure DevOps. Verifique a página de detalhes da extensão para obter informações sobre compatibilidade.
- Problemas de rede: Verifique se a conexão de rede está estável e se não há configurações de firewall ou proxy bloqueando o processo de instalação.
A extensão falha ou causa erros:
- Coletar informações de diagnóstico: Se uma extensão falhar ou causar erros, colete informações de diagnóstico para ajudar a identificar o problema. Essas informações incluem mensagens de erro, logs e capturas de tela do problema.
- Verifique os logs de extensão: Algumas extensões fornecem logs que podem ajudar a diagnosticar problemas. Verifique a documentação da extensão para obter informações sobre como acessar e interpretar esses logs.
- Entre em contato com o suporte: Se não conseguir resolver o problema, contacte a equipa de suporte da extensão com as informações de diagnóstico recolhidas. Forneça o máximo de detalhes possível para ajudá-los a solucionar o problema.
Extensão não visível após a instalação:
- Atualize a página: Às vezes, a extensão pode não aparecer imediatamente após a instalação.
- Verifique as permissões: Verifique se você tem as permissões necessárias para exibir e usar a extensão. Algumas extensões podem exigir permissões específicas para serem visíveis.
- Reinstale a extensão: Se a extensão ainda não estiver visível, tente desinstalá-la e reinstalá-la.
Perguntas mais frequentes (FAQ)
P: Por que não vejo minha organização na página de instalação do Marketplace?
Se não visualizar a sua organização ao efetuar uma compra no Marketplace do Azure DevOps, tente as seguintes etapas:
- Verifique a identidade que você usa para entrar no Visual Studio Marketplace. No canto superior direito, selecione o seu nome de utilizador para ver o seu perfil.
- Certifique-se de que o seu endereço de e-mail e diretório estão corretos.
- Feche todas as janelas de navegadores.
- Abra uma sessão de navegação privada ou anónima.
- Entre no Visual Studio Marketplace. Use a identidade de um usuário na organização desejada.
Sugestão
O Azure DevOps pode pedir-lhe para escolher entre "conta escolar ou profissional" ou "conta pessoal". Em caso afirmativo, utilizou um endereço de correio eletrónico que é o mesmo para uma conta Microsoft e uma "conta escolar ou profissional" que a sua organização gere no Microsoft Entra ID. Embora essas identidades tenham o mesmo endereço de e-mail, 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.
- Seja membro do grupo Administradores da Coleção de Projetos ou seja o proprietário da Organização. Se você não tiver permissões, mas for um membro do projeto, poderá solicitar extensões .
- Se ocorrer um erro "já instalado ou solicitado", consulte o Administrador da Coleção do Projeto e peça-lhe que lhe atribua a extensão.
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 pesquisar 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 em seu nível de acesso e se você 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 estiver a utilizar uma organização e tiver iniciado uma avaliação de extensão gratuita, a sua avaliação poderá ter expirado. Verifique se a versão experimental expirou.
- Na barra de ferramentas da sua organização, selecione Usuários.
- Vá para o painel de extensão.
- Verifique se há uma mensagem de expiração para saber se ou quando sua extensão expirou.
Se estiver a utilizar uma organização e tiver pago por esta extensão, certifique-se de que atribuiu esta extensão aos utilizadores.
- Na barra de ferramentas da sua organização, vá para Usuários.
- Vá para o painel de extensão.
- 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 à minha extensão de pré-visualização?
A: A sua extensão pode já não estar em pré-visualização. Após um período de pré-visualização, uma extensão mais longa está geralmente 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 Azure DevOps Server?
R: Não é possível instalar extensões para o Azure DevOps Server por um dos seguintes motivos:
- Seja membro do grupo Administradores da Coleção de Projetos ou tenha a permissão Editar informações no nível da coleção definida como Permitir na coleção de projetos onde você deseja instalar extensões. Se não tiver permissões, pode solicitar extensões .
- Você pode receber um erro que diz que você já instalou ou solicitou a extensão. Em caso afirmativo, consulte um membro do grupo Administradores de 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 quero (no local)?
A: Seja um membro da sua coleção de projetos. Siga estes passos para verificar a sua identidade que utiliza para iniciar sessão no Marketplace.
- Na home page do portal Web do Azure DevOps Server (
https://{server}:8080/tfs/
), vá para o canto superior direito da página e selecione seu nome de usuário para exibir seu perfil. - No lado esquerdo do seu perfil, certifique-se de que o seu endereço de e-mail e diretório estão corretos.
- Feche todas as janelas de navegadores.
- Abra uma sessão de navegação privada ou anónima.
- Entre na página inicial do Azure DevOps Server (
https://{server}:8080/tfs/
) com a identidade que é um utilizador na coleção de projetos na qual deseja instalar a extensão.
O Azure DevOps pode pedir-lhe para escolher entre uma "organização escolar ou profissional" ou uma "conta pessoal". Esta mensagem significa que utilizou um endereço de correio eletrónico idêntico para uma conta Microsoft e uma "conta escolar ou profissional" gerida pela sua organização no Microsoft Entra ID. Embora essas identidades tenham o mesmo endereço de e-mail, elas ainda são identidades separadas com perfis, configurações de segurança e permissões diferentes. Escolha a identidade do utilizador na sua coleção de projetos. - Da sua coleção de projetos, vá para o Marketplace.
P: Porque é que a extensão que pretendo não mostra um botão de transferência (no 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 da extensão indica que a extensão é uma integração (targets = Microsoft.Visualstudio.Services.Integration).
P: Por que não consigo carregar extensões no Azure DevOps Server?
R: Seja um membro do grupo Team Foundation Administrators. Você também deve ter permissões de Editar informações no nível da instância para o Servidor de DevOps do Azure onde deseja carregar extensões.