Compartilhar via


Usar o Azure Repos com o Microsoft Teams

Azure DevOps Services

Se você usa o Microsoft Teams, e o Azure Repos, você pode usar o aplicativo Azure Repos para Teams para monitorar seus repositórios. O aplicativo dá suporte ao monitoramento de repositórios git e TFVC (Controle de Versão do Team Foundation), mas não dá suporte à integração com repositórios do GitHub.

Neste artigo, você aprende a realizar as seguintes tarefas:

  • Adicionar o aplicativo Azure Repos à sua equipe no Microsoft Teams
  • Conectar o aplicativo Azure Repos aos seus repositórios
  • Gerenciar assinaturas para repositório de eventos relacionados em seu canal
  • Pesquisar e compartilhar informações de PR usando a extensão de redação
  • Visualizar URLs de PR
  • Remover assinaturas e repositórios de um canal

Pré-requisitos

Observação

  • No momento, não há suporte para notificações dentro de mensagens diretas.
  • Você só pode vincular o aplicativo Azure Repos para Microsoft Teams a um projeto hospedado no Azure DevOps Services.

Adicionar o aplicativo Azure Repos a uma equipe no Microsoft Teams

  1. Acesse o aplicativo Azure Repos no Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Selecione Adicionar ou se você já baixou o aplicativo, selecione o menu suspenso ao lado de Abrire, em seguida, selecione Adicionar a uma equipe.

  3. Insira um nome de equipe ou canal e selecione Configurar um bot.

    Captura de tela da mensagem de boas-vindas do Azure Repos no Teams.

Conectar o aplicativo Azure Repos aos seus repositórios

  1. Depois que o aplicativo for instalado em sua equipe, insira o seguinte texto no campo de resposta: @azure repos signin

    Se seu Microsoft Teams e Azure Boards estiverem em locatários diferentes, selecione Entrar com email diferente.

    Captura de tela mostrando a entrada de entrada do Teams para o Azure Repos.

    Captura de tela mostrando a resposta completa de entrada.

  2. Para monitorar todos os repositórios Git em um projeto, insira @azure repos subscribe [project url] no canal. Adicione a URL do projeto. A URL do projeto pode estar em qualquer página do projeto (exceto URLs para repositórios).

    Você também pode monitorar um repositório específico usando: @azure repos subscribe [repo url].

    A URL do repositório pode estar em qualquer página no repositório que tenha o nome do repositório, por exemplo, @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepoou para repositórios TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. O subscribe comando é iniciado com uma assinatura padrão. Para repositórios Git, o canal é inscrito no evento criado pela solicitação pull (com branch de destino = principal). Para repositórios de TFVC, o canal é inscrito no evento Descompossado de Código.

    Captura de tela mostrando a mensagem de criação de assinaturas padrão.

Gerenciar Assinaturas

Para exibir, adicionar e remover assinaturas de um canal, insira o seguinte texto: @azure repos subscriptions.

Você vê uma lista de todas as assinaturas atuais do canal e pode adicionar novas assinaturas ou remover as existentes. Personalize suas notificações com vários filtros, conforme descrito na seção a seguir.

Observação

Os administradores de equipe não podem remover ou modificar assinaturas criadas pelos administradores do Projeto.

Exibir assinaturas

Usar filtros para obter apenas notificações desejadas

Quando você assina um repositório com @azure repos subscribe, uma assinatura padrão é criada sem filtros aplicados. Geralmente, os usuários precisam personalizar essas assinaturas para serem notificados somente quando determinadas condições forem atendidas. As capturas de tela a seguir mostram um exemplo de configuração de notificações somente quando nossa equipe está na lista de revisor de uma PR.

  1. Insira o seguinte texto em seu canal: @azure repos subscriptions.

  2. Na lista de assinaturas, se houver uma assinatura que você não deseja ou deve ser modificada, selecione Remover para excluí-la.

  3. Selecione o botão Adicionar assinatura.

  4. Escolha um tipo de evento e selecione Avançar.

    Captura de tela mostrando a seleção de tipo de evento.

  5. Escolha um repositório e selecione Avançar.

    Captura de tela mostrando a seleção do repositório.

  6. Selecione os filtros apropriados para personalizar sua assinatura e selecione Enviar.

    Captura de tela mostrando os filtros escolhidos.

Observação

  • Normalmente, todos os filtros são suspensos. No entanto, se a lista suspensa tiver mais de 100 itens, você deverá inserir manualmente os valores.
  • Para o código TFVC verificado no evento, o filtro Em caminho deve ser do formato $/myproject/path.

Pesquisar e compartilhar informações de solicitação de pull usando a extensão de redação

