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 écrites en supposant que vous avez un référentiel configuré dans votre compte AWS.

Important

Si vous avez configuré des notifications dans CodeCommit avant le 5 novembre 2019, les rubriques Amazon SNS utilisées pour ces notifications contiennent une stratégie qui permet à CodeCommit publier sur cette rubrique et qui contient des autorisations différentes de celles requises pour AWS CodeStar Notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez utiliser une rubrique créée pour cette expérience, vous devez ajouter la stratégie requise pour AWS CodeStar Notifications en plus de celle qui existe déjà. Pour plus d'informations, consultez Configurer une rubrique Amazon SNS pour les notifications et Présentation du contenu des notifications et de la sécurité.

1. Ouvrez la console CodeCommit, à l'adresse https://console.aws.amazon.com/codecommit/.

2. Choisissez un référentiel dans la liste et ouvrez-le.

3. 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.

4. Dans Notification name (Nom de la notification), saisissez le nom de la règle.

5. Dans Detail type (Type de détail), choisissez Basic (Basique) si vous souhaitez que seules les informations fournies à Amazon EventBridge soient incluses dans la notification. Choisissez Full (Complète), si vous souhaitez inclure dans la notification les informations fournies à Amazon EventBridge et celles qui peuvent être fournies par le service de ressource ou le gestionnaire de notifications.

   Pour de plus amples informations, veuillez consulter Présentation du contenu des notifications et de la sécurité.

6. Dans Événements qui déclenchent des notifications, sous Branches et balises, sélectionnez Créé.

7. Dans Targets (Cibles), choisissez Create SNS topic (Créer une rubrique SNS).

   Note

   Lorsque vous créez la rubrique dans le cadre de la création de la règle de notification, la stratégie qui permet à CodeCommit de publier des événements dans la rubrique est appliquée automatiquement. 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 est une rubrique qui a été utilisée pour les notifications CodeCommit avant le 5 novembre 2019, elle contient une stratégie qui permet à CodeCommit publier sur cette rubrique et qui contient des autorisations différentes de celles requises pour AWS CodeStar Notifications. L'utilisation de ces rubriques n'est pas recommandée. Si vous souhaitez utiliser une rubrique créée pour cette expérience, vous devez ajouter la stratégie requise pour AWS CodeStar Notifications en plus de celle qui existe déjà. Pour plus d'informations, consultez Configurer une rubrique Amazon SNS pour les notifications et Présentation du contenu des notifications et de la sécurité.

8. Choisissez Submit (Envoyer), puis passez en revue la règle de notification créée.

9. 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.

10. Accédez à votre référentiel et créez une branche de test à partir de la branche par défaut.

11. 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.