Conceitos básicos das notificações do Slack - Amazon CodeCatalyst
Pré-requisitosEtapa 1: conectar o CodeCatalyst ao espaço de trabalho do SlackEtapa 2: adicionar o canal do Slack ao CodeCatalystEtapa 3: testar as notificações do CodeCatalyst para o SlackEtapa 4: Próximas etapas

Conceitos básicos das notificações do Slack

Depois de criar um projeto, é possível configurar as notificações do Slack que ajudam a equipe a monitorar os recursos do projeto.

Essas etapas orientam você a configurar as notificações do Slack pela primeira vez no CodeCatalyst. Se você já configurou as notificações, consulte Envio de notificações do Slack e por e-mail do CodeCatalyst.

nota

O conjunto de eventos do projeto que podem ser enviados para canais de notificação não é igual ao conjunto de eventos sobre os quais os usuários podem escolher serem notificados por e-mail. Para ter mais informações, consulte Envio de notificações do Slack e por e-mail do CodeCatalyst.

Pré-requisitos

Antes de começar, você precisará fazer o seguinte:

  • Um espaço do CodeCatalyst. Para ter informações sobre como criar um espaço do CodeCatalyst e fazer login pela primeira vez, consulte Configuração e login no CodeCatalyst.

  • Um projeto do CodeCatalyst. Para ter mais informações, consulte Como criar um projeto.

  • Uma conta do CodeCatalyst com o perfil de Administrador do projeto ou Administrador do espaço. Para ter mais informações, consulte Concessão de acesso com perfis de usuário.

  • Uma conta do Slack e um espaço de trabalho do Slack que podem ser acessados pelo CodeCatalyst.

  • Um canal do Slack onde o CodeCatalyst enviará notificações. O canal pode ser público ou privado.

Etapa 1: conectar o CodeCatalyst ao espaço de trabalho do Slack

Somente usuários com o perfil de Administrador do espaço podem adicionar ou excluir espaços de trabalho do Slack. A adição ou exclusão de um espaço de trabalho do Slack afeta todos os projetos no espaço. Para estabelecer a conexão entre o CodeCatalyst e o Slack, o CodeCatalyst executa um handshake seguro de autenticação OAuth com seu espaço de trabalho do Slack.

Siga estas instruções para conectar o CodeCatalyst ao espaço de trabalho do Slack.

nota

Isso só precisa ser feito uma vez para cada espaço de trabalho do Slack. Depois, você pode configurar as notificações por canal do Slack.

Para conectar o CodeCatalyst ao espaço de trabalho do Slack

  1. Abra o console do CodeCatalyst em https://codecatalyst.aws/.

  2. Navegue até o projeto.

  3. No painel de navegação, escolha Configurações do projeto.

  4. Escolha a guia Notificações.

  5. Selecione Configurar notificações.

  6. Selecione Conectar ao espaço de trabalho do Slack.

  7. Leia o conteúdo da caixa de diálogo e selecione Conectar ao espaço de trabalho do Slack.

  8. Na mensagem do Chatbot da AWS:

    1. No canto superior direito, escolha o espaço de trabalho do Slack que contém seu canal.

    2. Selecione Permitir.

    Você retornará ao console do CodeCatalyst.

  9. Avance para Etapa 2: adicionar o canal do Slack ao CodeCatalyst.

Etapa 2: adicionar o canal do Slack ao CodeCatalyst

Você precisa do ID do canal do Slack para adicionar seu canal ao CodeCatalyst.

Como ter o ID do canal do Slack

  1. Faça login no Slack. Para ter mais informações, consulte Fazer login no Slack.

  2. Acesse o espaço de trabalho do Slack que contém o canal para o qual você quer que as notificações sejam enviadas. Para ter mais informações, consulte Alternar entre espaços de trabalho do Slack ou Fazer login em outros espaços de trabalho do Slack.

  3. No painel de navegação, abra o menu de contexto (clique com o botão direito do mouse) do canal para o qual deseja que as notificações sejam enviadas e selecione Abrir detalhes do canal.

    O ID do canal é exibido na parte inferior da caixa de diálogo.

  4. Copie o valor de ID do canal. Você precisará dele na próxima etapa.

Usando o ID do canal que acabou de copiar, agora você pode conectar o canal do Slack ao CodeCatalyst.

Para adicionar o canal do Slack ao CodeCatalyst

  1. Antes de começar, se o canal do Slack for privado, adicione a aplicação Chatbot da AWS ao canal da seguinte forma:

    1. Na caixa de mensagem do canal do Slack, insira @aws e escolha o aplicação aws na caixa de diálogo.

    2. Pressione Enter.

      Uma mensagem do Slackbot é exibida indicando que o Chatbot da AWS não está no canal privado.

    3. Selecione Convidar para convidar o Chatbot da AWS para o canal.

  2. No console do CodeCatalyst, selecione Próximo.

  3. Em ID do canal, cole o ID do canal do Slack que você obteve anteriormente.

  4. Em Nome do canal, insira um nome. É recomendável usar o nome do canal do Slack.

  5. Escolha Próximo.

  6. Em Selecionar eventos de notificação, escolha o tipo de evento para o qual você deseja receber notificações.

  7. Escolha Terminar.

Etapa 3: testar as notificações do CodeCatalyst para o Slack

Depois que seu projeto estiver configurado para enviar notificações sobre o status do fluxo de trabalho, você poderá ver as notificações no Slack.

Para visualizar as notificações no Slack

  1. No projeto do CodeCatalyst, inicie um fluxo de trabalho manualmente para concluir a execução do fluxo de trabalho e receber uma notificação de status quando a execução terminar.

  2. No Slack, veja o canal que você configurou para receber notificações. As notificações mostram o status mais recente de cada execução do fluxo de trabalho e se ela falhou ou foi bem-sucedida.

Etapa 4: Próximas etapas

Depois que um espaço de trabalho do Slack estiver configurado para seu espaço do CodeCatalyst, você poderá adicionar outros canais do Slack aos projetos existentes do CodeCatalyst e adicioná-los aos novos projetos depois de criá-los. Você também pode informar aos usuários do projeto que eles podem configurar notificações pessoais do Slack para os IDs de membro do Slack e configurar os eventos para os quais receberão e-mails. Para ter mais informações, consulte Envio de notificações do Slack e por e-mail do CodeCatalyst.