Creación de una regla de notificación - AWS CodeDeploy

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación de una regla de notificación

Puede utilizar reglas de notificación para notificar a los usuarios cuando hay cambios en las aplicaciones de implementación, como éxitos y errores de implementación. Las reglas de notificación especifican tanto los eventos como el tema de Amazon SNS que se utiliza para enviar notificaciones. Para obtener más información, consulte ¿Qué son las notificaciones?

Puede usar la consola o la AWS CLI para crear reglas de notificación para AWS CodeDeploy.

Para crear una regla de notificación (consola)

  1. Inicie sesión en la CodeDeploy consola AWS Management Console y ábrala en https://console.aws.amazon.com/codedeploy/.

  2. Elija Application (Aplicación) y, a continuación, elija una aplicación donde desea agregar notificaciones.

  3. En la página de la aplicación, elija Notify (Notificar) y, a continuación, elija Create notification rule (Crear regla de notificación). También puede ir a la página Settings (Configuración) para la aplicación y elegir Create notification rule (Crear regla de notificación).

  4. En Nombre de la notificación, introduzca un nombre para la regla.

  5. En Tipo de detalle, selecciona Básico si quieres que solo se EventBridge incluya en la notificación la información proporcionada a Amazon. Selecciona Completa si deseas incluir la información proporcionada a Amazon EventBridge y la información que pueda proporcionar el administrador de notificaciones CodeDeploy o el administrador de notificaciones.

    Para obtener más información, consulte Descripción del contenido y la seguridad de las notificaciones.

  6. En Eventos que activan notificaciones, seleccione los eventos para los que desea enviar notificaciones.

    Categoría Eventos

    Implementación

    Con error

    Succeeded

    Started

  7. En Targets (Destinos), elija Create SNS topic (Crear tema SNS).

    nota

    Al crear el tema, se aplicará la política que CodeDeploy permite publicar eventos sobre el tema. El uso de un tema creado específicamente para CodeDeploy las notificaciones también ayuda a garantizar que solo añada usuarios a la lista de suscripciones de ese tema para los que desee ver las notificaciones sobre esta aplicación de despliegue.

    Después del prefijo codestar-notifications- escriba un nombre para el tema y, a continuación, elija Submit (Enviar).

    nota

    Si desea utilizar un tema de Amazon SNS existente en lugar de crear uno nuevo, en Targets (Destinos), elija su ARN. Asegúrese de que el tema tiene la directiva de acceso adecuada y de que la lista de suscriptores contiene salo aquellos usuarios a los que se permite ver información sobre la aplicación de implementación. Para obtener más información, consulte Configuración de temas existentes de Amazon SNS para notificaciones y Descripción del contenido y la seguridad de las notificaciones.

  8. Para terminar de crear la regla, elija Enviar.

  9. Debe suscribir a los usuarios al tema de Amazon SNS de la regla antes de que puedan recibir notificaciones. Para obtener más información, consulte Suscribir usuarios a temas de Amazon SNS que son destinos. También puede configurar la integración entre las notificaciones y enviar notificaciones AWS Chatbot a las salas de chat de Amazon Chime o a los canales de Slack. Para obtener más información, consulte Configurar la integración entre notificaciones y. AWS Chatbot

Para crear una regla de notificación (AWS CLI)

  1. En un terminal o símbolo del sistema, ejecute el comando create-notification rule para generar el esqueleto JSON:

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

    Puede asignar al archivo el nombre que desee. En este ejemplo, el archivo se denomina rule.json.

  2. Abra el archivo JSON en un editor de texto sin formato y edítelo para incluir el recurso, los tipos de eventos y el destino de Amazon SNS que desea para la regla. En el siguiente ejemplo, se muestra una regla de notificación con MyNotificationRule el nombre de una aplicación nombrada MyDeploymentApplicationen una AWS cuenta con el identificador 123456789012. Las notificaciones se envían con todos los detalles a un tema de Amazon SNS denominado codestar-notifications- MyNotificationTopic cuando las implementaciones se realizan correctamente:

    {
    "Name": "MyNotificationRule",
    "EventTypeIds": [
        "codedeploy-application-deployment-succeeded"
    ],
    "Resource": "arn:aws:codebuild:us-east-2:123456789012:MyDeploymentApplication",
    "Targets": [
        {
            "TargetType": "SNS",
            "TargetAddress": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyNotificationTopic"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL"
}

    Guarde el archivo.

  3. Mediante el archivo que acaba de modificar, en el terminal o línea de comandos, vuelva a ejecutar el comando create-notification-rule para crear la regla de notificación:

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

  4. Si se ejecuta correctamente, el comando devuelve el ARN de la regla de notificación, similar a lo siguiente:

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