Dirigir eventos de Cloud Storage a Workflows

Consola

1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.

   Ir al selector de proyectos

2. Habilita las APIs Eventarc, Eventarc Publishing, Workflows y Workflow Executions.

   Habilita las APIs

3. Si procede, habilita la API relacionada con los eventos directos. Por ejemplo, para los eventos de Cloud Storage , habilita la APICloud Storage .

4. Si aún no tienes una, crea una cuenta de servicio gestionada por el usuario y, a continuación, concédele los roles y permisos necesarios para que Eventarc pueda gestionar eventos de un flujo de trabajo de destino.

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

      Ir a Cuentas de servicio

   2. Selecciona el proyecto.

   3. En el campo Nombre de cuenta de servicio, escribe un nombre. La Google Cloud consola rellena el campo ID de cuenta de servicio con este nombre.

      En el campo Descripción de la cuenta de servicio, escribe una descripción. Por ejemplo, Service account for event trigger.

   4. Haz clic en Crear y continuar.

   5. Para proporcionar el acceso adecuado, en la lista Seleccionar un rol, elige los roles de gestión de identidades y accesos (IAM) que quieras conceder a tu cuenta de servicio. Para obtener más información, consulta Roles y permisos de los destinos de los flujos de trabajo.

      Para añadir más roles, haz clic en add Añadir otro rol y añade cada rol adicional.

   6. Haz clic en Continuar.

   7. Para terminar de crear la cuenta, haga clic en Hecho.

5. Asigna el rol Publicador de Pub/Sub al agente de servicio de Cloud Storage. Normalmente, es service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com. Puedes obtener la dirección de correo del agente de servicio de Cloud Storage.

   1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

      Ir a IAM

   2. En la fila del agente de servicio de Cloud Storage, haz clic en editEditar principal. Si el agente de servicio no aparece en la lista, ve al paso siguiente. Se abrirá el panel Editar acceso.

      1. Haz clic en addAñadir otro rol y, a continuación, busca el rol Editor de Pub/Sub.
      2. Selecciona el rol.
      3. Haz clic en Guardar.

   3. Si el agente de servicio no aparece en la lista, haz clic en person_addDar acceso. Se abrirá el panel Dar acceso.

      1. En el campo Principales nuevos, introduce la dirección de correo del agente de servicio.
      2. En la lista Selecciona un rol, busca el rol Editor de Pub/Sub.
      3. Selecciona el rol.
      4. Haz clic en Guardar.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Habilita las APIs Eventarc, Eventarc Publishing, Workflows y Workflow Executions:

   gcloud services enable eventarc.googleapis.com \
       eventarcpublishing.googleapis.com \
       workflows.googleapis.com \
       workflowexecutions.googleapis.com

3. Si procede, habilita la API relacionada con los eventos directos. Por ejemplo, para los eventos, habilita Cloud Storage .storage.googleapis.com

4. Si aún no tienes una, crea una cuenta de servicio gestionada por el usuario y, a continuación, concédele los roles y permisos necesarios para que Eventarc pueda gestionar eventos de un flujo de trabajo de destino.

   1. Crea la cuenta de servicio:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Sustituye SERVICE_ACCOUNT_NAME por el nombre de la cuenta de servicio. Debe tener entre 6 y 30 caracteres, y puede contener caracteres alfanuméricos en minúscula y guiones. Una vez que hayas creado una cuenta de servicio, no podrás cambiar su nombre.

   2. Concede los roles o permisos de Gestión de Identidades y Accesos (IAM) necesarios. Para obtener más información, consulta Roles y permisos de los destinos de los flujos de trabajo.

5. Si vas a crear un activador para un evento directo de Cloud Storage, asigna el rol pubsub.publisher a la cuenta de servicio de Cloud Storage:

   SERVICE_ACCOUNT="$(gcloud storage service-agent --project=PROJECT_ID)"
   
   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member="serviceAccount:${SERVICE_ACCOUNT}" \
       --role="roles/pubsub.publisher"
   

Consola

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

   Ir a Activadores

2. Haz clic en add_box Crear activador.
3. Escribe un Nombre del activador.

   Es el ID del activador y debe empezar por una letra. Puede contener hasta 63 letras minúsculas, números o guiones.

4. En Tipo de activador, selecciona Fuentes de Google.
5. En la lista Event provider (Proveedor de eventos), seleccione Cloud Storage.

   Tenga en cuenta que el nombre del proveedor de eventos que se usa en la documentaciónGoogle Cloud asociada puede no tener el prefijo Cloud o Google Cloud. Por ejemplo, en la consola, Memorystore para Redis se denomina Google Cloud Memorystore para Redis.

