Configurar un activador de Eventarc

Vista previa privada

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página se describe cómo configurar un activador de Eventarc en Application Integration.

Un activador de Eventarc te permite ejecutar integraciones basadas en eventos enrutados a través de Eventarc Standard. Con un activador de Eventarc, puedes crear flujos de integración activados por eventos de varios Google Cloud servicios, servicios de terceros y fuentes de eventos personalizadas. Por ejemplo, puedes usar el activador para iniciar una integración cuando se suba un objeto a un segmento de Cloud Storage.

En la consola de Google Cloud , puedes crear y configurar un activador de Eventarc de las siguientes formas:

• Usar Application Integration
• Usar Eventarc

Antes de empezar

Antes de configurar el activador de Eventarc, habilita la API de Eventarc y la API Pub/Sub:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Cuestiones importantes

Ten en cuenta lo siguiente al configurar un activador de Eventarc:

• Si se produce un error al crear el activador de Eventarc durante la publicación de la integración debido a errores de configuración, la integración se publicará igualmente, pero el activador no estará activo.

  Para solucionar este problema, despublica la integración, revisa y corrige cuidadosamente la configuración del activador de Eventarc y, a continuación, vuelve a publicar la integración. Para comprobar el estado de creación del activador de Eventarc, haz clic en (Notificación) en la barra de herramientas de la consola de Google Cloud.

• Si publicas una nueva versión de tu integración con una configuración de activación de Eventarc modificada, el activador antiguo se sustituirá automáticamente por uno nuevo. De esta forma, tu integración siempre usará la configuración de activadores más reciente y eliminará los activadores obsoletos.
• Si publicas una nueva versión de tu integración y usas el mismo activador de Eventarc y su configuración, no se creará un nuevo activador. En su lugar, se reutiliza el activador de Eventarc que ya tenías para la nueva versión de la integración.

Crear un activador de Eventarc desde Application Integration

Para crear un activador de Eventarc desde Application Integration, sigue estos pasos:

1. Añadir el activador de Eventarc en Application Integration
2. Configurar el activador de Eventarc en el editor de integración

Añadir el activador de Eventarc

Para añadir un activador de Eventarc a tu integración, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Integración de aplicaciones

2. En el menú de navegación, haga clic en Integraciones.

   Aparecerá la página Lista de integraciones, donde se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una nueva región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear.

   La integración que acabas de crear se abre en el editor de integraciones.

4. En la barra de navegación del editor de integraciones, haga clic en Activadores para ver la lista de activadores disponibles.
5. Arrastra y suelta el elemento Eventarc en el editor de integración.

Configurar el activador de Eventarc

Para configurar un activador de Eventarc, haz clic en el elemento Activador de Eventarc en el editor de integraciones. Aparecerá el panel de configuración Desencadenador de Eventarc con los siguientes campos:

• Etiqueta: (opcional) el nombre visible del activador de Eventarc en tu integración. Puedes cambiar la etiqueta por el nombre que quieras.
• Notas: (opcional) puedes añadir notas para proporcionar información adicional sobre el activador.
• Haga clic en Configurar activador de Eventarc y proporcione las siguientes entradas en el editor de activadores de Eventarc:
  • Nombre del activador: escribe un nombre para el activador.
  • Tipo de activador: seleccione uno de los siguientes tipos de activadores:
    • Fuente de Google: selecciona esta opción para crear un activador para Pub/Sub, Cloud Storage, Firestore y otros proveedores de eventos de Google.
    • Personalizado: selecciona esta opción para crear un activador para un origen de eventos personalizado.
    • Tercero: selecciona esta opción para crear un activador para proveedores que no sean de Google y que ofrezcan una fuente de Eventarc. Para obtener más información, consulta Eventos de terceros en Eventarc.
  • Proveedor de eventos: seleccione el proveedor de eventos del activador. La lista de proveedores de eventos depende del tipo de activador. Para obtener más información, consulta el artículo Proveedores y destinos de eventos.
  • Tipo de evento: selecciona el tipo de evento del activador. La configuración del activador varía en función del proveedor de eventos que selecciones. Para obtener más información, consulta la sección Tipos de eventos.
  • Región: selecciona la región del activador.
    Nota: Para que el rendimiento sea óptimo y la latencia mínima, asegúrate de que el activador de Eventarc, el recurso Google Cloud monitorizado y el servicio se encuentren en la misma Google Cloud región.
  • Filtros: (opcional) añade filtros para seleccionar las APIs que coincidan con tus criterios. Por ejemplo, si filtra las APIs por un nombre específico, el evento solo se activará si se actualizan las APIs que coincidan con los criterios del filtro.
  • Cuenta de servicio: selecciona la cuenta de servicio que quieras usar para el activador. Si no seleccionas ninguna cuenta de servicio, el activador usará la cuenta de servicio predeterminada de Compute Engine como identidad al invocar tu servicio. La cuenta de servicio asociada al activador debe tener los permisos necesarios para invocar tu servicio.

  • Reintentar tras fallo: selecciona esta opción para habilitar los reintentos de activación si el destino no puede procesar el evento.
  • Adjunto de red: selecciona el adjunto de red que quieras usar para el activador. Esta lista se genera a partir de los adjuntos de red creados en tu proyecto.

    Las vinculaciones de red facilitan la comunicación entre las redes de nube privada virtual (VPC) de los productores de servicios y las redes de VPC de los consumidores. Eventarc usa el adjunto de red configurado para establecer una conexión con un endpoint HTTP interno alojado en la red VPC del consumidor, lo que permite enviar datos de eventos. Para obtener más información sobre cómo crear y gestionar archivos adjuntos de red, consulta el artículo Crear y gestionar archivos adjuntos de red.

