Usar o Azure Repos com o Microsoft Teams

Serviços de DevOps do Azure

Se você usar Microsoft Teams e Azure Repos, poderá usar o aplicativo Azure Repos for Teams para monitorar suas repos. O aplicativo suporta o monitoramento de repositórios Git e Team Foundation Version Control (TFVC), mas não suporta integração com repositórios GitHub.

Neste artigo, saiba como executar as seguintes tarefas:

Pré-requisitos

Adicionar o aplicativo Azure Repos a uma equipe no Microsoft Teams

1. Aceda à aplicação Azure Repos no Microsoft Teams Microsoft Teams > Azure Repos.

2. Selecione Adicionar ou, se já tiver descarregado a aplicação, selecione o menu suspenso próximo de Abrire, em seguida, selecione Adicionar a uma equipa.

3. Introduza o nome de uma equipa ou canal e, em seguida, selecione Configurar um bot.

   

Conectar o aplicativo Azure Repos ao seu repositório

1. Assim que a aplicação estiver instalada na sua equipa, introduza o seguinte texto no campo de resposta: @azure repos signin

   Se o Microsoft Teams e os Painéis do Azure estiverem em locatários diferentes, selecione Iniciar sessão com umemail diferente.

   

   

2. Para monitorar todos os repositórios Git em um projeto, insira @azure repos subscribe [project url] no canal. Certifique-se de adicionar o URL do seu projeto. O URL do projeto pode ser para qualquer página dentro do seu projeto (exceto URLs para repositórios).

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

   O URL do repositório pode ser para qualquer página dentro do seu repositório que tenha seu nome de repositório, por exemplo, @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo, ou para repositórios TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

3. O comando subscribe faz você começar com uma assinatura padrão. Para repositórios Git, o canal é inscrito no evento de criação de Pull Request (com o ramo de destino igual a main). Para repositórios TFVC, o canal está inscrito no evento de código verificado.

   

Gerir subscrições

Para visualizar, adicionar e remover subscrições de um canal, introduza 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.

Use filtros para receber apenas as notificações desejadas

Quando você assina um repositório com @azure repos subscribe, uma assinatura padrão é criada sem filtros aplicados. Muitas vezes, os usuários precisam personalizar essas assinaturas para serem notificados somente quando certas 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 revisores de um RP.

1. Introduza o seguinte texto no seu canal: @azure repos subscriptions.

2. Na lista de subscrições, se existir uma subscrição que não pretende ou que tem de ser modificada, selecione Remover para a eliminar.

3. Selecione o botão Adicionar assinatura.

4. Escolha um tipo de evento e, em seguida, selecione Seguinte.

   

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

   

6. Selecione os filtros apropriados para personalizar a sua assinatura e, em seguida, selecione Enviar.

   

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

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

Visualizar URLs de solicitação pull

Quando você cola o URL de um RP, uma visualização é exibida como a da imagem a seguir, o que ajuda a manter as conversas relacionadas a RP contextuais e precisas. Inicie sessão e, em seguida, pode pré-visualizar PRs para URLs em todos os canais de uma Equipa.

Remover subscrições 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]. Certifique-se de inserir 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 para reduzir o espaço ocupado pelas notificações em um canal, as notificações são encadeadas. Todas as notificações relacionadas a um determinado pull request estão interligadas.

Vista compacta de notificações encadeadas

Vista expandida de notificações encadeadas

Referência de comando

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

Suporte multilocatário

Se estiver a utilizar um e-mail ou inquilino diferente para o Microsoft Teams e o Azure DevOps, siga os seguintes passos para iniciar sessão, com base no seu caso de utilização.

Diagnóstico de problemas

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

Falha na configuração. Certifique-se de que a organização '{nome da organização}' existe e que tem permissões suficientes.

Saia do Azure DevOps navegando até https://aka.ms/VsSignout usando seu navegador.

Abra uma janela de navegação privada ou janela de navegação anónima no navegador e aceda ao https://aex.dev.azure.com/me para iniciar sessão. Na lista suspensa sob o ícone de perfil à esquerda, selecione o diretório onde se encontra a organização que possui o repositório ao qual deseja se inscrever.

No mesmo navegador, inicie um novo separador e faça login no https://teams.microsoft.com/. Execute o comando @Azure Repos signout e, em seguida, execute o comando @Azure Repos signin no canal onde o aplicativo Azure Repos para Microsoft Teams está instalado.

Se estas etapas não resolverem seu problema de autenticação, entre em contato conosco na Comunidade de desenvolvedores.

Artigos relacionados

• Azure Boards com Teams
• Pipelines do Azure com Microsoft Teams