6. En la lista Tipo de evento, en los eventos Directos, selecciona un tipo de evento:
   • google.cloud.storage.object.v1.archived este evento se envía cuando una versión activa de un objeto se convierte en una versión no actual. Para obtener más información, consulta Gestión de versiones de objetos.
   • google.cloud.storage.object.v1.delete el evento se envía cuando se elimina un objeto de forma no definitiva. Para obtener más información, consulta Eliminación temporal.
   • google.cloud.storage.object.v1.finalized el evento se envía cuando se crea un objeto (o se sobrescribe un objeto ya disponible y se crea una nueva generación de ese objeto) en el segmento.
   • google.cloud.storage.object.v1.metadataUpdated se envía cuando cambian los [metadatos](/storage/docs/metadata) de un objeto.
7. En la lista Tipo de contenido de datos de evento, seleccione la codificación de la carga útil del evento.

   En el caso de los eventos directos de Cloud Storage, este valor debe ser application/json.

8. Especifica o busca el identificador único global del segmento de Cloud Storage.

   El segmento de Cloud Storage debe estar en el mismoGoogle Cloud proyecto y en la misma región o multirregión que el activador de Eventarc.

9. Selecciona una región.

   Los activadores de Cloud Storage para Eventarc están disponibles en ubicaciones de una sola región, dos regiones y varias regiones. Ten en cuenta que el segmento de Cloud Storage debe estar en el mismo proyecto y en la misma región o multirregión que el activador de Eventarc. Google Cloud

   Los eventos se envían mediante notificaciones de Pub/Sub de Cloud Storage. Si se configuran demasiadas notificaciones registradas en el mismo contenedor, se puede agotar el límite de notificaciones del contenedor, tal como se indica en el error Cloud Storage bucket ...: Pub/Sub notification limit reached. Cada segmento puede tener un máximo de 10 configuraciones de notificaciones que se activen con un evento concreto. Consulta más cuotas y limitaciones en la página de cuotas y límites de Cloud Storage.

10. Selecciona la cuenta de servicio que invocará tu servicio o flujo de trabajo.

    También puedes crear una cuenta de servicio.

    Especifica la dirección de correo de la cuenta de servicio de Gestión de Identidades y Accesos (IAM) asociada al activador y a la que has concedido roles específicos necesarios para Eventarc.

11. En la lista Destino del evento, selecciona Workflows.
12. Selecciona un flujo de trabajo.
    

    Es el nombre del flujo de trabajo al que se enviarán los eventos. Los eventos de una ejecución de flujo de trabajo se transforman y se transfieren al flujo de trabajo como argumentos de tiempo de ejecución.

    Para obtener más información, consulta el artículo Crear un activador para Workflows.

13. Si quieres añadir una etiqueta, puedes hacer clic en add Añadir etiqueta. Las etiquetas son pares clave-valor que te ayudan a organizar tus recursosGoogle Cloud . Para obtener más información, consulta ¿Qué son las etiquetas?
14. Haz clic en Crear.

Una vez creado un activador, no se pueden modificar los filtros de origen de eventos. En su lugar, cree un nuevo activador y elimine el antiguo. Para obtener más información, consulta Gestionar activadores.

gcloud

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-workflow=DESTINATION_WORKFLOW  \
    --destination-workflow-location=DESTINATION_WORKFLOW_LOCATION \
    --event-filters="type=EVENT_FILTER_TYPE" \
    --event-filters="bucket=BUCKET" \
    --service-account="MY_SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com"

Haz los cambios siguientes:

• TRIGGER: el ID del activador o un identificador completo.
• LOCATION: la ubicación del activador de Eventarc, que está disponible en ubicaciones de una sola región, dos regiones y varias regiones. No puedes crear un activador de Eventarc global. Ten en cuenta que el segmento de Cloud Storage debe estar en el mismo Google Cloud proyecto y región que el activador de Eventarc. Para obtener más información, consulta Ubicaciones de Eventarc.
• DESTINATION_WORKFLOW: el ID del flujo de trabajo implementado que recibe los eventos del activador. El flujo de trabajo puede estar en cualquiera de las ubicaciones admitidas de Workflows y no tiene por qué estar en la misma ubicación que el activador. Sin embargo, el flujo de trabajo debe estar en el mismo proyecto que el activador.
• DESTINATION_WORKFLOW_LOCATION (opcional): la ubicación en la que se implementa el flujo de trabajo de destino. Si no se especifica, se da por hecho que el flujo de trabajo está en la misma ubicación que el activador.
• EVENT_FILTER_TYPE: el identificador del evento de Cloud Storage. Puede ser uno de los siguientes:
  • google.cloud.storage.object.v1.finalized: el evento se envía cuando se crea un objeto (o se sobrescribe un objeto ya disponible y se crea una nueva generación de ese objeto) en el segmento.
  • google.cloud.storage.object.v1.archived: el evento se envía cuando la versión activa de un objeto se convierte en una versión no actual. Para obtener más información, consulta Gestión de versiones de objetos.
  • google.cloud.storage.object.v1.deleted: el evento se envía cuando se elimina un objeto de forma no definitiva. Para obtener más información, consulta Eliminación lógica.
  • google.cloud.storage.object.v1.metadataUpdated: el evento se envía cuando cambian los metadatos de un objeto.
