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:
- Adicionar a aplicação Azure Repos à sua equipa no Microsoft Teams
- Conectar o aplicativo Azure Repos ao seu repositório
- Gerir subscrições para eventos relacionados com o repositório no seu canal
- Pesquise e compartilhe informações de RP usando a extensão de composição
- Pré-visualização de URLs de PR
- Remover subscrições e repositórios de um canal
Pré-requisitos
| Categoria | Requerimentos |
|---|---|
| Permissões | - Para criar assinaturas para eventos relacionados ao repositório: Membro do grupo Administradores de Projeto ou administrador da equipa. Para obter mais informações, consulte Alterar permissões no nível do projeto ou Adicionar um administrador de equipe. - Para receber notificações: acesso a aplicativos de terceiros via OAuth configuração habilitada para a organização do Azure DevOps. Para obter mais informações, consulte Alterar políticas de acesso a aplicativos para sua organização. |
Observação
- Você só pode vincular o aplicativo Azure Repos para Microsoft Teams a um projeto hospedado nos Serviços de DevOps do Azure.
- As notificações não são suportadas em mensagens diretas.
Adicionar o aplicativo Azure Repos a uma equipe no Microsoft Teams
Aceda à aplicação Azure Repos no Microsoft Teams Microsoft Teams > Azure Repos.
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.
Introduza o nome de uma equipa ou canal e, em seguida, selecione Configurar um bot.
Conectar o aplicativo Azure Repos ao seu repositório
Assim que a aplicação estiver instalada na sua equipa, introduza o seguinte texto no campo de resposta:
@azure repos signinSe o Microsoft Teams e os Painéis do Azure estiverem em locatários diferentes, selecione Iniciar sessão com umemail diferente.
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.O comando
subscribefaz 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.
Observação
Os administradores de equipe não podem remover ou modificar assinaturas criadas por administradores do Project.
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.
Introduza o seguinte texto no seu canal:
@azure repos subscriptions.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.
Selecione o botão Adicionar assinatura.
Escolha um tipo de evento e, em seguida, selecione Seguinte.
Escolha um repositório e, em seguida, selecione Avançar.
Selecione os filtros apropriados para personalizar a sua assinatura e, em seguida, selecione Enviar.
Observação
- Todos os filtros são normalmente drop-downs. No entanto, se o menu deslizante tiver mais de 100 elementos, terás de inserir manualmente os valores.
- Para o evento TFVC Code Checked in, o filtro Under path deve ser do formato
$/myproject/path.
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.
| Comando | Funcionalidade |
|---|---|
@azure repos subscribe [repo url/ project url] |
Inscrever-se em um repositório ou em todos os repositórios de um projeto para receber notificações |
@azure repos subscriptions |
Adicionar ou remover subscrições para este canal |
@azure repos signin |
Fazer login na sua organização do Azure Repos |
@azure repos signout |
Sair da sua organização do Azure Repos |
@azure repos feedback |
Comunicar um problema ou sugerir uma funcionalidade |
@azure repos unsubscribe all [project url] |
Remover todos os repositórios (pertencentes a um projeto) e as suas subscrições associadas de um canal |
Suporte multitenant
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.
| Caso de uso | ID de e-mail + cliente do Microsoft Teams | ID de Email + locatário do Azure DevOps | Passos |
|---|---|---|---|
| 1 | email1@abc.com (inquilino 1) | email1@abc.com (inquilino 1) | Selecione Entrar. |
| 2 | email1@abc.com (inquilino 1) | email1@abc.com (inquilino 2) | Iniciar sessão no Azure DevOps. No mesmo navegador, inicie uma nova guia e vá para https://teams.microsoft.com/. Execute o comando signin e selecione Entrar. |
| 3 | email1@abc.com (inquilino 1) | email2@pqr.com (inquilino 2) | Selecione Entrar com endereço de email diferentee, em seguida, no seletor de ID de email, use o email2 para entrar no Azure DevOps. |
| 4 | email1@abc.com (inquilino 1) | email2@pqr.com (locatário não padrão 3) | Este cenário não é suportado. |
Diagnóstico de problemas
Se você estiver enfrentando os seguintes erros ao usar o Aplicativo Azure Repos, siga os procedimentos nesta seção.
- Desculpe, ocorreu um problema. Por favor, tente novamente.
- Falha na configuração. Certifique-se de que a organização '{nome da organização}' existe e que tem permissões suficientes.
Desculpe, ocorreu um problema. Por favor, tente novamente.
A aplicação Azure Repos utiliza o protocolo de autenticação OAuth e requer que o acesso a aplicações de terceiros via OAuth esteja ativado na organização. Para habilitar essa configuração, navegue até Configurações da Organização>Políticas de Segurança>e defina a configuração Acesso a aplicativos de terceiros via OAuth para a configuração da organização como On.
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.
Selecione o botão Sign in e você será redirecionado para uma página de consentimento como a do exemplo a seguir. Certifique-se de que o diretório mostrado ao lado do e-mail é o mesmo que foi escolhido na etapa anterior. Aceite e conclua o processo de início de sessão.
Se estas etapas não resolverem seu problema de autenticação, entre em contato conosco na Comunidade de desenvolvedores.