Creación de una regla de notificación

Puede utilizar reglas de notificación para notificar a los usuarios los cambios importantes; por ejemplo, si se crea una solicitud de extracción en un repositorio. Las reglas de notificación especifican tanto los eventos como el SNS tema de Amazon que se usa para enviar las notificaciones. Para obtener más información, consulte ¿Qué son las notificaciones?

nota

Esta característica no está disponible en la región de Europa (Milán). Para obtener información sobre cómo configurar las notificaciones en la experiencia disponible en esa región, consulte Configurar las notificaciones del repositorio.

Puedes usar la consola o la AWS CLI para crear reglas de notificación AWS CodeCommit.

Para crear una regla de notificación (consola)

1. Inicie sesión en AWS Management Console y abra la CodeCommit consola en https://console.aws.amazon.com/codecommit/.

2. Elija Repositories (Repositorios) y seleccione el repositorio en el que desea añadir reglas de notificación.

3. En la página del repositorio, seleccione Notify (Notificar) y Create notification rule (Crear regla de notificación). También puede ir a la página Settings (Configuración) del repositorio y seleccionar 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 CodeCommit 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. Para obtener más información, consulte Eventos para reglas de notificación en repositorios.

7. En Destinos, realice una de las siguientes operaciones:

   • Si ya has configurado un recurso para usarlo con las notificaciones, en Elegir tipo de destino, elige AWS Chatbot (Slack) o SNStema. En Choose target, elige el nombre del cliente (para un cliente de Slack configurado en AWS Chatbot) o el nombre del recurso de Amazon (ARN) del SNS tema de Amazon (para los SNS temas de Amazon ya configurados con la política requerida para las notificaciones).

   • Si no has configurado un recurso para usarlo con las notificaciones, selecciona Crear destino y, a continuación, elige el SNStema. Indique el nombre del tema después de codestar-notifications- y, a continuación, elija Crear.

   nota

   • Si creas el SNS tema de Amazon como parte de la creación de la regla de notificación, se te aplicará la política que permite que la función de notificaciones publique eventos en el tema. El uso de un tema creado para las reglas de notificación lo ayuda a garantizar que solo suscriba a los usuarios que desea recibir notificaciones sobre este recurso.

   • No puedes crear un AWS Chatbot cliente como parte de la creación de una regla de notificación. Si eliges AWS Chatbot (Slack), verás un botón que te indicará que configures un cliente. AWS Chatbot Al seleccionar esa opción, se abre la AWS Chatbot consola. Para obtener más información, consulte Configurar integraciones entre notificaciones y AWS Chatbot.

   • Si quieres utilizar un SNS tema de Amazon existente como objetivo, debes añadir la política requerida para AWS CodeStar las notificaciones además de cualquier otra política que pueda existir para ese tema. Para obtener más información, consulte Configurar SNS los temas de Amazon para las notificaciones y Comprender el contenido y la seguridad de las notificaciones.

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

9. Debes suscribir a los usuarios al SNS tema de Amazon de la regla para que puedan recibir notificaciones. Para obtener más información, consulte Suscribir a los usuarios a los SNS temas de Amazon que son objetivos. También puede configurar la integración entre las notificaciones y enviar notificaciones AWS Chatbot a las salas de chat de Amazon Chime. 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 una terminal o línea de comandos, ejecute el create-notification rule comando para generar el JSON esqueleto:

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

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

2. Abra el JSON archivo en un editor de texto sin formato y edítelo para incluir el recurso, los tipos de eventos y el destino que desee para la regla. En el siguiente ejemplo, se muestra una regla de notificación con el nombre MyNotificationRule de un repositorio denominado MyDemoRepo en una AWS cuenta con el ID 123456789012. Las notificaciones con todos los detalles se envían a un SNS tema de Amazon llamado MyNotificationTopic cuando se crean sucursales y etiquetas:

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

   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 la regla ARN de notificación, similar a la siguiente:

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