Partilhar via

Utilizar Azure Pipelines com Slack

Serviços de DevOps do Azure

Este artigo mostra como usar o aplicativo Azure Pipelines for Slack para monitorar seus eventos de pipeline. Você pode estabelecer e gerenciar assinaturas para eventos de pipeline, como compilações, versões e aprovações pendentes. As notificações desses eventos são entregues diretamente nos canais do Slack.

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 obter mais informações, consulte Linha do tempo do recurso do Azure DevOps.

Pré-requisitos

  • Uma conta do Slack com permissão para instalar um aplicativo no seu espaço de trabalho do Slack.
  • Um projeto do Azure DevOps com permissões de Administradores de Coleção de Projetos ou Administradores de Projeto .
  • Não deve ser um usuário externo no Microsoft Entra.

Instalar o aplicativo Azure Pipelines

Instale o aplicativo Azure Pipelines Slack em seu espaço de trabalho do Slack. Depois que o aplicativo for instalado, você verá a seguinte mensagem de boas-vindas. Enter /azpipelines para começar a interagir com o aplicativo.

Captura de ecrã da mensagem de boas-vindas da aplicação Azure Pipelines.

Conecte-se à sua linha de produção

Depois de instalar a aplicação no seu espaço de trabalho do Slack, ligue-a a qualquer pipeline que queira monitorizar. Autentifique no Azure Pipelines antes de executar quaisquer comandos.

Captura de ecrã da mensagem de início de sessão.

Nota

Se sua organização do Azure DevOps estiver conectada a um locatário do Microsoft Entra ID, você deverá entrar com um membro nativo desse locatário. Os usuários externos recebem o seguinte erro se tentarem entrar no aplicativo Azure Pipelines: Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.

Subscrever fluxos de trabalho

Para começar a monitorizar todos os pipelines em um projeto, insira /azpipelines subscribe <project url> em um canal, substituindo <project url> pela URL do projeto do Azure DevOps. A URL do projeto pode ser vinculada a qualquer página dentro do seu projeto, exceto páginas de pipeline, por exemplo /azpipelines subscribe https://dev.azure.com/myorg/myproject/.

Você pode monitorar um pipeline específico usando /azpipelines subscribe <pipeline url>. A URL do pipeline pode ser vinculada a qualquer página dentro do seu pipeline que tenha um definitionId ou um buildId/releaseId no URL. Por exemplo:

  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases

O subscribe comando inscreve você para as seguintes notificações por padrão:

  • Para pipelines YAML:
    • Estado do estágio de execução alterado
    • Etapa de execução aguardando aprovação
  • Para pipelines de construção clássicos, construções concluídas
  • Para pipelines de versionamento Clássico:
    • Implantação de versão iniciada
    • Implantação do lançamento concluída
    • Aprovação de implantação de liberação pendente

Captura de ecrã de um exemplo de notificação.

Gerir subscrições

Para gerir as subscrições de um canal, introduza /azpipelines subscriptions. Este comando lista todas as subscrições atuais do canal e permite-lhe adicionar ou remover subscrições.

Captura de ecrã de uma lista de subscrições.

Nota

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

Personalizar subscrições

As subscrições predefinidas não têm filtros aplicados, mas pode personalizar estas subscrições de acordo com as suas preferências. Por exemplo, pode querer receber notificações apenas para compilações falhadas ou implementações em produção. Você pode aplicar filtros para personalizar quais mensagens você recebe em seu canal.

Para personalizar uma assinatura:

  1. Execute o /azpipelines subscriptions comando para listar todas as suas assinaturas.
  2. Clique em Adicionar subscrição.
  3. Selecione o evento para o qual pretende subscrever e, em seguida, selecione a configuração pretendida.
  4. Selecione Guardar.

Para receber notificações apenas para versões falhadas, selecione Falhado no estado de Compilação.

Captura de ecrã de como personalizar uma subscrição.

Aprovar implantações

Podes aprovar implementações a partir do teu canal do Slack sem teres de ir ao Azure Pipelines. Inscreva-se no estágio Executar aguardando notificações de aprovação para pipelines YAML ou as notificações de aprovação de implantação de liberação pendentes para versões clássicas. Ambas as assinaturas são criadas por padrão quando você assina um pipeline.

Captura de ecrã da aprovação do pipeline no Slack.

O aplicativo Azure Pipelines for Slack permite lidar com todos os cenários de verificação e aprovação disponíveis no portal do Azure Pipelines. Esses cenários incluem um único aprovador, vários aprovadores e aprovação baseada em equipe. Você pode aprovar solicitações individualmente ou em nome de uma equipe.

Captura de tela de um pipeline de pré-implementação aprovado no Slack.

Remover todas as subscrições

Para desorganizar o seu canal, use o /azpipelines unsubscribe all <project url> comando para cancelar a subscrição de todos os pipelines de um projeto. Por exemplo, /azpipelines unsubscribe all https://dev.azure.com/myorg/myproject.

Importante

Somente os administradores de projeto podem executar esse comando.

Referência de comando

O aplicativo Azure Pipelines para Slack dá suporte aos seguintes comandos:

Comando Descrição
/azpipelines subscribe <pipeline url or project url> Subscreva um pipeline ou todos os pipelines de um projeto e receba notificações.
/azpipelines subscriptions Adicione ou remova subscrições para este canal.
/azpipelines feedback Denuncie um problema ou sugira um recurso.
/azpipelines help Obtenha ajuda sobre os comandos.
/azpipelines signin Entre na sua conta do Azure Pipelines.
/azpipelines signout Saia da sua conta do Azure Pipelines.
/azpipelines unsubscribe all <project url> Remova todos os pipelines de projeto e as suas assinaturas associadas de um canal.

Notificações em canais privados

O aplicativo Azure Pipelines também pode ajudá-lo a monitorar a atividade de pipelines em seus canais privados. Você precisa convidar o bot para seu canal privado usando /invite @azpipelines. Depois de adicionar o bot, você pode configurar e controlar suas notificações da mesma forma que para um canal público.

Resolução de Problemas

Se você receber os seguintes erros ao usar o Aplicativo de Pipelines do Azure para Slack, tente o procedimento a seguir.

Falha na configuração. Verifique se a organização existe e se você tem permissões suficientes.

Se você estiver vendo esse erro, provavelmente será um usuário convidado no locatário do Microsoft Entra conectado à sua organização do Azure DevOps. Você precisa ter um membro do Microsoft Entra passando pelas etapas de configuração.

  • Last updated on