Configura un activador de Eventarc

Vista previa privada

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa 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 personalizados. Por ejemplo, puedes usar el activador para iniciar una integración cuando se sube un objeto nuevo a un bucket de Cloud Storage.

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

• Con Application Integration
• Con Eventarc

Antes de comenzar

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

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

Habilitar las API

Consideraciones

Ten en cuenta lo siguiente cuando configures un activador de Eventarc:

• Si falla la creación del activador de Eventarc durante la publicación de la integración debido a errores de configuración, la integración se publicará, pero el activador no estará activo.

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

• Cuando publicas una versión nueva de tu integración con una configuración modificada del activador de Eventarc se reemplaza automáticamente el activador anterior por uno nuevo. Esto garantiza que tu integración siempre use la configuración más reciente del activador y borre los activadores obsoletos.
• Si publicas una versión nueva de tu integración y usas el mismo activador de Eventarc y su configuración, no se crea un activador nuevo. En cambio, se reutiliza el activador de Eventarc existente para la nueva versión de la integración.

Crea un activador de Eventarc desde Application Integration

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

1. Agrega el activador de Eventarc en Application Integration
2. Configura el activador de Eventarc en el editor de integración

Agrega el activador de Eventarc

Para agregar un activador de Eventarc a tu integración, completa los siguientes pasos:

1. En la Google Cloud consola de, ve a la página Application Integration.

   Ir a Application Integration

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

   Aparecerá la página Lista de integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa 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 enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
   3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el Resumen de la integración panel en la barra de herramientas de integración.
      Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de la integración para la región seleccionada.
   4. Haz clic en Crear.

   La integración recién creada se abrirá en el editor de integración.

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

Configura el activador de Eventarc

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

• Etiqueta: (opcional) es el nombre visible del activador de Eventarc en tu integración. Puedes cambiar la etiqueta por el nombre que elijas.
• Notas: (opcional) puedes agregar notas para proporcionar información adicional sobre el activador.
• Haz clic en Configurar activador de Eventarc y proporciona las siguientes entradas en el editor de activadores de Eventarc:
  • Nombre del activador: Ingresa un nombre para el activador.
  • Tipo de activador: Selecciona 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 una fuente de eventos personalizada.
    • Terceros: Selecciona esta opción para crear un activador para proveedores externos a Google que ofrecen una fuente de Eventarc. Para obtener más información, consulta Eventos de terceros en Eventarc.
  • Proveedor de eventos: Selecciona el proveedor de eventos para el activador. La lista de proveedores de eventos depende del tipo de activador. Para obtener más información, consulta Proveedores y destinos de eventos.
  • Tipo de evento: Selecciona el tipo de evento para el activador. La configuración del activador varía según el proveedor de eventos que selecciones. Para obtener más información, consulta Tipos de eventos.
  • Región: Selecciona la región para el activador.
    Sugerencia: Para obtener un rendimiento óptimo y minimizar la latencia, asegúrate de que el activador de Eventarc, el monitored Google Cloud resource y tu servicio estén ubicados en la misma Google Cloud región.
  • Filtros: (opcional) agrega filtros para seleccionar las APIs que coincidan con tus criterios. Por ejemplo, si filtras las APIs por un nombre específico, el evento se activa solo si se actualizan las APIs que coinciden con los criterios de filtro.
  • Cuenta de servicio: Selecciona la cuenta de servicio que se usará para el activador. Si no seleccionas una cuenta de servicio, el activador usa la cuenta de servicio predeterminada de Compute Engine como su identidad cuando invoca tu servicio. La cuenta de servicio asociada con el activador debe tener los permisos necesarios para invocar tu servicio.

  • Volver a intentar en caso de error: Selecciona esta opción para habilitar los reintentos del activador si el destino no puede procesar el evento.
  • Adjunto de red: Selecciona el adjunto de red que se usará para el activador. Esta lista se genera en función de los adjuntos de red creados en tu proyecto.

    Los adjuntos de red facilitan la comunicación entre las redes de nube privada virtual (VPC) del productor de servicios y las redes de VPC del consumidor. Eventarc usa el adjunto de red configurado para establecer una conexión con un extremo HTTP interno alojado dentro de la red de VPC del consumidor, lo que permite la entrega de datos de eventos. Para obtener más información sobre cómo crear y administrar adjuntos de red, consulta Crea y administra adjuntos de red.

• Para guardar la configuración del activador, haz clic en Guardar activador.
Nota: Cuando guardas la configuración del activador de Eventarc, se definen las reglas que determinan cuándo y cómo Eventarc responde a los eventos. Esta configuración se almacena como parte de la definición del activador en Application Integration. Sin embargo, estas reglas no se aplican de inmediato. Debes 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 la publicación de integraciones, consulta Publica integraciones.

Crea 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 de, ve a la página Eventarc > Activadores.

   Ir a Activadores

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

2. Haz clic en Crear activador.
3. En la página Crear activador, proporciona las siguientes entradas:
   1. Nombre del activador: Ingresa un nombre para el activador.
   2. Tipo de activador: Selecciona 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 una fuente de eventos personalizada.
      • Terceros: Selecciona esta opción para crear un activador para proveedores externos a Google que ofrecen una fuente de Eventarc. Para obtener más información, consulta Eventos de terceros en Eventarc.
   3. Proveedor de eventos: Selecciona el proveedor de eventos para el 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 para el activador. La configuración del activador varía según el proveedor de eventos que selecciones. Para obtener más información, consulta Tipos de eventos.
   5. Tipo de contenido de datos de eventos: Selecciona el tipo de datos para el contenido del evento. Selecciona application/json o application/protobuf.
   6. Región: Selecciona la región para el activador.
      Sugerencia: Para obtener un rendimiento óptimo y minimizar la latencia, asegúrate de que el activador de Eventarc, el recurso de Google Cloud supervisado y tu servicio estén ubicados en la misma Google Cloud región.
   7. Cuenta de servicio: Selecciona la cuenta de servicio que se usará para el activador. Si no seleccionas una cuenta de servicio, el activador usa la cuenta de servicio predeterminada de Compute Engine como su identidad cuando invoca tu servicio. La cuenta de servicio asociada con el activador debe tener los permisos necesarios para invocar tu servicio.
   8. Destino del evento: selecciona Application Integration.
   9. Selecciona una integración: Selecciona la integración para la que deseas crear el activador. Si se publica la integración, Application Integration crea una nueva versión de borrador de la integración para agregarle el activador de Eventarc.
   10. Adjunto de red: Selecciona el adjunto de red que se usará para el activador. Esta lista se genera en función de los adjuntos de red creados en tu proyecto.

       Los adjuntos de red facilitan la comunicación entre las redes de nube privada virtual (VPC) del productor de servicios y las redes de VPC del consumidor. Eventarc usa el adjunto de red configurado para establecer una conexión con un extremo HTTP interno alojado dentro de la red de VPC del consumidor, lo que permite la entrega de datos de eventos. Para obtener más información sobre los adjuntos de red, consulta Acerca de los adjuntos de red.

4. Haz clic en Abrir integración.

   Se abrirá la página del editor de Application Integration con la integración seleccionada y el nuevo elemento Activador de Eventarc agregado a la integración.

5. Haz clic en el elemento Activador de Eventarc y abre 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 de Eventarc. Hasta que se publique, el activador permanecerá inactivo y no procesará eventos. Para obtener información sobre la publicación de integraciones, consulta Prueba y publica integraciones.