Usar o Azure Repos com o Microsoft Teams

Serviços do Azure DevOps

Se você usar o Microsoft Teams e o Azure Repos, poderá usar o aplicativo Azure Repos para o 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, saiba como realizar as seguintes tarefas:

Pré-requisitos

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.

   

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.

   

   

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 comando subscribe inicia você 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.

   

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.

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 Próximo.

   

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

   

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

   

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 @azure repos signin ou entrando diretamente na extensão de redação.

Visualizar URLs de solicitação de pull

Quando você cola a URL de um PR, uma prévia é exibida, como na imagem a seguir, o que ajuda a manter as conversas sobre a PR contextuais e precisas. Entre e, em seguida, você poderá visualizar PRs para URLs em todos os canais em uma equipe.

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 relacionadas a um determinado pull request estão interligadas.

exibição compacta de notificações encadeadas

exibição expandida de notificações encadeadas

Referência de comando

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

Suporte multiusuá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.

Solucionar problemas

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

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

Saia do Azure DevOps navegando até https://aka.ms/VsSignout usando 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.

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

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

Artigos relacionados

• Azure Boards com o Teams
• Azure Pipelines com o Teams