Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
La configurazione e l'utilizzo delle notifiche risultano più semplici se si comprendono i concetti e i termini. Di seguito sono riportati alcuni concetti che occorre conoscere quando si utilizzano le notifiche.
Notifiche
Una notifica è un messaggio che contiene informazioni sugli eventi che si verificano nelle risorse utilizzate da te e dagli sviluppatori. Puoi configurare le notifiche in modo che gli utenti di una risorsa, ad esempio un progetto di compilazione, un repository, un'applicazione di distribuzione o una pipeline, ricevano e-mail sui tipi di eventi specificati in base alla regola di notifica creata.
Le notifiche per AWS CodeCommit possono contenere informazioni sull'identità dell'utente, come un nome visualizzato o un indirizzo e-mail, tramite l'uso di tag di sessione. CodeCommit supporta l'uso di tag di sessione, che sono attributi di coppia chiave-valore che vengono trasmessi quando si assume un ruolo IAM, si utilizzano credenziali temporanee o si federa un utente in (). AWS Security Token Service AWS STS Puoi anche associare i tag a un utente IAM. CodeCommit include i valori per displayName e emailAddress nel contenuto della notifica, se tali tag sono presenti. Per ulteriori informazioni, consulta Utilizzo dei tag per fornire informazioni di identità aggiuntive in CodeCommit.
Importante
Le notifiche includono informazioni specifiche del progetto, ad esempio lo stato delle compilazioni e delle distribuzioni, le righe di codice con commenti e le approvazioni della pipeline. Il contenuto delle notifiche potrebbe cambiare man mano che vengono aggiunte nuove caratteristiche. Come best practice per la sicurezza, è necessario esaminare regolarmente i destinatari delle regole di notifica e gli iscritti agli argomenti Amazon SNS. Per ulteriori informazioni, consulta Comprendere contenuti e sicurezza delle notifiche.
Regole di notifica
Una regola di notifica è una AWS risorsa creata per specificare quando e dove vengono inviate le notifiche. Definisce:
-
Le condizioni in base alle quali viene creata una notifica. Queste condizioni sono basate su eventi scelti dall'utente, che sono specifici per il tipo di risorsa. I tipi di risorse supportati includono progetti di compilazione in AWS CodeBuild, applicazioni di distribuzione in AWS CodeDeploy, pipeline in AWS CodePipeline e repository in. AWS CodeCommit
-
Le destinazioni a cui viene inviata la notifica. Puoi specificare fino a 10 destinazioni per una regola di notifica.
Le regole di notifica sono rivolte a singoli progetti di compilazione, applicazioni di distribuzione, pipeline e repository. Le regole di notifica hanno sia nomi descrittivi definiti dall'utente che Amazon Resource Names (ARNs). Le regole di notifica devono essere create nella stessa AWS regione in cui esiste la risorsa. Ad esempio, se il progetto di compilazione si trova nella regione Stati Uniti orientali (Ohio), anche la regola di notifica deve essere creata nella regione Stati Uniti orientali (Ohio).
Puoi definire fino a 10 regole di notifica per una risorsa.
Eventi
Un evento è una modifica dello stato di una risorsa che desideri monitorare. Ogni risorsa dispone di un elenco di tipi di eventi tra cui puoi scegliere. Quando configuri una regola di notifica su una risorsa, specifichi gli eventi che causano l'invio delle notifiche. Ad esempio, se si impostano le notifiche per un repository in CodeCommit e si seleziona Creato sia per la richiesta Pull che per i rami e i tag, viene inviata una notifica ogni volta che un utente in quel repository crea una richiesta pull, un ramo o un tag Git.
Tipi di dettaglio
Quando crei una regola di notifica, puoi scegliere il livello di dettaglio o il tipo di dettaglio incluso nelle notifiche (Full (Completo) o Basic (Di base)). L'impostazione Full (Completo) (valore predefinito) include tutte le informazioni disponibili per l'evento nella notifica, incluse le informazioni avanzate fornite dai servizi per eventi specifici. L'impostazione Basic (Di base) include solo un sottoinsieme delle informazioni disponibili.
Nella tabella seguente sono elencate le informazioni avanzate disponibili per i tipi di eventi specifici e vengono descritte le differenze tra i tipi di dettaglio.
| Servizio | Evento | Full (Completo) include | Basic (Di base) non include |
|---|---|---|---|
|
CodeCommit |
Commenti sui commit Commenti sulle richieste pull |
Tutti i dettagli dell'evento e il contenuto del commento, comprese eventuali risposte o thread di commento. Include anche il numero di riga e la riga di codice su cui è stato fatto il commento. |
Il contenuto del commento, il numero di riga, la riga di codice o qualsiasi thread di commento. |
|
CodeCommit |
Richiesta pull creata |
Tutti i dettagli dell'evento e il numero di file aggiunti, modificati o eliminati nella richiesta pull in relazione al ramo di destinazione. |
Nessun elenco di file o dettagli sul fatto che il ramo di origine della richiesta pull abbia aggiunto, modificato o eliminato i file. |
|
CodePipeline |
Approvazione manuale necessaria |
Tutti i dettagli dell'evento e i dati personalizzati (se configurati). La notifica include anche un collegamento all'approvazione richiesta nella pipeline. |
Nessun collegamento o dato personalizzato. |
|
CodePipeline |
Esecuzione dell'operazione non riuscita Esecuzione della pipeline non riuscita Esecuzione della fase non riuscita |
Tutti i dettagli dell'evento e il contenuto del messaggio di errore per l'errore. |
Nessun contenuto di messaggio di errore. |
Destinazioni
Una destinazione è una posizione per la ricezione delle notifiche dalle regole di notifica. I tipi di target consentiti sono argomenti Amazon SNS e client Chatbot configurati per i AWS canali Slack o Microsoft Teams. Qualsiasi utente che ha effettuato l'iscrizione alla destinazione riceve le notifiche sugli eventi specificati nella regola di notifica.
Se desideri estendere la portata delle notifiche, puoi configurare manualmente l'integrazione tra notifiche e AWS Chatbot in modo che le notifiche vengano inviate alle chat room di Amazon Chime. Puoi quindi scegliere l'argomento Amazon SNS configurato per quel client Chatbot AWS come destinazione per la regola di notifica. Per ulteriori informazioni, consulta Per integrare le notifiche con AWS Chatbot e Amazon Chime.
Se scegli di utilizzare un client AWS Chatbot come obiettivo, devi prima creare quel client in AWS Chatbot. Quando scegli un client AWS Chatbot come obiettivo per una regola di notifica, viene configurato un argomento Amazon SNS per quel client AWS Chatbot con tutte le politiche necessarie per l'invio delle notifiche al canale Slack o Microsoft Teams. Non è necessario configurare alcun argomento Amazon SNS esistente per il client Chatbot AWS .
Puoi scegliere di creare un argomento Amazon SNS come destinazione come parte della creazione di una regola di notifica (scelta consigliata). Puoi anche scegliere un argomento Amazon SNS esistente nella stessa AWS regione della regola di notifica, ma devi configurarlo con la politica richiesta. L'argomento Amazon SNS che usi per un target deve essere nel tuo AWS account. Inoltre, deve trovarsi nella stessa AWS regione della regola di notifica e della AWS risorsa per cui è stata creata la regola.
Ad esempio, se crei una regola di notifica per un repository nella regione Stati Uniti orientali (Ohio), l'argomento Amazon SNS deve esistere anche in tale regione. Se crei un argomento Amazon SNS durante la creazione di una regola di notifica, l'argomento viene configurato con la policy necessaria per consentire la pubblicazione degli eventi nell'argomento. Questo è il metodo migliore per lavorare con le destinazioni e le regole di notifica. Se scegli di utilizzare un argomento già esistente o di crearne uno manualmente, è necessario configurarlo con le autorizzazioni richieste prima che gli utenti ricevano le notifiche. Per ulteriori informazioni, consulta Configura gli argomenti di Amazon SNS per le notifiche.
Nota
Se desideri utilizzare un argomento Amazon SNS esistente invece di crearne uno nuovo, in Targets (Destinazioni), scegli il relativo ARN. Assicurati che l'argomento disponga delle policy di accesso appropriate e che l'elenco degli iscritti contenga solo gli utenti autorizzati a visualizzare le informazioni sulla risorsa. Se l'argomento Amazon SNS è un argomento utilizzato per CodeCommit le notifiche prima del 5 novembre 2019, conterrà una politica che consente la pubblicazione su CodeCommit di esso con autorizzazioni diverse da quelle richieste per le notifiche. AWS CodeStar L'utilizzo di questi argomenti è sconsigliato. Se desideri utilizzarne uno creato per quell'esperienza, devi aggiungere la politica richiesta per AWS CodeStar le notifiche oltre a quella già esistente. Per ulteriori informazioni, consulta Configura gli argomenti di Amazon SNS per le notifiche e Comprendere contenuti e sicurezza delle notifiche.
Notifiche e AWS CodeStar notifiche
Sebbene siano una funzionalità della console Developer Tools, le notifiche hanno una propria API, AWS CodeStar Notifications. Hanno anche un proprio tipo di risorsa AWS (regole di notifica), autorizzazioni ed eventi. Gli eventi per le regole di notifica vengono registrati in AWS CloudTrail. Le operazioni API possono essere consentite o negate tramite le policy IAM.
Eventi per regole di notifica su repository
| Categoria | Eventi | Evento IDs |
|---|---|---|
|
Commenti |
Sui commit Su richieste pull |
|
| Approvazioni |
Stato modificato Sostituzione delle regole |
|
|
Richiesta pull |
Creato Origine aggiornata Stato modificato Unito |
|
|
Rami e tag |
Creato Eliminato Aggiornato |
codecommit-repository-branches-and-tags-updated |
Eventi per regole di notifica su progetti di compilazione
| Categoria | Eventi | Evento IDs |
|---|---|---|
|
Stato di compilazione |
Non riuscito Riuscito In corso Arrestato |
|
|
Fase di compilazione |
Errore Riuscito |
|
Eventi per le regole di notifica sulle applicazioni di implementazione
| Categoria | Eventi | Evento IDs |
|---|---|---|
|
Implementazione |
Non riuscito Riuscito Avviato |
codedeploy-application-deployment-started |
Eventi per regole di notifica su pipeline
| Categoria | Eventi | Evento IDs |
|---|---|---|
|
Esecuzione dell'operazione |
Riuscito Non riuscito Annullato Avviato |
|
|
Esecuzione della fase |
Avviato Riuscito Ripristinato Annullato Non riuscito |
|
|
Esecuzione pipeline |
Non riuscito Annullato Avviato Ripristinato Riuscito Sostituito |
|
|
Approvazione manuale |
Non riuscito Necessario Riuscito |
codepipeline-pipeline-manual-approval-succeeded |
