Creazione di una regola di notifica - Console Strumenti di sviluppo

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

Creazione di una regola di notifica

È possibile utilizzare la console Strumenti di sviluppo o la AWS CLI per creare regole di notifica. Puoi creare un argomento Amazon SNS da utilizzare come destinazione per una regola di notifica durante la creazione della regola. Se si desidera utilizzare un client AWS Chatbot come destinazione, è necessario crearlo prima di poter creare la regola. Per ulteriori informazioni, consulta Configurazione di un client AWS Chatbot per un canale Slack.

Per creare una regola di notifica (console)

  1. Aprire la console Strumenti per sviluppatori AWS all'indirizzo https://console.aws.amazon.com/codesuite/settings/notifications.

  2. Utilizza la barra di spostamento per accedere alla risorsa.

    • Per CodeBuild, scegliere Build (Compila), selezionare Build projects (Progetti di compilazione) e scegliere un progetto di compilazione.

    • Per CodeCommit, scegliere Source (Origine), selezionare Repositories (Repository) e scegliere un repository.

    • Per CodeDeploy, scegliere Applications (Applicazioni) e scegliere un'applicazione.

    • Per CodePipeline, scegliere Pipeline, selezionare Pipelines (Pipeline) e scegliere una pipeline.

  3. Nella pagina delle risorse, scegliere Notify (Notifica), quindi selezionare Create notification rule (Crea regola di notifica). È anche possibile andare alla pagina Settings (Impostazioni) per la risorsa, passare a Notifications (Notifiche) o Notification rules (Regole notifiche) e scegliere Create notification rule (Crea regola di notifica).

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

  5. In Detail type (Tipo di dettaglio), scegliere Basic (Base) se si desidera includere solo le informazioni fornite a Amazon EventBridge nella notifica. Scegli Full (Completa) se desideri includere le informazioni fornite a Amazon EventBridge e le informazioni che potrebbero essere fornite dal servizio delle risorse o dal gestore delle notifiche.

    Per ulteriori informazioni, consulta Comprendere contenuti e sicurezza delle notifiche.

  6. In Events that trigger notifications (Eventi che attivano le notifiche), selezionare gli eventi per i quali si desidera inviare notifiche. Per i tipi di evento per una risorsa, vedere quanto segue:

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

    • Se è già stata configurata una risorsa da utilizzare con le notifiche, in Scegli il tipo di destinazione, scegliere AWS Chatbot (Slack), AWS Chatbot (Microsoft Teams) o Argomento SNS. In Scegli destinazione, sceglie il nome del client (per un client Slack o Microsoft Teams configurato in AWS Chatbot) o il nome della risorsa Amazon (ARN) dell'argomento Amazon SNS (per Amazon SNS gli argomenti già configurati con la policy richiesta per le notifiche).

    • Se non è stata configurata una risorsa da utilizzare con le notifiche, scegliere Create target (Crea destinazione), e quindi scegliere SNS topic (Argomento SNS). Fornire un nome per l'argomento dopo codestar-notifications-, quindi scegliere Create (Crea).

    Nota

    • Se si crea l'argomento Amazon SNS come parte della creazione della regola di notifica, viene applicata la policy che consente alla funzionalità di notifica di pubblicare eventi nell'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 è possibile creare un client AWS Chatbot durante la creazione di una regola di notifica. Se scegli l'opzione AWS Chatbot (Slack) o AWS Chatbot (Microsoft Teams), verrà visualizzato un pulsante che consente di passare alla configurazione di un client in AWS Chatbot. Scegliere questa opzione per aprire la console AWS Chatbot. Per ulteriori informazioni, consulta Configurazione di un client AWS Chatbot per un canale Slack.

    • Se si desidera utilizzare un argomento Amazon SNS esistente come destinazione, è necessario aggiungere la policy richiesta per AWS CodeStar Notifications oltre ad altre eventuali policy che potrebbero esistere per tale argomento. Per ulteriori informazioni, consulta Configura gli argomenti di Amazon SNS per le notifiche e Comprendere contenuti e sicurezza delle notifiche.

  8. Scegliere Submit (Invia), quindi esaminare la regola di notifica.

    Nota

    Gli utenti devono iscriversi e confermare le iscrizioni all'argomento Amazon SNS specificato come destinazione della regola prima di ricevere le notifiche. Per ulteriori informazioni, consulta Per iscrivere gli utenti a un argomento Amazon SNS utilizzato per le notifiche.

Per creare una regola di notifica (AWS CLI)

  1. Da un terminale o dal prompt dei comandi, eseguire il comando create-notification rule per generare lo skeleton JSON:

    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. Aprire il file JSON in un editor di testo normale e modificarlo per includere la risorsa, i tipi di evento e la destinazione Amazon SNS desiderata per la regola.

    L'esempio seguente mostra una regola di notifica denominata MyNotificationRule per un repository denominato MyDemoRepo in un account AWS con l'ID 123456789012. Le notifiche con il tipo di dettaglio completo vengono inviate a un argomento Amazon SNS 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"
}

    Salva 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 esito positivo, il comando restituisce l'ARN della regola di notifica, simile al seguente.

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

Per elencare i tipi di eventi per le regole di notifica (AWS CLI)

  1. Da un terminale o dal prompt dei comandi, eseguire il comando list-event-types. È possibile utilizzare l'opzione --filters per limitare la risposta a un tipo di risorsa specifico o ad un altro attributo. Ad esempio, il seguente comando restituisce un elenco di tipi di eventi per le applicazioni CodeDeploy.

    aws codestar-notifications list-event-types --filters Name=SERVICE_NAME,Value=CodeDeploy

  2. Questo comando genera un output simile al seguente.

    {
    "EventTypes": [
        {
            "EventTypeId": "codedeploy-application-deployment-succeeded",
            "ServiceName": "CodeDeploy",
            "EventTypeName": "Deployment: Succeeded",
            "ResourceType": "Application"
        },
        {
            "EventTypeId": "codedeploy-application-deployment-failed",
            "ServiceName": "CodeDeploy",
            "EventTypeName": "Deployment: Failed",
            "ResourceType": "Application"
        },
        {
            "EventTypeId": "codedeploy-application-deployment-started",
            "ServiceName": "CodeDeploy",
            "EventTypeName": "Deployment: Started",
            "ResourceType": "Application"
        }
    ]
}

Per aggiungere un tag a una regola di notifica (AWS CLI)

  1. Da un terminale o dal prompt dei comandi, eseguire il comando tag-resource. Ad esempio, utilizzare il comando seguente per aggiungere una coppia chiave-valore tag che ha il nome Team e il valore Li_Juan.

    aws codestar-notifications tag-resource --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE --tags Team=Li_Juan

  2. Questo comando genera un output simile al seguente.

    {
    "Tags": {
        "Team": "Li_Juan"
    }
}