• BUCKET: identificador único global del segmento de Cloud Storage.
• SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio de gestión de identidades y accesos que has creado y a la que has concedido los roles específicos que necesita Workflows.
• PROJECT_ID: tu ID de proyecto Google Cloud

Notas:

• En el caso de los eventos directos de Cloud Storage, la codificación de la carga útil del evento es application/json.
• Estas marcas son obligatorias:
  • --event-filters="type=EVENT_FILTER_TYPE"
  • --event-filters="bucket=BUCKET"
• Una vez creado un activador, no se puede cambiar EVENT_FILTER_TYPE. Si quieres usar otro tipo de evento, debes crear un nuevo activador.
• --service-account: La dirección de correo de la cuenta de servicio de gestión de identidades y accesos que usará el activador de Eventarc para invocar las ejecuciones del flujo de trabajo. Te recomendamos que utilices una cuenta de servicio con los privilegios mínimos necesarios para acceder a los recursos requeridos. Para obtener más información sobre las cuentas de servicio, consulta el artículo Crear y gestionar cuentas de servicio.
• Los eventos se envían mediante notificaciones de Pub/Sub de Cloud Storage. Si se configuran demasiadas notificaciones registradas en el mismo contenedor, se puede agotar el límite de notificaciones del contenedor, tal como se indica en el error Cloud Storage bucket ...: Pub/Sub notification limit reached. Cada segmento puede tener un máximo de 10 configuraciones de notificaciones que se activen con un evento concreto. Consulta más cuotas y limitaciones en la página de cuotas y límites de Cloud Storage.
• Cada activador puede tener varios filtros de eventos, separados por comas en una --event-filters=[ATTRIBUTE=VALUE,...] marca, o puede repetir la marca para añadir más filtros. Solo se envían al destino los eventos que coinciden con todos los filtros. No se admiten comodines ni expresiones regulares.
• El segmento de Cloud Storage debe estar en el mismo Google Cloudproyecto y en la misma región o multirregión que el activador de Eventarc.
• De forma predeterminada, las suscripciones de Pub/Sub creadas para Eventarc se conservan independientemente de la actividad y no caducan. Para cambiar la duración de la inactividad, consulta Propiedades de la suscripción.

Ejemplo:

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-workflow=my-workflow \
    --destination-workflow-location=europe-west4 \
    --event-filters="type=google.cloud.storage.object.v1.finalized" \
    --event-filters="bucket=my-project-bucket" \
    --service-account="${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com"

Este comando crea un activador llamado helloworld-trigger para el segmento de Cloud Storage my-project-bucket y el evento identificado como google.cloud.storage.object.v1.finalized.

Terraform

Puedes crear un activador para un flujo de trabajo con Terraform. Para obtener más información, consulta el artículo Activar un flujo de trabajo con Eventarc y Terraform.

Consola

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

   Ir a Activadores

   En esta página se muestran todos tus activadores de todas las ubicaciones, así como detalles como nombres, regiones, proveedores de eventos, destinos y más.

2. Para filtrar tus activadores, sigue estos pasos:

   1. Haz clic en filter_list Filtrar o en el campo Activar filtros.
   2. En la lista Propiedades, seleccione una opción para filtrar los activadores.

   Puede seleccionar una sola propiedad o usar el operador lógico OR para añadir más propiedades.

3. Para ordenar los activadores, junto al encabezado de cualquier columna admitida, haz clic en arrow_upward Ordenar.

gcloud

Ejecuta el siguiente comando para ver una lista de tus activadores:

gcloud eventarc triggers list --location=-

Este comando muestra los activadores de todas las ubicaciones e incluye detalles como nombres, tipos, destinos y estados.

Siguientes pasos