Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Prise en main des notifications
La façon la plus simple de commencer à utiliser les notifications consiste à configurer une règle de notification sur l'un de vos projets de construction, applications de déploiement, pipelines ou référentiels.
**Note**
La première fois que vous créez une règle de notification, un rôle lié à un service est créé dans votre compte. Pour de plus amples informations, veuillez consulter [Utilisation de rôles liés à un service pour les notifications AWS CodeStar](using-service-linked-roles.md).
**Topics**
+ [Conditions préalables](#getting-started-prerequisites)
+ [Création d'une règle de notification pour un référentiel](getting-started-repository.md)
+ [Création d'une règle de notification pour un projet de génération](getting-started-build.md)
+ [Créer une règle de notification pour une application de déploiement](getting-started-deploy.md)
+ [Création d'une règle de notification pour un pipeline](getting-started-pipeline.md)
## Conditions préalables
Suivez les étapes de [Configuration](setting-up.md). Vous avez également besoin d'une ressource pour laquelle vous créez une règle de notification.
+ [Créez un projet de](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html) construction CodeBuild ou utilisez-en un existant.
+ [Créez une application](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html) ou utilisez une application de déploiement existante.
+ [Créez un pipeline dans](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html) un pipeline CodePipeline ou utilisez-en un existant.
+ [Créez un AWS CodeCommit référentiel](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html) ou utilisez-en un existant.
# Création d'une règle de notification pour un référentiel
Vous pouvez créer des règles de notification pour envoyer des notifications sur les événements de votre référentiel qui sont importants pour vous. Les étapes suivantes vous montrent comment configurer une règle de notification sur un seul événement de référentiel. Ces étapes sont rédigées en supposant qu'un référentiel est configuré dans votre AWS compte.
**Important**
Si vous configurez les notifications CodeCommit avant le 5 novembre 2019, les rubriques Amazon SNS utilisées pour ces notifications contiendront une politique autorisant la publication sur ce CodeCommit site et contenant des autorisations différentes de celles requises pour AWS CodeStar les notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez en utiliser une créée pour cette expérience, vous devez ajouter la politique requise pour AWS CodeStar les notifications en plus de celle qui existe déjà. Pour plus d’informations, consultez [Configurer une rubrique Amazon SNS pour les notifications](set-up-sns.md) et [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Ouvrez la CodeCommit console à l'adresse [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).
1. Choisissez un référentiel dans la liste et ouvrez-le.
1. Choisissez **Notify (Notifier)**, puis **Create notification rule (Créer une règle de notification)**. Vous pouvez également choisir **Paramètres**, **Notifications**, puis **Créer une règle de notification**.
1. Dans **Notification name (Nom de la notification)**, saisissez le nom de la règle.
1. Dans **Type de détail**, choisissez **Basic** si vous souhaitez que seules les informations fournies à Amazon soient EventBridge incluses dans la notification. Choisissez **Complet** si vous souhaitez inclure les informations fournies à Amazon EventBridge et les informations susceptibles d'être fournies par le service de ressources ou le gestionnaire de notifications.
Pour de plus amples informations, veuillez consulter [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Dans **Événements qui déclenchent des notifications**, sous **Branches et balises**, sélectionnez **Créé**.
1. Dans **Targets (Cibles)**, choisissez **Create SNS topic (Créer une rubrique SNS)**.
**Note**
Lorsque vous créez le sujet dans le cadre de la création de la règle de notification, la politique qui CodeCommit permet de publier des événements sur le sujet est appliquée pour vous. L'utilisation d'une rubrique créée pour les règles de notification vous permet de vous assurer que vous n'abonnez que les utilisateurs pour lesquels vous souhaitez qu'ils reçoivent des notifications sur ce référentiel.
Après le préfixe **codestar-notifications-**, entrez un nom pour la rubrique, puis choisissez **Submit (Envoyer)**.
**Note**
Si vous souhaitez utiliser une rubrique Amazon SNS existante au lieu d'en créer une nouvelle, dans **Targets (Cibles)**, choisissez son ARN. Assurez-vous que la rubrique dispose de la stratégie d'accès appropriée et que la liste d'abonnés contient uniquement les utilisateurs autorisés à voir des informations sur le pipeline. Si la rubrique Amazon SNS a été utilisée pour les CodeCommit notifications avant le 5 novembre 2019, elle contiendra une politique autorisant CodeCommit la publication sur cette rubrique contenant des autorisations différentes de celles requises pour AWS CodeStar les notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez en utiliser une créée pour cette expérience, vous devez ajouter la politique requise pour AWS CodeStar les notifications en plus de celle qui existe déjà. Pour plus d’informations, consultez [Configurer une rubrique Amazon SNS pour les notifications](set-up-sns.md) et [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Choisissez **Submit (Envoyer)**, puis passez en revue la règle de notification créée.
1. Abonnez votre adresse e-mail à la rubrique Amazon SNS que vous venez de créer. Pour de plus amples informations, veuillez consulter [Pour abonner les utilisateurs à une rubrique Amazon SNS utilisée pour les notifications](subscribe-users-sns.md#set-up-sns-subscribe).
1. Accédez à votre référentiel et créez une branche de test à partir de la branche par défaut.
1. Après avoir créé la branche, la règle de notification envoie une notification à tous les abonnés de rubrique contenant des informations sur cet événement.
# Création d'une règle de notification pour un projet de génération
Vous pouvez créer des règles de notification pour envoyer des notifications sur les événements de votre projet de génération qui sont importants pour vous. Les étapes suivantes vous montrent comment configurer une règle de notification sur un seul événement de projet de génération. Ces étapes sont rédigées en partant du principe que vous avez configuré un projet de construction dans votre AWS compte.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Choisissez un projet de build dans la liste et ouvrez-le.
1. Choisissez **Notify (Notifier)**, puis **Create notification rule (Créer une règle de notification)**. Vous pouvez également choisir **Settings (Paramètres)**, puis **Create notification rule (Créer une règle de notification)**.
1. Dans **Notification name (Nom de la notification)**, saisissez le nom de la règle.
1.
Dans **Type de détail**, choisissez **Basic** si vous souhaitez que seules les informations fournies à Amazon soient EventBridge incluses dans la notification. Choisissez **Complet** si vous souhaitez inclure les informations fournies à Amazon EventBridge et les informations susceptibles d'être fournies par le service de ressources ou le gestionnaire de notifications.
Pour de plus amples informations, veuillez consulter [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Dans **Événements qui déclenchent des notifications**, sous **Phase de génération**, sélectionnez **Succès**.
1. Dans **Targets (Cibles)**, choisissez **Create SNS topic (Créer une rubrique SNS)**.
**Note**
Lorsque vous créez le sujet dans le cadre de la création de la règle de notification, la politique qui CodeBuild permet de publier des événements sur le sujet est appliquée pour vous. L'utilisation d'une rubrique créée pour les règles de notification vous permet de vous assurer que vous n'abonnez que les utilisateurs pour lesquels vous souhaitez qu'ils reçoivent des notifications sur ce projet de build.
Après le préfixe **codestar-notifications-** entrez un nom pour la rubrique, puis choisissez **Submit (Envoyer)**.
**Note**
Si vous souhaitez utiliser une rubrique Amazon SNS existante au lieu d'en créer une nouvelle, dans **Targets (Cibles)**, choisissez son ARN. Assurez-vous que la rubrique dispose de la stratégie d'accès appropriée et que la liste d'abonnés contient uniquement les utilisateurs autorisés à voir des informations sur le pipeline. Si la rubrique Amazon SNS a été utilisée pour les CodeCommit notifications avant le 5 novembre 2019, elle contiendra une politique autorisant CodeCommit la publication sur cette rubrique contenant des autorisations différentes de celles requises pour AWS CodeStar les notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez en utiliser une créée pour cette expérience, vous devez ajouter la politique requise pour AWS CodeStar les notifications en plus de celle qui existe déjà. Pour plus d’informations, consultez [Configurer une rubrique Amazon SNS pour les notifications](set-up-sns.md) et [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Choisissez **Submit (Envoyer)**, puis passez en revue la règle de notification créée.
1. Abonnez votre adresse e-mail à la rubrique Amazon SNS que vous venez de créer. Pour de plus amples informations, veuillez consulter [Pour abonner les utilisateurs à une rubrique Amazon SNS utilisée pour les notifications](subscribe-users-sns.md#set-up-sns-subscribe).
1. Accédez à votre projet de génération et démarrez une génération.
1. Une fois la phase de construction terminée, la règle de notification envoie une notification à tous les abonnés de rubrique contenant des informations sur cet événement.
# Créer une règle de notification pour une application de déploiement
Vous pouvez créer des règles de notification pour envoyer des notifications sur les événements de votre application de déploiement qui sont importants pour vous. Les étapes suivantes vous montrent comment configurer une règle de notification sur un seul événement de projet de génération. Ces étapes sont écrites en supposant que vous avez une application de déploiement configurée dans votre compte AWS .
1. Ouvrez la CodeDeploy console à l'adresse [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/).
1. Choisissez une application dans la liste et ouvrez-la.
1. Choisissez **Notify (Notifier)**, puis **Create notification rule (Créer une règle de notification)**. Vous pouvez également choisir **Settings (Paramètres)**, puis **Create notification rule (Créer une règle de notification)**.
1. Dans **Notification name (Nom de la notification)**, saisissez le nom de la règle.
1. Dans **Type de détail**, choisissez **Basic** si vous souhaitez que seules les informations fournies à Amazon soient EventBridge incluses dans la notification. Choisissez **Complet** si vous souhaitez inclure les informations fournies à Amazon EventBridge et les informations susceptibles d'être fournies par le service de ressources ou le gestionnaire de notifications.
Pour de plus amples informations, veuillez consulter [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Dans **Événements qui déclenchent des notifications**, sous **Déploiement**, sélectionnez **Succès**.
1. Dans **Targets (Cibles)**, choisissez **Create SNS topic (Créer une rubrique SNS)**.
**Note**
Lorsque vous créez le sujet dans le cadre de la création de la règle de notification, la politique qui CodeDeploy permet de publier des événements sur le sujet est appliquée pour vous. L'utilisation d'une rubrique créée pour les règles de notification vous permet de vous assurer que vous n'abonnez que les utilisateurs pour lesquels vous souhaitez qu'ils reçoivent des notifications sur cette application de déploiement.
Après le préfixe **codestar-notifications-** entrez un nom pour la rubrique, puis choisissez **Submit (Envoyer)**.
**Note**
Si vous souhaitez utiliser une rubrique Amazon SNS existante au lieu d'en créer une nouvelle, dans **Targets (Cibles)**, choisissez son ARN. Assurez-vous que la rubrique dispose de la stratégie d'accès appropriée et que la liste d'abonnés contient uniquement les utilisateurs autorisés à voir des informations sur le pipeline. Si la rubrique Amazon SNS a été utilisée pour les CodeCommit notifications avant le 5 novembre 2019, elle contiendra une politique autorisant CodeCommit la publication sur cette rubrique contenant des autorisations différentes de celles requises pour AWS CodeStar les notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez en utiliser une créée pour cette expérience, vous devez ajouter la politique requise pour AWS CodeStar les notifications en plus de celle qui existe déjà. Pour plus d’informations, consultez [Configurer une rubrique Amazon SNS pour les notifications](set-up-sns.md) et [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Choisissez **Submit (Envoyer)**, puis passez en revue la règle de notification créée.
1. Abonnez votre adresse e-mail à la rubrique Amazon SNS que vous venez de créer. Pour de plus amples informations, veuillez consulter [Pour abonner les utilisateurs à une rubrique Amazon SNS utilisée pour les notifications](subscribe-users-sns.md#set-up-sns-subscribe).
1. Accédez à votre application de déploiement et démarrez un déploiement.
1. Une fois le déploiement réussi, la règle de notification envoie une notification à tous les abonnés du sujet avec des informations sur l'événement.
# Création d'une règle de notification pour un pipeline
Vous pouvez créer des règles de notification pour envoyer des notifications sur les événements de votre pipeline qui sont importants pour vous. Les étapes suivantes vous montrent comment configurer une règle de notification sur un seul événement de pipeline. Ces étapes sont rédigées en supposant qu'un pipeline est configuré dans votre AWS compte.
1. Ouvrez la CodePipeline console à l'adresse [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Choisissez un pipeline dans la liste et ouvrez-le.
1. Choisissez **Notify (Notifier)**, puis **Create notification rule (Créer une règle de notification)**. Vous pouvez également choisir **Settings (Paramètres)**, puis **Create notification rule (Créer une règle de notification)**.
1. Dans **Notification name (Nom de la notification)**, saisissez le nom de la règle.
1. Dans **Type de détail**, choisissez **Basic** si vous souhaitez que seules les informations fournies à Amazon soient EventBridge incluses dans la notification. Choisissez **Complet** si vous souhaitez inclure les informations fournies à Amazon EventBridge et les informations susceptibles d'être fournies par le service de ressources ou le gestionnaire de notifications.
Pour de plus amples informations, veuillez consulter [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Dans **Événements qui déclenchent des notifications**, sous **Exécution de l'action**, sélectionnez **Démarré**.
1. Dans **Targets (Cibles)**, choisissez **Create SNS topic (Créer une rubrique SNS)**.
**Note**
Lorsque vous créez le sujet dans le cadre de la création de la règle de notification, la politique qui CodePipeline permet de publier des événements sur le sujet est appliquée pour vous. L'utilisation d'une rubrique créée pour les règles de notification vous permet de vous assurer que vous n'abonnez que les utilisateurs pour lesquels vous souhaitez qu'ils reçoivent des notifications sur ce pipeline.
Après le préfixe **codestar-notifications-**, entrez un nom pour la rubrique, puis choisissez **Submit (Envoyer)**.
**Note**
Si vous souhaitez utiliser une rubrique Amazon SNS existante au lieu d'en créer une nouvelle, dans **Targets (Cibles)**, choisissez son ARN. Assurez-vous que la rubrique dispose de la stratégie d'accès appropriée et que la liste d'abonnés contient uniquement les utilisateurs autorisés à voir des informations sur le pipeline. Si la rubrique Amazon SNS a été utilisée pour les CodeCommit notifications avant le 5 novembre 2019, elle contiendra une politique autorisant CodeCommit la publication sur cette rubrique contenant des autorisations différentes de celles requises pour AWS CodeStar les notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez en utiliser une créée pour cette expérience, vous devez ajouter la politique requise pour AWS CodeStar les notifications en plus de celle qui existe déjà. Pour plus d’informations, consultez [Configurer une rubrique Amazon SNS pour les notifications](set-up-sns.md) et [Présentation du contenu des notifications et de la sécurité](security.md#security-notifications).
1. Choisissez **Submit (Envoyer)**, puis passez en revue la règle de notification créée.
1. Abonnez votre adresse e-mail à la rubrique Amazon SNS que vous venez de créer. Pour de plus amples informations, veuillez consulter [Pour abonner les utilisateurs à une rubrique Amazon SNS utilisée pour les notifications](subscribe-users-sns.md#set-up-sns-subscribe).
1. Accédez à votre pipeline, puis choisissez **Release change (Changement de version)**.
1. Lorsque l'action démarre, la règle de notification envoie une notification à tous les abonnés de la rubrique, contenant les informations sur l'événement.