Activa un flujo de trabajo con eventos o mensajes de Pub/Sub

Puedes usar un activador de Eventarc para ejecutar un flujo de trabajo como resultado de un evento o un conjunto de eventos. Los eventos se enrutan desde un proveedor de eventos a los receptores de eventos interesados.

Eventarc entrega eventos al receptor de eventos en el formato de CloudEvents a través de una solicitud HTTP. El servicio de Workflows convierte el evento en un objeto JSON (según la especificación de CloudEvents) y pasa el evento a la ejecución del flujo de trabajo como un argumento de entorno de ejecución del flujo de trabajo.

Se activa una ejecución de tu flujo de trabajo:

  • Cuando se crea un registro de auditoría que coincide con los criterios de filtro del activador. Por ejemplo, consulta esta guía de inicio rápido, en la que se activan Workflows con eventos de BigQuery mediante los registros de auditoría de Cloud.
  • En respuesta a eventos directos, como una actualización a un bucket de Cloud Storage o una actualización a una plantilla de Firebase Remote Config. Por ejemplo, consulta esta guía de inicio rápido, en la que se activan Workflows con eventos directos de Cloud Storage.
  • Por mensajes publicados en un tema de Pub/Sub Por ejemplo, consulta esta guía de inicio rápido, en la que se activan Workflows con mensajes de Pub/Sub.

Ten en cuenta lo siguiente:

  • Los eventos se consideran entregados en cuanto comienza la ejecución del flujo de trabajo, y la ejecución real se realiza de forma asíncrona en los servicios de Workflows.

  • Las ejecuciones activadas por eventos no se reintentan si se inicia la ejecución del flujo de trabajo, pero luego falla. Para obtener más información, consulta la Política de reintento de eventos.

  • La ventana de anulación de duplicación de flujos de trabajo para garantizar que el procesamiento de eventos del tipo “exactamente una vez” sea de 24 horas.

  • Cuando usas Workflows como destino para un activador de Eventarc, los eventos más grandes que el tamaño máximo del argumento de Workflows no activarán las ejecuciones de flujos de trabajo. Para obtener más información, consulta Cuotas y límites.

  • En los proyectos protegidos por un perímetro de servicio, cuando enrutas eventos a destinos de Workflows para los que el extremo de envío de Pub/Sub está configurado en una ejecución de Workflows, solo puedes crear suscripciones de envío de Pub/Sub nuevas a través de Eventarc. Ten en cuenta que la cuenta de servicio que se usa en la autenticación push para el extremo de Workflows debe incluirse en el perímetro de servicio. Para obtener más información, consulta Configura un perímetro de servicio con los Controles del servicio de VPC.

Crear un activador mediante Google Cloud CLI

Para crear un activador, ejecuta un comando gcloud eventarc triggers create junto con las marcas obligatorias y opcionales.

Para obtener más información, consulta las instrucciones de gcloud en la sección “Crea un activador” cuando crees un activador para un proveedor, un tipo de evento y un Workflows específicos.

Crear un activador mediante Console

En los siguientes pasos, se muestra cómo crear un activador en la página Flujos de trabajo de la consola de Google Cloud.

Antes de comenzar

  1. Habilita las API de Eventarc and Pub/Sub.

    Habilita las API

  2. Crea una cuenta de servicio para que Eventarc pueda realizar solicitudes a la API de Workflows:

    1. En la consola de Google Cloud, ve a la página Cuentas de servicio.

      Ir a Cuentas de servicio

    2. Selecciona un proyecto y haz clic en Crear cuenta de servicio.

    3. En el campo Nombre de la cuenta de servicio, ingresa un nombre que tenga entre 6 y 30 caracteres.

      Puede contener caracteres alfanuméricos en minúscula y guiones. Después de crear una cuenta de servicio, no podrás cambiar su nombre.

    4. Haz clic en Crear y continuar.

    5. Otorga a tu cuenta de servicio nueva el rol workflows.invoker para que la cuenta tenga permiso para activar tu flujo de trabajo. En la lista Selecciona un rol, selecciona Flujos de trabajo > Invocador de flujos de trabajo.

      Si desarrollas una app de producción, siempre otorga los roles menos permisivos posibles. Para obtener más información, consulta Administra el acceso a los proyectos, las carpetas y las organizaciones.

    6. Haz clic en Listo.

  3. Para permitir que la principal que ejecutará tus comandos de Eventarc pueda actuar como una cuenta de servicio de Identity and Access Management (IAM), otorga un rol que le permita a la principal usar la identidad de la cuenta de servicio.

Configura el activador

  1. Si aún no tienes un flujo de trabajo que desees activar, crea y, luego, implementa uno.

  2. En la consola de Google Cloud, ve a la página Workflows.

    Ir a Workflows

  3. En la página Workflows, selecciona un flujo de trabajo para ir a su página de detalles.

  4. En la página Detalles del flujo de trabajo, haz clic en Editar.

  5. En la página Editar flujo de trabajo, selecciona Agregar activador nuevo > Eventarc.

    Se abrirá el panel Evento de Eventarc.

  6. Sigue las instrucciones para crear un activador para un proveedor, un tipo de evento y un Workflows destino específicos, y consulta las instrucciones de Consola en la sección “Crea un activador”.

  7. Selecciona la Cuenta de servicio que invoca tu flujo de trabajo.

    Esto especifica la cuenta de servicio de IAM a la que le otorgaste antes la función workflows.invoker a fin de que la cuenta tenga permiso para activar tu flujo de trabajo.

  8. Haz clic en Guardar activador.

    El activador de Eventarc aparece en la pestaña Activadores de la página Detalles de flujos de trabajo.

  9. Si deseas actualizar o borrar el activador, debes editar el flujo de trabajo:

    1. En la página Detalles del flujo de trabajo, haz clic en Editar.
    2. En la sección Activadores, busca el activador que deseas actualizar o borrar.
    3. Haz clic en Editar recurso o Borrar recurso.

La ejecución del flujo de trabajo ahora se activa mediante los eventos que coinciden con los criterios de filtro del activador.

Crea un activador con Terraform

Puedes crear un activador para un flujo de trabajo con Terraform. Para obtener más detalles, consulta Activa un flujo de trabajo con Eventarc y Terraform.

¿Qué sigue?