Crea un activador mediante la consola de Google Cloud

Puedes usar la página de la consola de Google Cloud de Eventarc para crear activadores.

Un activador de Eventarc declara tu interés en un evento o conjunto de eventos determinado. Si deseas configurar el enrutamiento del evento, especifica filtros para el activador, incluidos el origen del evento y el servicio de destino.

Las solicitudes a tu servicio se activan mediante uno de los siguientes tipos de eventos:

  1. En la consola de Google Cloud, ve a la página Eventarc.
    Ve a Eventarc

  2. Haz clic en Crear activador.

  3. Escribe un nombre de activador.

    Este es el ID del activador y debe comenzar con una letra. Puede contener hasta 63 letras en minúscula, números o guiones.

  4. Selecciona un Proveedor de eventos.

    Este es el servicio de Google o de socio que es la fuente de los eventos. Por ejemplo, selecciona BigQuery.

  5. Selecciona un evento.

    • Eventos personalizados: Se aplican a un proveedor de eventos de Cloud Pub/Sub
    • Eventos directos: Solo se aplica a algunos proveedores de eventos

    • A través de los registros de auditoría de Cloud: se aplica a todos los proveedores de eventos

    Personalizado

    Las solicitudes al servicio se activan cuando se publica un mensaje en un tema de Pub/Sub. Esto se aplica a un proveedor de eventos de Cloud Pub/Sub.

    1. En los eventos que aparecen en Personalizado, selecciona Tema de Cloud Pub/Sub.

    2. Selecciona un tema existente o acepta el valor predeterminado de Ninguno a fin de crear un nuevo tema para el activador.

      El tema de Pub/Sub existente debe estar en el mismo proyecto que el activador.

      De forma predeterminada, las suscripciones de Pub/Sub creadas para Eventarc persisten, independientemente de la actividad, y no vencen. Para cambiar la duración de la inactividad, consulta Administra suscripciones.

      Como práctica recomendada, te sugerimos que no vuelvas a usar el tema de Pub/Sub creado por un activador porque borrar un activador de Eventarc también borra los temas de Pub/Sub creados por el activador.

    3. Selecciona una Región.

      Los activadores de Eventarc solo están disponibles en ubicaciones de una sola región y no puedes crear un activador de Eventarc global.

    Direct

    Cloud Storage

    Las solicitudes al servicio se activan en respuesta a un evento dentro de un bucket de Cloud Storage: creación, eliminación, archivado y actualizaciones de metadatos de objetos. Esto se aplica a un proveedor de eventos de Cloud Storage.

    1. En los eventos enumerados en Directos, selecciona una de las siguientes opciones:

      • google.cloud.storage.object.v1.archived: El evento se envía cuando se archiva o se borra una versión publicada de un objeto. Este evento solo se envía para bucket con control de versiones.
      • google.cloud.storage.object.v1.delete: El evento se envía cuando se borra un objeto de manera permanente. Según la configuración del control de versiones del objeto de un bucket , esto significa lo siguiente:
        • En el caso de los buckets con control de versiones, este solo se envía cuando se borra una versión de manera permanente (pero no cuando se archiva un objeto).
        • En el caso de los buckets sin control de versiones, este se envía cuando se borra o se sobrescribe un objeto.
      • google.cloud.storage.object.v1.finalized: El evento se envía cuando se crea un objeto nuevo (o se reemplaza un objeto existente y se crea una generación nueva de ese objeto) en el bucket
      • google.cloud.storage.object.v1.metadataUpdated: El evento se envía cuando los metadatos de un objeto existente cambian.

    2. Especifica o busca el identificador único global del bucket de Cloud Storage.

      El bucket de Cloud Storage debe residir en el mismo proyecto de Google Cloud y región o multirregión que el activador de Eventarc.

    3. Selecciona una Región.

      Los activadores de Cloud Storage para Eventarc están disponibles en ubicaciones de una sola región, birregional y multirregión. Ten en cuenta que el bucket de Cloud Storage debe residir en el mismo proyecto de Google Cloud y región o multirregión que el activador de Eventarc.

    Los eventos se entregan mediante las notificaciones de Pub/Sub desde Cloud Storage. La configuración de demasiadas notificaciones registradas en el mismo bucket puede agotar el límite de notificaciones de este, como se indica en el error Cloud Storage bucket ...: Pub/Sub notification limit reached. El bucket puede tener hasta 10 configuraciones de notificación definidas para activar un evento específico. Consulta más cuotas y limitaciones en la página de cuotas y límites de Cloud Storage.

    Alertas de Firebase

    Las solicitudes al servicio se activan en respuesta a un evento cuando un servicio de Firebase publica una alerta de Firebase.

    1. En los eventos enumerados en Direct, selecciona google.firebase.firebasealerts.alerts.v1.published.

    2. En la lista Región, selecciona global (Global).

      Para obtener más información, consulta Ubicaciones de Eventarc.

    3. En la sección Filtros, en la lista alerttype, selecciona una de las siguientes opciones:

      • appDistribution.newTesterIosDevice: Se envía un evento cuando se registra un nuevo dispositivo iOS desde una app determinada
      • billing.planAutomatedUpdate: Se envía el evento cuando se actualiza automáticamente el plan de facturación de un proyecto de Firebase. Por ejemplo, cuando un plan cambia a una versión inferior debido a problemas de pago
      • billing.planUpdate: Se envía el evento cuando un usuario modifica el plan de facturación para un proyecto de Firebase. Por ejemplo, cuando una cuenta de facturación se adjunta a un proyecto o se desconecta de él
      • crashlytics.newAnrIssue: Se envía el evento cuando una app experimenta un error nuevo de Aplicación no responde (ANR) (no para ningún evento idéntico posterior)
      • crashlytics.newFatalIssue: Se envía el evento cuando una app experimenta una falla irrecuperable nueva (no para ningún evento idéntico posterior)
      • crashlytics.newNonfatalIssue: Se envía el evento cuando una app experimenta un error nuevo no recuperable (no para ningún evento idéntico posterior)
      • crashlytics.regression: Se envía el evento cuando una app experimenta una falla por un problema marcado como cerrado para una versión anterior de la app
      • crashlytics.stabilityDigest: Se envía el evento cuando hay una notificación sobre los principales problemas del momento en Crashlytics
      • crashlytics.velocity: Se envía un evento cuando un solo problema es responsable de provocar que una cantidad significativa de sesiones de la app fallen.

    4. De manera opcional, puedes filtrar eventos para un ID de app de Firebase específico. Haz clic en Agregar filtro y especifica el appid.

      Debe ser una concordancia exacta.

    Firebase Realtime Database

    Las solicitudes al servicio se activan en respuesta a un evento cuando se crean, actualizan o borran datos en Firebase Realtime Database.

    1. En los eventos enumerados en Directos, selecciona una de las siguientes opciones:

      • google.firebase.database.ref.v1.created: Se envía un evento cuando se crean datos en la base de datos
      • google.firebase.database.ref.v1.Updated: Se envía un evento cuando se actualizan los datos en la base de datos.
      • google.firebase.database.ref.v1.delete: Se envía un evento cuando se borran datos en la base de datos.
      • google.firebase.database.ref.v1.writing: Se envía un evento cuando se crean, actualizan o borran datos en la base de datos.

    2. En la lista Región, selecciona una región.

      Ten en cuenta que esta región debe coincidir con la de la instancia de Firebase Realtime Database. Para obtener más información, consulta Ubicaciones de Eventarc.

    3. En la sección Filtros, selecciona lo siguiente:

      1. Para el atributo de instancia de la base de datos, selecciona una de las siguientes opciones como operador:
      2. En el campo Valor del atributo 1, escribe el nombre de la instancia de la base de datos desde la que deseas recibir los eventos. Según el operador que elegiste en el paso anterior, el valor del atributo debe ser el nombre de la instancia de la base de datos exactamente como está o en un formato de patrón de ruta de acceso.
      3. Para el atributo ref, selecciona el operador como Patrón de ruta de acceso.
      4. En el campo Valor del atributo 2, escribe la ruta de acceso en la instancia de la base de datos para recibir eventos si se crean, actualizan o borran datos en esa ruta o en cualquiera de sus elementos secundarios.

    Firebase Remote Config

    Las solicitudes al servicio se activan en respuesta a un evento cuando se actualiza una plantilla de Remote Config.

    1. En los eventos enumerados en Directos, selecciona google.firebase.remoteconfig.remoteConfig.v1.updated.

    2. En la lista Región, selecciona global (Global).

      Para obtener más información, consulta Ubicaciones de Eventarc.

    Firebase Test Lab

    Las solicitudes al servicio se activan en respuesta a un evento cuando se completa una TestMatrix.

    1. En los eventos enumerados en Directos, selecciona google.firebase.testlab.testMatrix.v1.completed.

    2. En la lista Región, selecciona global (Global).

      Para obtener más información, consulta Ubicaciones de Eventarc.

    mediante Registros de auditoría de Cloud

    Las solicitudes a tu servicio se activan cuando se crea un registro de auditoría que coincide con los criterios de filtro del activador. Este tipo de evento se aplica a todos los proveedores de eventos.

    1. En los eventos enumerados en mediante registros de auditoría de Cloud, selecciona uno.

    2. Selecciona una de las siguientes opciones:

      • Cualquier recurso: Es el valor predeterminado y, además, incluye los recursos creados de forma dinámica que tienen identificadores generados en el momento de la creación.

      • Recurso específico: Debes proporcionar el nombre completo del recurso.

      • Patrón de ruta de acceso: Puedes filtrar los recursos mediante un patrón de ruta de acceso. Por ejemplo, escribe projects/_/buckets/eventarc-bucket/objects/random.txt o projects/_/buckets/**/r*.txt.

    3. Selecciona una Región.

      Los activadores de Cloud Audit Logging para Eventarc están disponibles en regiones específicas y en la global, pero no están disponibles en ubicaciones birregionales o multirregionales. Para evitar cualquier problema de rendimiento y residencia de datos que causa un activador global, te recomendamos que la ubicación coincida con la del servicio de Google Cloud que genera eventos.

      Si especificas la ubicación global, recibirás eventos de todas las ubicaciones para las que coincidan los filtros de evento. Por ejemplo, si creas un activador de Eventarc global, puedes recibir eventos de recursos en las multirregiones de EE.UU y UE.

    Para obtener más información sobre la captura de eventos que se activan cuando se crea un registro de auditoría que coincide con los criterios de filtro del activador, consulta Determina los filtros de eventos para los registros de auditoría de Cloud.

  6. Selecciona la cuenta de servicio que invoca el servicio.

    O bien, puedes crear una cuenta de servicio nueva.

    Esto especifica el correo electrónico de la cuenta de servicio de administración de identidades y accesos (IAM) asociado con el activador y al que otorgaste antes funciones específicas que requiere Eventarc.

  7. Selecciona un Destino de evento para tu activador.

    Cloud Run

    1. Selecciona un servicio.

      Este es el nombre del servicio que recibe los eventos del activador. El servicio debe estar en el mismo proyecto que el activador y recibirá eventos como solicitudes POST HTTP enviadas a su ruta de URL raíz (/), cada vez que se genere el evento.

    2. De manera opcional, puedes especificar la ruta de URL de servicio a la que enviar la solicitud entrante.

      Esta es la ruta relativa en el servicio de destino al que se deben enviar los eventos del activador. Por ejemplo: /, /route, route, route/subroute.

    Kubernetes Engine

    1. Selecciona un servicio.

      Este es el nombre del servicio que recibe los eventos del activador. El servicio debe estar en el mismo proyecto que el activador y recibirá eventos como solicitudes POST HTTP enviadas a su ruta de URL raíz (/), cada vez que se genere el evento.

    2. De manera opcional, puedes especificar la ruta de URL de servicio a la que enviar la solicitud entrante.

      Esta es la ruta relativa en el servicio de destino al que se deben enviar los eventos del activador. Por ejemplo: /, /route, route, route/subroute.

    Workflows

    Selecciona un flujo de trabajo.

    Este es el nombre del flujo de trabajo al que se pasan los eventos. Los eventos para una ejecución del flujo de trabajo se transforman y se pasan al flujo de trabajo como argumentos del entorno de ejecución.

    Para obtener más información, consulta Crea un activador para los flujos de trabajo.

  8. Haga clic en Crear.

Una vez que se crea un activador, los filtros de fuente del evento no se pueden modificar. En su lugar, crea un activador nuevo y borra el anterior. Para obtener más información, consulta Administra activadores.

¿Qué sigue?