Partilhar via

Integrar o Azure Pipelines com o Microsoft Teams

  • Artigo

Serviços de DevOps do Azure

Nota

Esse recurso só está disponível nos Serviços de DevOps do Azure. Normalmente, os novos recursos são introduzidos primeiro no serviço de nuvem e, em seguida, disponibilizados no local na próxima versão principal ou atualização do Azure DevOps Server. Para saber mais, consulte Linha do tempo do recurso do Azure DevOps.

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.

Nota

As notificações do Azure Pipelines não são suportadas no chat ou nas mensagens diretas do Teams.

Pré-requisitos

Configurar o aplicativo Azure Pipelines

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

    Captura de ecrã a mostrar a seleção do botão Aplicações e, em seguida, do botão Pipelines do Azure.

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

    Captura de ecrã a mostrar a seleção do botão Abrir e, em seguida, Adicionar a uma equipa.

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

    Captura de tela mostrando a seleção do botão Configurar um bot.

Usar comandos do aplicativo Azure Pipelines

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

Comando Barra Caraterística
@azure entrada de pipelines Entre na sua conta do Azure Pipelines.
@azure Saída de pipelines Saia da sua conta do Azure Pipelines.
@azure Pipelines Subscrever <URL do pipeline | URL do projeto> Assine um pipeline ou todos os pipelines em um projeto para receber notificações.
@azure Assinaturas de pipelines Visualize, adicione ou remova subscrições para este canal.
@azure pipelines cancelar a inscrição de todos os <url do projeto> Remova todos os pipelines pertencentes a um projeto e suas assinaturas associadas de um canal.
@azure ajuda pipelines Obtenha ajuda sobre os comandos.
@azure feedback de pipelines Denuncie um problema ou sugira um recurso.

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.

Captura de ecrã a mostrar a vista de thread compacta.

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

Captura de ecrã a mostrar a vista de thread expandida.

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.

    Captura de ecrã a mostrar a vista da lista de subscrições.

  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.

    Captura de ecrã a mostrar filtros para notificações.

Nota

Os Administradores de Equipa não podem remover ou modificar subscrições criadas por Administradores de Projeto.

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.

Cartão mostrando a implantação aprovada.

Nota

Não é possível assinar aprovações de implantação que tenham a identidade Revalidar aprovador antes de concluir a política de aprovação aplicada.

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.

Captura de tela mostrando a notificação pronta para aprovação.

A resposta é enviada para o aplicativo.

Captura de ecrã a mostrar a notificação pendente de aprovação.

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

Captura de tela mostrando a mensagem pendente de cancelamento de inscrição.

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

Importante

Somente os administradores de projeto podem executar esse comando.

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.

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

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.

Captura de tela mostrando o desfraldar URL de compilação.

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

Captura de tela mostrando o desenrolamento do URL de lançamento.

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.

Microsoft Stream Azure DevOps Iniciar sessão em ação
email1@abc.com (inquilino1) email1@abc.com (inquilino1) Selecione Iniciar sessão
email1@abc.com (inquilino1) email2@pqr.com (inquilino2) 1. Entre no Azure DevOps.
2. No mesmo navegador, inicie uma nova guia e vá para https://teams.microsoft.com/.
3. Execute o sign in comando e selecione Entrar.
email1@abc.com (inquilino1) email2@pqr.com (inquilino2) 1. Selecione Entrar com endereço de e-mail diferente.
2. No seletor de ID de e-mail, use o email2 para entrar.
email1@abc.com (inquilino1) email2@pqr.com (locatário não padrão3) Não suportado.

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.