Criar uma regra de notificação - AWS CodeBuild

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar uma regra de notificação

Você pode usar regras de notificação para notificar os usuários quando ocorrem alterações importantes, como êxitos e falhas de compilação. As regras de notificação especificam os eventos e o tópico do Amazon SNS utilizado para enviar notificações. Para obter mais informações, consulte O que são notificações?

Você pode usar o console ou a AWS CLI para criar regras de notificação para o AWS CodeBuild.

Como criar uma regra de notificação (console)

  1. Faça login no AWS Management Console e abra o console do CodeBuild em https://console.aws.amazon.com/codebuild/.

  2. Selecione Build (Compilação), escolha Build projects (Projetos de compilação) e escolha um projeto de compilação em que você queira adicionar notificações.

  3. Na página do projeto de compilação, escolha Notify (Notificar) e Create notification rule (Criar regra de notificação). Você também poderá acessar a página Settings (Configurações) do projeto de compilação e escolher Create notification rule (Criar regra de notificação).

  4. Em Notification name (Nome da notificação), insira um nome para a regra.

  5. Em Detail type (Tipo de detalhe), escolha Basic (Básico) se desejar que apenas as informações fornecidas ao Amazon EventBridge sejam incluídas na notificação. Escolha Completo se desejar incluir as informações fornecidas ao Amazon EventBridge e as informações que possam ser fornecidas pelo CodeBuild ou pelo gerenciador de notificações.

    Para obter mais informações, consulte Noções básicas sobre o conteúdo e a segurança de notificações.

  6. Em Events that trigger notifications (Eventos que acionam notificações), selecione os eventos para os quais você deseja enviar notificações. Para obter mais informações, consulte Eventos para regras de notificação em projetos de compilação.

  7. Em Targets (Destinos), siga um destes procedimentos:

    • Se você já tiver configurado um recurso para usar com notificações, em Choose target type (Escolher tipo de destino), escolha AWS Chatbot (Slack) ou SNS topic (Tópico do SNS). Em Escolher destino, selecione o nome do cliente (para um cliente Slack configurado no AWS Chatbot) ou o nome do recurso da Amazon (ARN) do tópico do Amazon SNS (para tópicos do Amazon SNS já configurados com a política necessária para notificações).

    • Se você não configurou um recurso para usar com notificações, escolha Create target (Criar destino) e selecione SNS topic (Tópico do SNS). Forneça um nome para o tópico após codestar-notifications- e escolha Create (Criar).

    nota

    • Ao criar o tópico do Amazon SNS como parte da criação da regra de notificação, a política que permite ao recurso publicar eventos no tópico é aplicada para você. O uso de um tópico criado para regras de notificação ajuda a garantir que você inscreva somente os usuários para os quais deseja enviar notificações sobre esse recurso.

    • Não é possível criar um cliente do AWS Chatbot como parte da criação de uma regra de notificação. Se escolher AWS Chatbot (Slack), você verá um botão direcionando-o para configurar um cliente no AWS Chatbot. Escolher essa opção abrirá o console do AWS Chatbot. Para obter mais informações, consulte Configurar integrações entre as notificações e o AWS Chatbot.

    • Se quiser usar um tópico do Amazon SNS existente como destino, você deverá adicionar a política necessária para o AWS CodeStar Notifications, além de quaisquer outras políticas que possam existir para esse tópico. Para obter mais informações, consulte Configurar tópicos do Amazon SNS existentes para notificações e Noções básicas sobre conteúdos de notificações e segurança.

  8. Para concluir a criação da regra, escolha Submit (Enviar).

  9. É necessário inscrever os usuários no tópico do Amazon SNS para a regra para que eles possam receber notificações. Para obter mais informações, consulte Subscribe Users to Amazon SNS Topics That Are Targets. Também é possível configurar a integração entre as notificações e o AWS Chatbot a fim de enviar notificações para salas de conversa do Amazon Chime. Para obter mais informações, consulte Configurar a integração entre as notificações e o AWS Chatbot.

Criar uma regra de notificação (AWS CLI)

  1. Em um terminal ou prompt de comando, execute o comando create-notification rule para gerar o esqueleto JSON:

    aws codestarnotifications create-notification-rule --generate-cli-skeleton > rule.json

    É possível nomear o arquivo como você quiser. Neste exemplo, o arquivo é chamado rule.json.

  2. Abra o arquivo JSON em um editor de texto simples e edite-o para incluir o recurso, os tipos de evento e o destino que você deseja para a regra. O exemplo a seguir mostra uma regra de notificação chamada MyNotificationRule para um projeto de compilação denominado MyBuildProject em uma conta da AWS com o ID 123456789012. As notificações são enviadas com o tipo de detalhe completo para um tópico do Amazon SNS chamado codestar-notifications-MyNotificationTopic quando as compilações são bem-sucedidas:

    {
    "Name": "MyNotificationRule",
    "EventTypeIds": [
        "codebuild-project-build-state-succeeded"
    ],
    "Resource": "arn:aws:codebuild:us-east-2:123456789012:MyBuildProject",
    "Targets": [
        {
            "TargetType": "SNS",
            "TargetAddress": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyNotificationTopic"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL"
}

    Salve o arquivo.

  3. Usando o arquivo que você acabou de editar, no terminal ou na linha de comando, execute o comando create-notification-rule novamente para criar a regra de notificação:

    aws codestarnotifications create-notification-rule --cli-input-json  file://rule.json

  4. Se for bem-sucedido, o comando retornará o ARN da regra de notificação, semelhante ao seguinte:

    {
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}