• Para guardar la configuración del activador, haz clic en Guardar activador.
Nota: Al guardar la configuración del activador de Eventarc, se definen las reglas que determinan cuándo y cómo responde Eventarc a los eventos. Esta configuración se almacena como parte de la definición del activador en Integration Application. Sin embargo, estas reglas no se aplican de inmediato. Debe publicar la integración para implementar estas reglas y activar el activador de Eventarc. Hasta que se publique, el activador permanecerá inactivo y no procesará eventos. Para obtener información sobre cómo publicar integraciones, consulta el artículo Publicar integraciones.

Crear un activador de Eventarc con la consola de Eventarc

Para crear un activador de Eventarc desde la página de la consola de Eventarc, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Eventarc > Triggers (Activadores).

   Ir a Activadores

   En la página Activadores se muestran todos los activadores de tu proyecto.

2. Haz clic en Crear activador.
3. En la página Crear activador, proporcione los siguientes datos:
   1. Nombre del activador: escriba un nombre para el activador.
   2. Tipo de activador: seleccione uno de los siguientes tipos de activadores:
      • Fuentes de Google: selecciona esta opción para crear un activador para Pub/Sub, Cloud Storage, Firestore y otros proveedores de eventos de Google.
      • Personalizado: selecciona esta opción para crear un activador para un origen de eventos personalizado.
      • Tercero: selecciona esta opción para crear un activador para proveedores que no sean de Google y que ofrezcan una fuente de Eventarc. Para obtener más información, consulta Eventos de terceros en Eventarc.
   3. Proveedor de eventos: seleccione el proveedor de eventos del activador. La lista de proveedores de eventos depende del tipo de activador. Para obtener más información, consulta Proveedores y destinos de eventos.
   4. Tipo de evento: selecciona el tipo de evento del activador. La configuración del activador varía en función del proveedor de eventos que selecciones. Para obtener más información, consulta Tipos de eventos.
   5. Tipo de contenido de datos de evento: selecciona el tipo de datos del contenido del evento. Selecciona application/json o application/protobuf.
   6. Región: selecciona la región del activador.
      Nota: Para obtener un rendimiento óptimo y minimizar la latencia, asegúrate de que el activador de Eventarc, el recurso de Google Cloud monitorizado y tu servicio se encuentren en la misma Google Cloud región.
   7. Cuenta de servicio: selecciona la cuenta de servicio que quieras usar para el activador. Si no seleccionas ninguna cuenta de servicio, el activador usará la cuenta de servicio predeterminada de Compute Engine como identidad al invocar tu servicio. La cuenta de servicio asociada al activador debe tener los permisos necesarios para invocar tu servicio.
   8. Destino del evento: selecciona Application Integration.
   9. Seleccionar una integración: elige la integración para la que quieras crear el activador. Si la integración se publica, Application Integration crea una nueva versión de borrador de la integración para añadir el activador de Eventarc.
   10. Adjunto de red: selecciona el adjunto de red que quieras usar para el activador. Esta lista se genera a partir de los adjuntos de red creados en tu proyecto.

       Las vinculaciones de red facilitan la comunicación entre las redes de nube privada virtual (VPC) de los productores de servicios y las redes de VPC de los consumidores. Eventarc usa el archivo adjunto de red configurado para establecer una conexión con un endpoint HTTP interno alojado en la red VPC del consumidor, lo que permite enviar datos de eventos. Para obtener más información sobre los archivos adjuntos de red, consulta Información sobre los archivos adjuntos de red.

4. Haz clic en Abrir integración.

   Se abre la página del editor de integración de aplicaciones con la integración seleccionada y el nuevo elemento Activador de Eventarc añadido a la integración.

5. Haga clic en el elemento Activador de Eventarc y abra el panel de configuración del activador.
6. Revisa y verifica la configuración del activador en la página Editor de activadores de Eventarc.
7. Conecta el nuevo activador de Eventarc a tu flujo de integración y publica la integración.
Nota: Debes publicar la integración para implementar y activar el activador Eventarc. Hasta que se publique, el activador permanecerá inactivo y no procesará eventos. Para obtener información sobre cómo publicar integraciones, consulta Probar y publicar integraciones.