Activador con eventos

Puedes crear un activador de Eventarc para que el servicio de Cloud Run reciba notificaciones de un evento o del conjunto de eventos especificado. Si especificas filtros para el activador, puedes configurar el enrutamiento del evento, incluida la fuente del evento y el servicio de Cloud Run de destino.

Los eventos enviados a tu servicio de Cloud Run se reciben en forma de solicitudes HTTP.

Los siguientes tipos de eventos activan solicitudes a tu servicio:

En esta página, se muestra cómo crear un activador a través de la página de la consola de Cloud Run.

También puedes crear un activador de Eventarc con Google Cloud CLI o la página de la consola de Eventarc. Sigue las instrucciones a fin de crear un activador para un proveedor, un tipo de evento y un destino específicos.

Prepárate para crear un activador

Antes de crear un activador, completa estos requisitos previos:

  1. Eventarc usa una cuenta de servicio proporcionada por el cliente como la identidad del activador. Asegúrate de otorgar las funciones y permisos necesarios a la cuenta de servicio del activador.

    Por ejemplo, para enviar eventos a un servicio de Cloud Run que requiera autenticación, la cuenta de servicio del activador de Eventarc debe tener el rol de Identity and Access Management (IAM) de invocador Cloud Run.

  2. Si creas un activador para un evento directo desde Cloud Storage, otorga el rol pubsub.publisher a la cuenta de servicio de Cloud Storage:

    SERVICE_ACCOUNT="$(gsutil kms serviceaccount -p PROJECT_ID)"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT}" \
    --role='roles/pubsub.publisher'

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud. Puedes buscar el ID del proyecto en la página de bienvenida de la consola de Google Cloud.

Crea un activador a través de la consola

Puedes usar la página de la consola de Cloud Run para crear un activador de Eventarc.

  1. Si es necesario, habilita la API de Eventarc.

    Habilitar la API

  2. En la consola de Google Cloud ve a Cloud Run.

    Ir a Cloud Run

  3. En la lista de servicios, haz clic en un servicio existente o crea uno nuevo.

  4. En la página de detalles del servicio, haz clic en la pestaña Activadores.

  5. Haz clic en Agregar activador de Eventarc.

    Se abrirá el panel Evento de Eventarc. Para determinar la mejor manera de enrutar eventos, consulta Opciones de enrutamiento de eventos.

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

  7. Selecciona la cuenta de servicio que invoca el servicio de Cloud Run.

    También puedes crear una cuenta de servicio nueva.

    Esto especifica el correo electrónico de la cuenta de servicio de IAM asociada con el activador. En los destinos de Cloud Run, esta cuenta de servicio se usa para generar tokens de identidad cuando se invoca el servicio.

  8. De manera opcional, especifica la ruta de URL del servicio a la que se 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 y route/subroute.

  9. Después de crear el activador, verifica su estado. Para esto, asegúrate de que haya una marca de verificación en la pestaña Activadores.

¿Qué sigue?