Configurando o Slack

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

O Slack é um sistema de mensagens e um sistema de notificação tempo real baseados na nuvem.

Agora você pode distribuir notificações de eventos usando a integração da ferramenta Event NotificationsIBM Cloud® Event Notifications é o método preferido para distribuir notificações para o Slack e outros canais de comunicação, como PagerDuty, e-mail, SMS, notificações por push, webhook, Microsoft® Teams, ServiceNow, e IBM Cloud Functions. Para obter mais informações sobre o uso do site Event Notifications, consulte Ativação de notificações de eventos para toolchains.

Os eventos da cadeia de ferramentas personalizada do cliente gerados pela API POST {toolchain_id} /toolchains//events não são enviados para a integração da ferramenta Slack. Eventos de cadeia de ferramentas personalizados são enviados apenas para IBM Cloud® Event Notifications.

O Slack fornece o bate-papo persistente, que é uma alternativa interativa ao e-mail para a colaboração da equipe. É possível se comunicar com sua equipe em um canal dedicado ou em um conjunto de canais diretamente relacionado ao seu trabalho. Também é possível compartilhar arquivos e imagens por meio dos canais ou em mensagens diretas entre duas ou mais pessoas. As comunicações nas mensagens diretas e nos canais são retidas para que seja possível procurá-las.

As notificações que são postadas em canais públicos do Slack são visíveis para todos na equipe. Você será responsável pelo conteúdo que postar.

Configure o Slack para recuperar notificações sobre sua cadeia de ferramentas a partir das integrações de ferramenta, como atividades de teste e de implementação:

  1. Se você estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, na seção Integrações configuráveis, clique em Slack.

  2. Se você já possui uma cadeia de ferramentas e deseja adicionar essa integração de ferramenta a ela, no console do IBM Cloud, clique no ícone de menu ( ícone de hambúrguer ) > Automação de Plataforma > Cadeias de Ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral.

    a. Clique em Incluir ferramenta.

    b. Na seção Integrações de ferramenta, clique em Slack.

  3. Digite a URL de webhook do Slack, que é gerada pelo Slack como um webhook recebido. É necessária uma URL do webhook do Slack para que um canal Slack receba notificações sobre sua cadeia de ferramentas das integrações de ferramentas. Para obter instruções sobre como criar ou localizar seu webhook, consulte “Webhooks de entrada ”.

Se você usa uma chave de API para seu canal Slack para receber notificações sobre sua cadeia de ferramentas por meio das integrações de ferramentas, deve-se atualizar sua configuração para usar um webhook em seu lugar.

  1. Digite o nome do canal Slack para o qual deseja que as notificações sejam enviadas. O canal deve existir e estar ativo na equipe do Slack.

  2. Digite o nome do host da URL para sua equipe do Slack, que é a palavra ou a frase antes de .slack.com na URL de sua equipe. Por exemplo, se a URL de sua equipe for https://team.slack.com, o nome do host será team.

  3. Clique em Criar integração.

    Se a equipe ou o canal do Slack que você especificou não puderem ser acessados, o erro Setup Failed será exibido na placa do Slack. Passe o mouse sobre a mensagem Setup Failed e clique em Reconfigurar. Certifique-se de que esteja usando parâmetros de configuração válidos para a URL do webhook do Slack, o canal Slack e o nome do host da URL para sua equipe do Slack. Atualize as configurações conforme necessário e clique em Salvar integração.

  4. Na página de visão geral da sua caixa de ferramentas, na placa Ferramentas de terceiros, clique em Slack. É possível visualizar todas as atividades para sua cadeia de ferramentas no canal Slack configurado.

Configurando o Slack usando a API

A integração da ferramenta Slack suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs HTTP da Toolchain ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor slack.

Parâmetros de integração da ferramenta Slack
Parâmetro Uso Tipo Argumento de Terraform Descrição
token_api necessário, atualizável Senha webhook O webhook de entrada que o Slack usa para receber eventos. Você pode usar uma referência de segredos de cadeia de ferramentas para este parâmetro. Para obter mais informações sobre referências de segredos, consulte Protegendo seus dados sensíveis em IBM Cloud.
channel_name necessário, atualizável Sequência channel_name O canal do Slack no qual as notificações devem ser publicadas.
falha no pipeline opcional, atualizável, Default: true Booleano falha no pipeline Gera pipeline failed notificações.
início_do_pipeline opcional, atualizável, Default: true Booleano início_do_pipeline Gera pipeline start notificações.
pipeline_sucesso opcional, atualizável, Default: true Booleano pipeline_sucesso Gera pipeline succeeded notificações.
url_da_equipe opcional, atualizável Sequência nome_da_ O nome da equipe do Slack, que é a palavra ou frase antes do slack.com ponto (.) na equipe URL.
vinculação da cadeia de ferramentas opcional, atualizável, Default: true Booleano vinculação da cadeia de ferramentas Gera tool added to toolchain notificações.
desvincular_conjunto_de_ferramentas opcional, atualizável, Default: true Booleano desvincular_conjunto_de_ferramentas Gera tool removed from toolchain notificações.

Ativando notificações do Slack para o Tekton Pipelines

É possível configurar um Tekton Pipeline para enviar eventos para integrações do Slack.

  1. Na página “Visão geral” da sua cadeia de ferramentas, no cartão “Pipelines de entrega ”, clique no Delivery Pipeline para abrir o painel “ Delivery Pipeline ” do Tekton.
  2. Na página Configurações > Configurações avançadas, ative Event Notifications..
  3. Salve as mudanças.