Integrar o Azure Pipelines com o Microsoft Teams

Serviços de DevOps do Azure

Este artigo mostra como usar o aplicativo Azure Pipelines para Microsoft Teams para monitorar eventos de pipeline. Você pode configurar e receber notificações em seu canal do Teams para compilações, lançamentos e aprovações de pipeline. Os aprovadores também podem aprovar lançamentos no canal do Teams.

Pré-requisitos

• Acesso a uma Equipa no Microsoft Teams onde pode adicionar uma aplicação.
• Permissões de Administrador de Projeto ou Administrador de Criação em um projeto do Azure DevOps. Para obter mais informações, consulte Criar um projeto e Recursos de segurança de pipeline.
• Acesso a aplicativos de terceiros por meio de OAuth habilitado nas configurações organizacionais do Azure DevOps.

Configurar o aplicativo Azure Pipelines

1. No Microsoft Teams, selecione Aplicações, procure Pipelines do Azure e, em seguida, selecione Azure Pipelines.

   

2. Selecione a seta suspensa ao lado de Adicionar e selecione Adicionar a uma equipe.

   

3. Selecione ou introduza o nome da sua equipa e, em seguida, selecione Configurar um bot.

   

Usar comandos do aplicativo Azure Pipelines

O aplicativo Azure Pipelines Teams dá suporte aos seguintes comandos:

Entrar no Azure Pipelines

1. No painel de conversação do Teams, insira @azurePipelines signin.
2. Selecione Entrar e concluir a autenticação no Azure Pipelines.

Subscrever pipelines

Use os comandos a seguir para assinar e monitorar todos os pipelines em um projeto ou apenas pipelines específicos.

• Todos os pipelines em um projeto: a URL pode ser para seu projeto ou qualquer página dentro de seu projeto, exceto para um pipeline. Por exemplo:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• Um pipeline específico: o URL do pipeline pode ser para qualquer página dentro de um pipeline que tenha um definitionId ou buildId/releaseId no URL. Por exemplo:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

Expandir notificações vinculadas

Todas as respostas a uma publicação específica estão interligadas.

Para expandir o thread, selecione o link de thread compactado.

Gerir subscrições

Quando você se inscreve em um pipeline, algumas assinaturas são criadas por padrão sem filtros aplicados. Essas assinaturas incluem Estado de execução alterado e estágio de execução aguardando aprovação para pipelines YAML e aprovação de implantação de versão pendente para versões clássicas. Pode remover estas subscrições ou adicionar mais subscrições.

O aplicativo Azure Pipelines também dá suporte a filtros para personalizar o que você vê em seu canal. Por exemplo, talvez você queira ser notificado somente quando as compilações falharem ou quando as implantações forem enviadas por push para um ambiente de produção.

Para gerenciar suas assinaturas, conclua as etapas a seguir.

1. Para listar todas as assinaturas de pipelines, execute o @azure pipelines subscriptions comando.

   

2. Para remover uma subscrição, selecione Ver todas as subscrições. Selecione Remover em qualquer subscrição que não pretenda e, em seguida, selecione OK.

3. Para adicionar uma assinatura, selecione Adicionar assinatura.

4. Selecione o evento e o pipeline que você deseja assinar e selecione Avançar.

5. Escolha os filtros de Palco e Ambiente desejados, selecione Enviar e, em seguida, selecione OK.

   Por exemplo, a assinatura a seguir fornece notificações para o estágio _default somente quando o estado Concluído é Falha.

   

Ver notificações de aprovação

Para ver as notificações de aprovação, certifique-se de se inscrever no estágio Executar aguardando a notificação de aprovação para pipelines YAML ou a notificação de aprovação de implantação de liberação pendente para versões clássicas. Essas assinaturas são criadas por padrão quando você se inscreve no pipeline.

Se você se inscrever na notificação Aprovação do estágio Executar concluída , também poderá ver quando o estágio será aprovado.

Aprove a partir do seu canal

Se você for um aprovador, poderá aprovar implantações de dentro do seu canal do Teams. O aplicativo Azure Pipelines dá suporte a todas as verificações e cenários de aprovação do Azure Pipelines. Você pode aprovar solicitações individualmente ou em equipe.

Sempre que a execução de um estágio estiver pendente de sua aprovação, o aplicativo publica um cartão de notificação com opções para Aprovar ou Rejeitar a solicitação no canal. Pode rever os detalhes do pedido na notificação e tomar as medidas adequadas.

A resposta é enviada para o aplicativo.

Se você se inscreveu para Executar notificações concluídas de aprovação de estágio, você também pode ver quando o estágio é aprovado.

Cancelar inscrição de um canal

Execute o unsubscribe comando para excluir todas as assinaturas relacionadas a qualquer pipeline no projeto e remover os pipelines do canal. Por exemplo:

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Para excluir o projeto e todas as assinaturas do canal, selecione Continuar.

Use a extensão de composição

Para ajudá-lo a pesquisar e compartilhar informações sobre pipelines, o aplicativo Azure Pipelines for Teams dá suporte a uma extensão de composição em mensagens. Você pode usar a extensão para pesquisar pipelines em um projeto por ID de pipeline ou nome de pipeline.

Para usar a extensão, você deve estar conectado ao projeto Azure Pipelines no canal do Teams. Selecione o + símbolo no campo de mensagem, selecione Azure Pipelines e procure seu pipeline ou release.

Pré-visualização de URLs de pipeline

Quando você usa a extensão de composição para adicionar uma URL de pipeline a uma mensagem do Teams, você vê uma visualização semelhante às imagens a seguir. A visualização ajuda a manter as conversas relacionadas ao pipeline relevantes e atualizadas.

O exemplo a seguir mostra uma visualização de URL de versão:

Conectar vários locatários

Se você usa emails ou locatários diferentes para o Microsoft Teams e o Azure DevOps, siga estas etapas para entrar e se conectar com base em suas configurações.

Resolver problemas de autenticação

No mesmo browser, inicie um novo separador e inicie sessão no https://teams.microsoft.com/. Execute o @Azure Pipelines signout comando e, em seguida, execute @Azure Pipelines signin o comando no canal onde o aplicativo Azure Pipelines para Microsoft Teams está instalado.

Selecione o botão Entrar e conclua o processo de login. Certifique-se de que o diretório mostrado é o mesmo que você escolheu na etapa anterior.

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

Artigos relacionados

• Usar painéis do Azure com o Microsoft Teams
• Usar o Azure Repos com o Microsoft Teams