IBM Cloud Docs
Configurando o Slack

Configurando o Slack

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 Notifications. IBM 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 como usar Event Notifications, consulte Ativando notificações de eventos para cadeias de ferramentas.

Os eventos da cadeia de ferramentas sob medida do cliente gerados pela API POST /toolchains/{toolchain_id}/events não são enviados para a integração da ferramenta Slack. Eventos da cadeia de ferramentas bespoke 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ê tiver uma cadeia de ferramentas e estiver adicionando essa integração de ferramentas a ela, no console IBM Cloud, clique no ícone de hambúrguer Menu > Automação da 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. Como alternativa, na página Visão Geral do seu app, no cartão Entrega contínua, clique em Visualizar a cadeia de ferramentas. Em seguida, clique em 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.

Configuração do Slack usando a API

A integração da ferramenta Slack suporta os seguintes parâmetros de configuração que você pode usar com o Toolchain HTTP API e SDKs quando você criar, reade update 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
api_token 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 para publicar notificações.
pipeline_fail opcional, atualizável, Default: true Booleano pipeline_fail Gera pipeline failed notificações.
pipeline_start opcional, atualizável, Default: true Booleano pipeline_start Gera pipeline start notificações.
pipeline_sucesso opcional, atualizável, Default: true Booleano pipeline_sucesso Gera pipeline succeeded notificações.
team_url opcional, atualizável Sequência nome_da_ O nome da equipe Slack, que é a palavra ou frase antes do .slack.com na URL da equipe.
toolchain_bind opcional, atualizável, Default: true Booleano toolchain_bind Gera tool added to toolchain notificações.
toolchain_unbind opcional, atualizável, Default: true Booleano toolchain_unbind 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 Overview (Visão geral) de sua cadeia de ferramentas, no cartão " Pipelines de entrega, clique em " Delivery Pipeline para abrir o painel " Delivery Pipeline da Tekton.
  2. Na página Configurações > Configurações avançadas, ative Event Notifications..
  3. Salve as mudanças.