Para ajudar os usuários a pesquisar e compartilhar informações sobre solicitações de pull, o aplicativo Azure Repos para Microsoft Teams dá suporte a uma extensão de redação. Você pode pesquisar solicitações de pull por ID ou nome. Para que a extensão funcione, entre no projeto do Azure Repos inserindo ou entrando @azure repos signin diretamente na extensão de redação.

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

Visualizar URLs de solicitação de pull

Quando você cola a URL de uma PR, uma visualização mostra como a da imagem a seguir, o que ajuda a manter as conversas relacionadas à PR contextuais e precisas. Você deve estar conectado e, em seguida, pode visualizar PRs para URLs em todos os canais em uma equipe.

Captura de tela mostrando a desenrolação da URL.

Remover assinaturas e repositórios de um canal

Para excluir todas as assinaturas relacionadas a qualquer repositório no projeto e remover os repositórios do canal, insira o seguinte texto no Teams: @azure repos unsubscribe all [project url]. Insira a URL do projeto. Somente os administradores do projeto podem fazer essa tarefa.

Notificações encadeadas

Para vincular um conjunto de notificações relacionadas e também reduzir o espaço ocupado por notificações em um canal, as notificações são encadeadas. Todas as notificações vinculadas a uma solicitação de pull específica são vinculadas.

Exibição compacta de notificaçõesencadeadas Captura de tela mostrando a exibição compacta de notificações encadeadas.

Exibição expandida de notificaçõesencadeadas Captura de tela mostrando a exibição expandida de notificações encadeadas.

Referência do comando

A tabela a seguir lista todos os azure repos comandos que você pode usar em seu canal do Teams.

Comando Funcionalidade
@azure repos subscribe [repo url/ project url] Assinar um repositório ou todos os repositórios em um projeto para receber notificações
@azure repos subscriptions Adicione ou remova as assinaturas para este canal
@azure repos signin Entre em sua organização do Azure Repos
@azure repos signout Sair da sua organização do Azure Repos
@azure repos feedback Relatar um problema ou sugerir um recurso
@azure repos unsubscribe all [project url] Remover todos os repositórios (pertencentes a um projeto) e suas assinaturas associadas de um canal

Suporte para multilocatário

Se você estiver usando um email ou locatário diferente para o Microsoft Teams e o Azure DevOps, execute as etapas a seguir para entrar, com base no seu caso de uso.

Caso de uso ID de Email + locatário do Microsoft Teams ID de Email + locatário do Azure DevOps Etapas
1 email1@abc.com (locatário 1) email1@abc.com (locatário 1) Selecione Entrar.
2 email1@abc.com (locatário 1) email1@abc.com (locatário 2) Entre no Azure DevOps. No mesmo navegador, inicie uma nova guia e vá para https://teams.microsoft.com/. Execute o comando de entrada e selecione Entrar.
3 email1@abc.com (locatário 1) email2@pqr.com (locatário 2) Selecione Entrar com endereço de email diferente e, em seguida, no seletor de ID de email, use o email2 para entrar no Azure DevOps.
4 email1@abc.com (locatário 1) email2@pqr.com (locatário não padrão 3) Não há suporte para esse cenário.

Solucionar problemas

Se você estiver enfrentando os seguintes erros ao usar o Aplicativo Azure Repos, siga os procedimentos nesta seção.

Algo deu errado. Tente novamente.

O aplicativo Azure Repos usa o protocolo de autenticação OAuth e requer o acesso de aplicativos de terceiros por meio do OAuth para que a organização seja habilitada. Para habilitar essa configuração, navegue até Políticas de Segurança >de Configurações>da Organização e defina o acesso de aplicativos de terceiros por meio do OAuth para a configuração da organização como Ativada.

Habilitar o acesso de aplicativos de terceiros por meio do OAuth para a configuração da organização

Falha na configuração. Verifique se a organização '{organization name}' existe e se você tem permissões suficientes.

Saia do Azure DevOps navegando para https://aka.ms/VsSignout usar seu navegador.

Abra uma janela do navegador em Anônimo ou anônimo e navegue até https://aex.dev.azure.com/me e entre. Na lista suspensa, no ícone de perfil à esquerda, selecione o diretório que contém a organização que contém o repositório ao qual você deseja assinar.

Selecione o diretório que contém a organização que contém o projeto

No mesmo navegador, inicie uma nova guia e entre em https://teams.microsoft.com/. Execute o @Azure Repos signout comando e execute o @Azure Repos signin comando no canal em que o aplicativo Azure Repos para Microsoft Teams está instalado.

Selecione o Sign in botão e você será redirecionado para uma página de consentimento como a do exemplo a seguir. Verifique se o diretório mostrado ao lado do e-mail é o mesmo que foi escolhido na etapa anterior. Aceite e conclua o processo de entrada.

Consentimento para as permissões de aplicativo solicitadas

Se essas etapas não resolverem o problema de autenticação, entre em contato conosco na Comunidade de Desenvolvedores.