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á.
# Conceitos básicos das notificações
A maneira mais fácil de começar a usar notificações é configurar uma regra de notificação em um de seus projetos de compilação, aplicativos de implantação, pipelines ou repositórios.
**nota**
Na primeira vez que você criar uma regra de notificação, uma função vinculada ao serviço será criada em sua conta. Para obter mais informações, consulte [Usando funções vinculadas a serviços para notificações AWS CodeStar](using-service-linked-roles.md).
**Topics**
+ [Pré-requisitos](#getting-started-prerequisites)
+ [Criar uma regra de notificação para um repositório](getting-started-repository.md)
+ [Criar uma regra de notificação para um projeto de compilação](getting-started-build.md)
+ [Criar uma regra de notificação para uma aplicação de implantação](getting-started-deploy.md)
+ [Criar uma regra de notificação para um pipeline](getting-started-pipeline.md)
## Pré-requisitos
Siga as etapas em [Configurar](setting-up.md). Você também precisa de um recurso para o qual cria uma regra de notificação.
+ [Crie um projeto de](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html) construção CodeBuild ou use um existente.
+ [Crie uma aplicação](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html) ou use uma aplicação de implantação existente.
+ [Crie um pipeline CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html) ou use um existente.
+ [Crie um AWS CodeCommit repositório](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html) ou use um existente.
# Criar uma regra de notificação para um repositório
É possível criar regras de notificação para enviar notificações sobre eventos de repositório que são importantes para você. As etapas a seguir mostram como configurar uma regra de notificação em um único evento do repositório. Essas etapas foram escritas com a suposição de que você tem um repositório configurado em sua AWS conta.
**Importante**
Se você configurar as notificações CodeCommit antes de 5 de novembro de 2019, os tópicos do Amazon SNS usados para essas notificações conterão uma política que CodeCommit permite publicar nele com permissões diferentes das exigidas para AWS CodeStar notificações. Não é recomendado usar esses tópicos. Se quiser usar uma criada para essa experiência, você deve adicionar a política necessária para AWS CodeStar Notificações, além da que já existe. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS para notificações](set-up-sns.md) e [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Abra o CodeCommit console em [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).
1. Escolha um repositório na lista e abra-o.
1. Escolha **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Você também pode escolher **Settings (Configurações)**, ** Notifications (Notificações)** e **Create notification rule (Criar regra de notificação)**.
1. Em **Notification name (Nome da notificação)**, insira um nome para a regra.
1. Em **Tipo de detalhe**, escolha **Básico** se quiser que somente as informações fornecidas à Amazon sejam EventBridge incluídas na notificação. Escolha **Completo** se quiser incluir informações fornecidas à Amazon EventBridge e informações que possam ser fornecidas pelo serviço de recursos ou pelo gerenciador de notificações.
Para obter mais informações, consulte [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Em **Events that trigger notifications (Eventos que acionam notificações)**, em **Branches and tags (Ramificações e tags)**, selecione **Created (Criado)**.
1. Em **Targets (Destinos)**, escolha **Create SNS topic (Criar tópico do SNS)**.
**nota**
Quando você cria o tópico como parte da criação da regra de notificação, a política que CodeCommit permite publicar eventos no tópico é aplicada a você. O uso de um tópico criado para regras de notificação ajuda a garantir que você inscreva apenas os usuários para os quais deseja enviar notificações sobre esse repositório.
Após o prefixo **codestar-notifications-**, insira um nome para o tópico e escolha **Submit (Enviar)**.
**nota**
Se desejar usar um tópico do Amazon SNS existente em vez de criar um novo, em **Targets** (Destinos), escolha o ARN. Certifique-se de que o tópico tenha a política de acesso adequada e que a lista de assinantes contenha apenas os usuários que têm permissão para ver informações sobre o recurso. Se o tópico do Amazon SNS for usado para CodeCommit notificações antes de 5 de novembro de 2019, ele conterá uma política que permite CodeCommit a publicação nele com permissões diferentes das exigidas para AWS CodeStar notificações. Não é recomendado usar esses tópicos. Se quiser usar uma criada para essa experiência, você deve adicionar a política necessária para AWS CodeStar Notificações, além da que já existe. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS para notificações](set-up-sns.md) e [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Escolha **Submit (Enviar)** e revise a regra de notificação.
1. Inscreva seu endereço de e-mail no tópico do Amazon SNS que acabou de criar. Para obter mais informações, consulte [Para inscrever usuários em um tópico do Amazon SNS usado para notificações](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navegue até o repositório e crie uma ramificação de teste da ramificação padrão.
1. Depois de criar a ramificação, a regra de notificação envia uma notificação a todos os assinantes do tópico com informações sobre esse evento.
# Criar uma regra de notificação para um projeto de compilação
É possível criar regras de notificação para enviar notificações sobre os eventos no projeto de compilação que são importantes para você. As etapas a seguir mostram como configurar uma regra de notificação em um único evento do projeto de compilação. Essas etapas foram escritas com a suposição de que você tenha um projeto de compilação configurado em sua AWS conta.
1. Abra o CodeBuild console em [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Escolha um projeto de compilação na lista e abra-o.
1. Escolha **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Você também pode escolher **Settings (Configurações)** e **Create notification rule (Criar regra de notificação)**.
1. Em **Notification name (Nome da notificação)**, insira um nome para a regra.
1.
Em **Tipo de detalhe**, escolha **Básico** se quiser que somente as informações fornecidas à Amazon sejam EventBridge incluídas na notificação. Escolha **Completo** se quiser incluir informações fornecidas à Amazon EventBridge e informações que possam ser fornecidas pelo serviço de recursos ou pelo gerenciador de notificações.
Para obter mais informações, consulte [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Em **Events that trigger notifications (Eventos que acionam notificações)**, em **Build phase (Fase de compilação)**, selecione **Success (Sucesso)**.
1. Em **Targets (Destinos)**, escolha **Create SNS topic (Criar tópico do SNS)**.
**nota**
Quando você cria o tópico como parte da criação da regra de notificação, a política que CodeBuild permite publicar eventos no tópico é aplicada a você. O uso de um tópico criado para regras de notificação ajuda a garantir que você inscreva apenas os usuários para os quais deseja enviar notificações sobre esse projeto de compilação.
Após o prefixo **codestar-notifications-**, insira um nome para o tópico e escolha **Submit (Enviar)**.
**nota**
Se desejar usar um tópico do Amazon SNS existente em vez de criar um novo, em **Targets** (Destinos), escolha o ARN. Certifique-se de que o tópico tenha a política de acesso adequada e que a lista de assinantes contenha apenas os usuários que têm permissão para ver informações sobre o recurso. Se o tópico do Amazon SNS for usado para CodeCommit notificações antes de 5 de novembro de 2019, ele conterá uma política que permite CodeCommit a publicação nele com permissões diferentes das exigidas para AWS CodeStar notificações. Não é recomendado usar esses tópicos. Se quiser usar uma criada para essa experiência, você deve adicionar a política necessária para AWS CodeStar Notificações, além da que já existe. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS para notificações](set-up-sns.md) e [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Escolha **Submit (Enviar)** e revise a regra de notificação.
1. Inscreva seu endereço de e-mail no tópico do Amazon SNS que acabou de criar. Para obter mais informações, consulte [Para inscrever usuários em um tópico do Amazon SNS usado para notificações](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navegue até o projeto de compilação e inicie uma compilação.
1. Depois que a fase de compilação for concluída com êxito, a regra de notificação enviará uma notificação a todos os assinantes do tópico com informações sobre esse evento.
# Criar uma regra de notificação para uma aplicação de implantação
É possível criar regras de notificação para enviar notificações sobre os eventos em seu aplicativo de implantação que são importantes para você. As etapas a seguir mostram como configurar uma regra de notificação em um único evento do projeto de compilação. Essas etapas são escritas com a suposição de que você tem um aplicativo de implantação configurado em sua conta da AWS .
1. Abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/).
1. Escolha um aplicativo na lista e abra-o.
1. Escolha **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Você também pode escolher **Settings (Configurações)** e **Create notification rule (Criar regra de notificação)**.
1. Em **Notification name (Nome da notificação)**, insira um nome para a regra.
1. Em **Tipo de detalhe**, escolha **Básico** se quiser que somente as informações fornecidas à Amazon sejam EventBridge incluídas na notificação. Escolha **Completo** se quiser incluir informações fornecidas à Amazon EventBridge e informações que possam ser fornecidas pelo serviço de recursos ou pelo gerenciador de notificações.
Para obter mais informações, consulte [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Em **Events that trigger notifications (Eventos que acionam notificações)**, em **Deployment (Implantação)**, selecione **Succeeded (Com sucesso)**.
1. Em **Targets (Destinos)**, escolha **Create SNS topic (Criar tópico do SNS)**.
**nota**
Quando você cria o tópico como parte da criação da regra de notificação, a política que CodeDeploy permite publicar eventos no tópico é aplicada a você. O uso de um tópico criado para regras de notificação ajuda a garantir que você assine apenas os usuários para os quais deseja enviar notificações sobre esse aplicativo de implantação.
Após o prefixo **codestar-notifications-**, insira um nome para o tópico e escolha **Submit (Enviar)**.
**nota**
Se desejar usar um tópico do Amazon SNS existente em vez de criar um novo, em **Targets** (Destinos), escolha o ARN. Certifique-se de que o tópico tenha a política de acesso adequada e que a lista de assinantes contenha apenas os usuários que têm permissão para ver informações sobre o recurso. Se o tópico do Amazon SNS for usado para CodeCommit notificações antes de 5 de novembro de 2019, ele conterá uma política que permite CodeCommit a publicação nele com permissões diferentes das exigidas para AWS CodeStar notificações. Não é recomendado usar esses tópicos. Se quiser usar uma criada para essa experiência, você deve adicionar a política necessária para AWS CodeStar Notificações, além da que já existe. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS para notificações](set-up-sns.md) e [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Escolha **Submit (Enviar)** e revise a regra de notificação.
1. Inscreva seu endereço de e-mail no tópico do Amazon SNS que acabou de criar. Para obter mais informações, consulte [Para inscrever usuários em um tópico do Amazon SNS usado para notificações](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navegue até o aplicativo de implantação e inicie uma implantação.
1. Depois que a implantação for bem-sucedida, a regra de notificação enviará uma notificação para todos os assinantes de tópico com informações sobre o evento.
# Criar uma regra de notificação para um pipeline
É possível criar regras de notificação para enviar notificações sobre os eventos em seu pipeline que são importantes para você. As etapas a seguir mostram como configurar uma regra de notificação em um único evento do pipeline. Essas etapas foram escritas com a suposição de que você tenha um pipeline configurado em sua AWS conta.
1. Abra o CodePipeline console em [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Escolha um pipeline na lista e abra-o.
1. Escolha **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Você também pode escolher **Settings (Configurações)** e **Create notification rule (Criar regra de notificação)**.
1. Em **Notification name (Nome da notificação)**, insira um nome para a regra.
1. Em **Tipo de detalhe**, escolha **Básico** se quiser que somente as informações fornecidas à Amazon sejam EventBridge incluídas na notificação. Escolha **Completo** se quiser incluir informações fornecidas à Amazon EventBridge e informações que possam ser fornecidas pelo serviço de recursos ou pelo gerenciador de notificações.
Para obter mais informações, consulte [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Em **Events that trigger notifications (Eventos que acionam notificações)**, em **Action execution (Execução da ação)**, selecione **Started (Iniciado)**.
1. Em **Targets (Destinos)**, escolha **Create SNS topic (Criar tópico do SNS)**.
**nota**
Quando você cria o tópico como parte da criação da regra de notificação, a política que CodePipeline permite publicar eventos no tópico é aplicada a você. O uso de um tópico criado para regras de notificação ajuda a garantir que você inscreva apenas os usuários para os quais deseja enviar notificações sobre esse pipeline.
Após o prefixo **codestar-notifications-**, insira um nome para o tópico e escolha **Submit (Enviar)**.
**nota**
Se desejar usar um tópico do Amazon SNS existente em vez de criar um novo, em **Targets** (Destinos), escolha o ARN. Certifique-se de que o tópico tenha a política de acesso adequada e que a lista de assinantes contenha apenas os usuários que têm permissão para ver informações sobre o recurso. Se o tópico do Amazon SNS for usado para CodeCommit notificações antes de 5 de novembro de 2019, ele conterá uma política que permite CodeCommit a publicação nele com permissões diferentes das exigidas para AWS CodeStar notificações. Não é recomendado usar esses tópicos. Se quiser usar uma criada para essa experiência, você deve adicionar a política necessária para AWS CodeStar Notificações, além da que já existe. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS para notificações](set-up-sns.md) e [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Escolha **Submit (Enviar)** e revise a regra de notificação.
1. Inscreva seu endereço de e-mail no tópico do Amazon SNS que acabou de criar. Para obter mais informações, consulte [Para inscrever usuários em um tópico do Amazon SNS usado para notificações](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navegue até o pipeline e escolha **Release change (Alteração feita no release)**.
1. Quando a ação é iniciada, a regra de notificação envia uma notificação a todos os assinantes do tópico com informações sobre o evento.