Tutorial: Configurar uma regra do CloudWatch Events para receber notificações por e-mail de alterações de estado do pipeline

Crie ou identifique um tópico no Amazon SNS. O CodePipeline usará o CloudWatch Events para enviar notificações sobre esse tópico por meio do Amazon SNS. Para criar um tópico:

1. Abra o console do Amazon SNS em https://console.aws.amazon.com/sns.

2. Escolha Criar tópico.

3. Na caixa de diálogo Create new topic (Criar novo tópico), em Topic name (Nome do tópico), digite um nome para o tópico (por exemplo, PipelineNotificationTopic).

   

4. Escolha Create topic (Criar tópico).

   Para obter mais informações, consulte Criar um tópico no Guia do desenvolvedor do Amazon SNS.

Faça a assinatura de um ou mais destinatários para o tópico para que recebam notificações por e-mail. Para fazer a assinatura de um destinatário para um tópico:

1. No console do Amazon SNS, na lista Tópicos, marque a caixa de seleção ao lado do novo tópico. Escolha Actions, Subscribe to topic.

2. Na caixa de diálogo Create subscription, verifique se é exibido um ARN em Topic ARN.

3. Em Protocolo, escolha E-mail.

4. Em Endpoint, digite o endereço de e-mail completo do destinatário.

5. Escolha Criar inscrição.

6. O Amazon SNS envia um e-mail de confirmação de assinatura ao destinatário. Para receber notificações de e-mail, o destinatário deve escolher o link Confirm subscription nesse e-mail. Assim que o destinatário clicar no link, se a assinatura tiver sido realizada com êxito, o Amazon SNS exibirá uma mensagem de confirmação no navegador web do destinatário.

   Para obter mais informações, consulte Assinar um tópico no Guia do desenvolvedor do Amazon SNS.

1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação, escolha Eventos.

3. Escolha Criar regra. Em Event source (Origem do evento), escolha AWS CodePipeline. Em Event Type, escolha Pipeline Execution State Change.

4. Escolha Specific state(s) (Estado[s] específico[s]) e FAILED.

5. Escolha Edit para abrir o editor de JSON no painel Event Pattern Preview. Adicione o parâmetro pipeline com o nome de seu pipeline, como mostrado no exemplo a seguir para um pipeline chamado "myPipeline".

   É possível copiar o padrão de evento aqui e colá-lo no console:

   {
     "source": [
       "aws.codepipeline"
     ],
     "detail-type": [
       "CodePipeline Pipeline Execution State Change"
     ],
     "detail": {
       "state": [
         "FAILED"
       ],
       "pipeline": [
         "myPipeline"
       ]
     }
   }

6. Em Targets, escolha Add target.

7. Na lista de destinos, escolha SNS topic. Em Topic, insira o tópico que você criou.

8. Expanda Configure input e escolha Input Transformer.

9. Na caixa Input Path, digite os pares de chave/valor a seguir.

   { "pipeline" : "$.detail.pipeline" }

   Na caixa Input Template, digite o seguinte:

   "The Pipeline <pipeline> has failed."

10. Escolha Configure details (Configurar detalhes).

11. Na página Configure rule details, digite um nome e, opcionalmente, uma descrição. Em State, deixe a caixa Enabled marcada.

12. Escolha Criar regra.

13. Confirme se agora o CodePipeline está enviando notificações de compilação. Por exemplo, verifique se agora os e-mails de notificação de compilação estão em sua caixa de entrada.

14. Para alterar o comportamento de uma regra, no console do CloudWatch, escolha a regra e, em seguida, escolha Ações e Editar. Edite a regra e escolha Configure details e, em seguida, Update rule.

    Para parar de usar uma regra para enviar notificações de compilação, no console do CloudWatch, escolha a regra e, em seguida, escolha Ações e Desabilitar.

    Para excluir a regra, no console do CloudWatch, escolha a regra e, em seguida, escolha Ações e Excluir.