Création d'une règle de notification - AWS CodeCommit

AWS CodeCommit n'est plus disponible pour les nouveaux clients. Les clients existants de AWS CodeCommit peuvent continuer à utiliser le service normalement. En savoir plus »

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.

Création d'une règle de notification

Vous pouvez utiliser des règles de notification pour informer les utilisateurs de modifications importantes, par exemple, quand une demande d'extraction est créée dans un référentiel. Les règles de notification spécifient à la fois les événements et le SNS sujet Amazon utilisés pour envoyer les notifications. Pour plus d'informations, consultez Que sont les notifications ?

Note

Cette fonctionnalité n'est pas disponible dans la région Europe (Milan). Pour savoir comment configurer les notifications dans l'expérience disponible dans cette région, voir Configurer les notifications du référentiel.

Vous pouvez utiliser la console ou le AWS CLI pour créer des règles de notification pour AWS CodeCommit.

Pour créer une règle de notification (console)

  1. Connectez-vous à la CodeCommit console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/codecommit/.

  2. Choisissez Repositories (Référentiels), puis sélectionnez un référentiel dans lequel vous souhaitez ajouter des règles de notification.

  3. Sur la page du référentiel, choisissez Notify (Notifier), puis Create notification rule (Créer une règle de notification). Vous pouvez également accéder à la page Settings (Paramètres) du référentiel et choisir Create notification rule (Créer une règle de notification).

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

  5. 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 CodeCommit ou le gestionnaire de notifications.

    Pour plus d'informations, consultez Présentation du contenu des notifications et de la sécurité.

  6. Dans Événements qui déclenchent des notifications, sélectionnez les événements pour lesquels vous souhaitez envoyer des notifications. Pour plus d'informations, consultez Événements pour les règles de notification sur les référentiels.

  7. Dans Targets (Cibles), effectuez l'une des actions suivantes :

    • Si vous avez déjà configuré une ressource à utiliser avec les notifications, dans Choisir le type de cible, choisissez AWS Chatbot (Slack) ou un SNSsujet. Dans Choisir une cible, choisissez le nom du client (pour un client Slack configuré dans AWS Chatbot) ou le nom de ressource Amazon (ARN) du SNS sujet Amazon (pour les SNS sujets Amazon déjà configurés avec la politique requise pour les notifications).

    • Si vous n'avez pas configuré de ressource à utiliser avec les notifications, choisissez Créer une cible, puis choisissez un SNSsujet. Donnez un nom à la rubrique après codestar-notifications-, puis choisissez Create (Créer).

    Note

    • Si vous créez le SNS sujet Amazon dans le cadre de la création de la règle de notification, la politique qui permet à la fonctionnalité de notifications de publier des événements sur le sujet s'applique 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 qui doivent recevoir des notifications sur ce référentiel.

    • Vous ne pouvez pas créer de AWS Chatbot client dans le cadre de la création d'une règle de notification. Si vous choisissez AWS Chatbot (Slack), vous verrez un bouton vous demandant de configurer un client dans AWS Chatbot. Le choix de cette option ouvre la AWS Chatbot console. Pour plus d'informations, voir Configurer les intégrations entre les notifications et AWS Chatbot.

    • Si vous souhaitez utiliser un SNS sujet Amazon existant comme cible, vous devez ajouter la politique requise pour les AWS CodeStar notifications en plus de toute autre politique susceptible d'exister pour ce sujet. Pour plus d'informations, consultez Configurer les SNS rubriques Amazon pour les notifications et Comprendre le contenu et la sécurité des notifications.

  8. Pour terminer la création de la règle, choisissez Submit (Soumettre).

  9. Vous devez inscrire les utilisateurs à la SNS rubrique Amazon relative à la règle pour qu'ils puissent recevoir des notifications. Pour plus d'informations, consultez Abonner les utilisateurs aux SNS rubriques Amazon qui sont des cibles. Vous pouvez également configurer l'intégration entre les notifications et envoyer des notifications AWS Chatbot aux forums de discussion Amazon Chime. Pour plus d'informations, voir Configurer l'intégration entre les notifications et AWS Chatbot.

Pour créer une règle de notification (AWS CLI)

  1. Sur un terminal ou une invite de commande, exécutez la create-notification rule commande pour générer le JSON squelette :

    aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json

    Vous pouvez donner au fichier le nom de votre choix. Dans cet exemple, le fichier est nommé rule.json.

  2. Ouvrez le JSON fichier dans un éditeur de texte brut et modifiez-le pour inclure la ressource, les types d'événements et la cible que vous souhaitez pour la règle. L'exemple suivant montre une règle de notification nommée MyNotificationRule d'après un référentiel nommé MyDemoRepo dans un AWS compte avec l'ID 123456789012. Les notifications avec le type de détail complet sont envoyées à une SNS rubrique Amazon nommée MyNotificationTopic lors de la création de branches et de tags :

    {
    "Name": "MyNotificationRule",
    "EventTypeIds": [
        "codecommit-repository-branches-and-tags-created"
    ],
    "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
    "Targets": [
        {
            "TargetType": "SNS",
            "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL"
}

    Enregistrez le fichier.

  3. À l'aide du fichier que vous venez de modifier, à partir du terminal ou de la ligne de commande, exécutez à nouveau la commande create-notification-rule pour créer la règle de notification :

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

  4. En cas de succès, la commande renvoie ARN la règle de notification, comme suit :

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