Usar o Azure Pipelines com o Microsoft Teams

  • Artigo

Serviços de DevOps do Azure

A aplicação Azure Pipelines para Microsoft Teams permite-lhe monitorizar eventos para os seus pipelines. Você pode configurar e receber notificações no seu canal do Teams para lançamentos, aprovações pendentes, compilações concluídas e assim por diante. Você também pode aprovar lançamentos no seu canal do Teams.

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.

Pré-requisitos

  • Você deve ter um projeto do Azure DevOps. Para mais informações, consulte Criar um projeto.
  • Para configurar assinaturas de pipeline, você deve ser um Administrador de Projeto.

Configurar o aplicativo Azure Pipelines

  1. No Microsoft Teams, vá para a loja de Aplicativos, procure Pipelines do Azure e 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 pendente Abrir e, em seguida, selecione Adicionar a uma equipa.

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

  3. Selecione ou insira o nome da sua equipe e, em seguida, escolha Configurar um bot.

    Selecionando o botão Configurar um bot.

  4. No painel de conversação do Teams, insira @azurePipelines signin.

  5. Selecione Entrar e concluir a autenticação no Azure Pipelines.

Utilizar comandos

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

  • Monitore todos os pipelines em um projeto. O URL pode ser para qualquer página dentro do seu projeto, exceto URLs para pipelines. Por exemplo, @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]

  • Monitorar um pipeline específico: o URL do pipeline pode ser para qualquer página dentro do seu pipeline que tenha um definitionId ou buildId/releaseId presente no URL. Por exemplo, @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]

    Outro exemplo de um pipeline de liberação que está inscrito nas notificações de implantação de versão iniciada, implantação de versão concluída e aprovação de implantação de liberação pendente é @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Nota

  • Não oferecemos suporte a aprovações de implantação que tenham aplicado a identidade Revalidar aprovador antes de concluir a política de aprovação .
  • Habilite o 'Acesso a aplicativos de terceiros via OAuth' para receber notificações para a organização no Azure DevOps.

Gerir subscrições

Quando você se inscreve em um pipeline, algumas assinaturas são criadas por padrão sem filtros aplicados. Talvez você queira personalizar essas assinaturas. 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. O aplicativo Azure Pipelines dá suporte a filtros para personalizar o que você vê em seu canal. Para gerenciar suas assinaturas, conclua as etapas a seguir.

  1. Execute o comando @azure pipelines subscriptions.

  2. Selecione Ver todas as subscrições. Na lista de subscrições, se existir uma subscrição que não pretende, selecione Remover. Vista da lista de subscrições.

  3. Desloque-se para baixo e selecione Adicionar subscrição.

  4. Selecione o pipeline e o evento necessários.

  5. Selecione os filtros apropriados e, em seguida , Guarde.

    Exemplo 1: Obter notificações para compilações com falha.

    Visual de falhas de build no Teams.

    Exemplo 2: receba notificações somente se as implantações forem enviadas por push para o ambiente de produção.

    Visual da notificação de falhas.

    Nota

    • Os Administradores de Equipa não podem remover ou modificar subscrições criadas por Administradores de Projeto.
    • As notificações não são suportadas no chat/mensagens diretas.

Aprovar implantações do seu canal

Você pode aprovar implantações de dentro do seu canal sem ir para o portal do Azure Pipelines. Assine a Aprovação de implantação de versão pendente de notificação para Versões clássicas ou o estágio Executar aguardando notificação de aprovação para pipelines YAML. Ambas as assinaturas são criadas por padrão quando você se inscreve no pipeline.

No Teams, aviso pronto para aprovação.

Sempre que a execução de uma etapa estiver pendente para aprovação, um cartão de notificação com opções para aprovar ou rejeitar a solicitação é postado no canal. Os aprovadores podem rever os detalhes do pedido na notificação e tomar as medidas adequadas. No exemplo a seguir, a implantação foi aprovada e o status de aprovação é exibido no cartão.

Cartão mostrando a implantação aprovada.

O aplicativo Azure Pipelines dá suporte a todos os cenários de verificação e aprovação presentes no portal Azure Pipelines. Você pode aprovar solicitações individualmente ou em equipe.

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

Para ajudar os usuários a pesquisar e compartilhar informações sobre pipelines, o aplicativo Azure Pipelines para Microsoft Teams oferece suporte à extensão de composição. Agora você pode pesquisar pipelines por ID de pipeline ou por nome de pipeline. Para que a extensão de composição funcione, os usuários devem entrar no projeto do Azure Pipelines no qual estão interessados executando @azure pipelines signin o comando ou entrando diretamente na extensão de composição.

Compor extensão.

Pré-visualizações de URLs de pipeline

Quando adiciona um URL de pipeline ao Teams, vê uma pré-visualização semelhante às imagens seguintes. A visualização ajuda a manter as conversas relacionadas ao pipeline relevantes e atualizadas. Você pode escolher entre cartões compactos e expandidos.

Exemplo 1: Pré-visualização do URL de compilação

Crie um desfralde de URL.

Exemplo 2: Pré-visualização do URL de versão

Desfraldar URL de lançamento.

Depois de iniciar sessão, esta funcionalidade funciona para todos os canais de uma equipa no Microsoft Teams.

Cancelar inscrição de um canal de pipeline

Use o comando a seguir para cancelar a inscrição de todos os pipelines dentro de um projeto.

@azure pipelines unsubscribe all [project url]

Exemplo: Cancelar inscrição de todos com URL

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

Este comando exclui todas as assinaturas relacionadas a qualquer pipeline no projeto e remove os pipelines do canal.

Importante

Somente os administradores de projeto podem executar esse comando.

Todas as notificações vinculadas a uma execução específica de um pipeline são vinculadas.

Exemplo 1: Vista compacta de notificações ligadas.

Rosca compacta

Exemplo 2: Vista expandida de notificações ligadas.

Thread expandido

Usar comandos no aplicativo Azure Pipelines

Consulte os seguintes comandos suportados pela aplicação Azure Pipelines:

Comando Barra Caraterística
@azure Pipelines Subscribe [URL do pipeline/ URL do projeto] Inscrever-se em um pipeline ou em todos os pipelines de um projeto para receber notificações
@azure Assinaturas de pipelines Adicionar ou remover subscrições para este canal
@azure feedback de pipelines Comunicar um problema ou sugerir uma funcionalidade
@azure ajuda pipelines Obter ajuda sobre os comandos de barra
@azure entrada de pipelines Entre na sua conta do Azure Pipelines
@azure Saída de pipelines Sair da sua conta do Azure Pipelines
@azure pipelines cancelar inscrição todos [url do projeto] Remover todos os pipelines (pertencentes a um projeto) e suas assinaturas associadas de um canal

Conectar multilocatários

Se você estiver usando um email ou locatário diferente para o Microsoft Teams e o Azure DevOps, siga as etapas a seguir para entrar e se conectar com base no seu caso de uso.

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

Resolver problemas

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 Sign in botão 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 você escolheu na etapa anterior. Aceite e conclua o processo de login.

Consentimento para as permissões solicitadas do aplicativo

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