Creazione di una regola di notifica

È possibile utilizzare le regole di notifica per notificare agli utenti modifiche importanti, ad esempio quando viene creata una richiesta pull in un repository. Le regole di notifica specificano sia gli eventi che l'SNSargomento Amazon utilizzato per inviare le notifiche. Per ulteriori informazioni, vedere Cosa sono le notifiche?

Nota

Questa funzionalità non è disponibile nella regione Europa (Milano). Per informazioni su come configurare le notifiche nell'esperienza disponibile in quella regione, consulta Configurare le notifiche del repository.

Puoi utilizzare la console o AWS CLI creare regole di notifica per AWS CodeCommit.

Per creare una regola di notifica (console)

1. Accedi a AWS Management Console e apri la CodeCommit console all'indirizzo https://console.aws.amazon.com/codecommit/.

2. Scegliere Repositories (Repository), quindi scegliere un repository in cui aggiungere regole di notifica.

3. Nella pagina delle risorse, scegliere Notify (Notifica), quindi selezionare Create notification rule (Crea regola di notifica). È anche possibile andare alla pagina Settings (Impostazioni) del repository e scegliere Create notification rule (Crea regola di notifica).

4. In Notification name (Nome notifica), immettere un nome per la regola.

5. In Tipo di dettaglio, scegli Basic se desideri che nella notifica siano EventBridge incluse solo le informazioni fornite ad Amazon. Scegli Completo se desideri includere le informazioni fornite ad Amazon EventBridge e le informazioni che potrebbero essere fornite da CodeCommit o dal gestore delle notifiche.

   Per ulteriori informazioni, vedere Informazioni sul contenuto delle notifiche e sulla sicurezza.

6. In Events that trigger notifications (Eventi che attivano le notifiche), selezionare gli eventi per i quali si desidera inviare notifiche. Per ulteriori informazioni, consulta l'argomento relativo agli eventi per le regole di notifica sui repository.

7. In Targets (Destinazioni), procedere in uno dei seguenti modi:

   • Se hai già configurato una risorsa da utilizzare con le notifiche, in Scegli il tipo di oggetto, scegli AWS Chatbot (Slack) o l'SNSargomento. In Scegli destinazione, scegli il nome del client (per un client Slack configurato in AWS Chatbot) o il nome della risorsa Amazon (ARN) dell'SNSargomento Amazon (per SNS gli argomenti Amazon già configurati con la politica richiesta per le notifiche).

   • Se non hai configurato una risorsa da utilizzare con le notifiche, scegli Crea target, quindi scegli l'SNSargomento. Fornire un nome per l'argomento dopo codestar-notifications-, quindi scegliere Create (Crea).

   Nota

   • Se crei l'SNSargomento Amazon come parte della creazione della regola di notifica, viene applicata automaticamente la politica che consente alla funzionalità di notifica di pubblicare eventi sull'argomento. L'utilizzo di un argomento creato per le regole di notifica consente di iscrivere solo gli utenti che si desidera ricevano le notifiche relative a questa risorsa.

   • Non puoi creare un AWS Chatbot client come parte della creazione di una regola di notifica. Se scegli AWS Chatbot (Slack), vedrai un pulsante che ti indirizza alla configurazione di un client in. AWS Chatbot Scegliendo questa opzione si apre la console. AWS Chatbot Per ulteriori informazioni, consulta Configurare le integrazioni tra notifiche e AWS Chatbot.

   • Se desideri utilizzare un SNS argomento Amazon esistente come obiettivo, devi aggiungere la politica richiesta per AWS CodeStar le notifiche oltre a qualsiasi altra politica che potrebbe esistere per quell'argomento. Per ulteriori informazioni, consulta Configurare Amazon SNS Topics for Notifications e Understanding Notification Contents and Security.

8. Per completare la creazione della regola, scegliere Invia.

9. Devi iscrivere gli utenti all'SNSargomento Amazon per la regola prima che possano ricevere notifiche. Per ulteriori informazioni, consulta Sottoscrivere gli utenti agli SNS argomenti di Amazon That Are Targets. Puoi anche configurare l'integrazione tra le notifiche e inviare notifiche AWS Chatbot alle chat room di Amazon Chime. Per ulteriori informazioni, consulta Configurare l'integrazione tra notifiche e. AWS Chatbot

Per creare una regola di notifica (AWS CLI)

1. In un terminale o nel prompt dei comandi, esegui il create-notification rule comando per generare lo JSON scheletro:

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

   È possibile assegnare al file un nome qualsiasi. In questo esempio, il file è denominato rule.json.

2. Aprite il JSON file in un editor di testo semplice e modificatelo per includere la risorsa, i tipi di eventi e la destinazione che desiderate per la regola. L'esempio seguente mostra una regola di notifica denominata MyNotificationRule per un repository denominato MyDemoRepo in un AWS account con l'ID 123456789012. Le notifiche con il tipo di dettaglio completo vengono inviate a un SNS argomento Amazon denominato MyNotificationTopic quando vengono creati rami e tag:

   {
       "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"
   }

   Salvare il file.

3. Utilizzando il file appena modificato, dal terminale o dalla riga di comando, eseguire nuovamente il comando create-notification-rule per creare la regola di notifica:

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

4. In caso di successo, il comando restituisce la regola ARN di notifica, simile alla seguente:

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