Ejecutar un trabajo de Cloud Run que procese datos de eventos guardados en Cloud Storage

---

Puedes usar Workflows para ejecutar un Trabajo de Cloud Run como parte de un flujo de trabajo que realiza procesamientos de datos más complejos u organiza un sistema de trabajos existentes.

En este instructivo, se muestra cómo usar Workflows para ejecutar un Trabajo de Cloud Run que procesa datos de eventos almacenados en un bucket de Cloud Storage. Almacenar la carga útil del evento en un bucket de Cloud Storage te permite encriptar los datos con claves de encriptación administradas por el cliente, lo que no es posible si pasas los datos del evento como variables de entorno a la tarea de Cloud Run.

En el siguiente diagrama, se proporciona una descripción general de alto nivel:

Objetivos

En este instructivo, realizarás las siguientes acciones:

1. Crear un trabajo de Cloud Run que procese datos de eventos almacenados en un bucket de Cloud Storage.
2. Implementa un flujo de trabajo que haga lo siguiente:
   1. Recibe un evento como argumento.
   2. Escribe los datos de la carga útil del evento en el bucket de Cloud Storage.
   3. Usa el conector de la API de Cloud Run Admin para ejecutar la tarea de Cloud Run.
3. Crea un tema de Pub/Sub para poder publicar un mensaje en él. En este instructivo, se usa un evento de Pub/Sub como ejemplo de cómo enrutar eventos con Workflows y guardarlos en Cloud Storage para que un trabajo de Cloud Run pueda procesar los datos del evento.
4. Crea un activador de Eventarc que ejecute el flujo de trabajo cuando se escriba un mensaje en el tema de Pub/Sub.
5. Para activar el flujo de trabajo, escribe un mensaje en el tema de Pub/Sub.

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

• Artifact Registry
• Cloud Build
• Cloud Run
• Cloud Storage
• Eventarc
• Workflows

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios. Es posible que los usuarios nuevos de Google Cloud califiquen para obtener una prueba gratuita.

Antes de comenzar

Es posible que las restricciones de seguridad que define tu organización no te permitan completar los siguientes pasos. Para obtener información sobre la solución de problemas, consulta Desarrolla aplicaciones en un entorno de Google Cloud restringido.

Antes de comenzar este instructivo, debes habilitar APIs específicas y crear una cuenta de servicio administrada por el usuario. Debes otorgarle a la cuenta de servicio los roles y permisos necesarios para que puedas enrutar eventos con un activador de Eventarc y ejecutar un flujo de trabajo.

Ten en cuenta que, si usas Cloud Shell para probar este instructivo, es posible que debas otorgar roles adicionales a la cuenta de servicio predeterminada de Compute Engine. Para obtener más información, consulta la sección Crea un trabajo de Cloud Run en este documento.

Console

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Artifact Registry, Cloud Build, Cloud Run, Cloud Storage, Compute Engine, Eventarc, and Workflows APIs.

   Enable the APIs

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Cloud Run Admin, Eventarc Event Receiver, Logs Writer, Storage Object Creator, Workflows Invoker.

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. Make sure that billing is enabled for your Google Cloud project.

8. Enable the Artifact Registry, Cloud Build, Cloud Run, Cloud Storage, Compute Engine, Eventarc, and Workflows APIs.

   Enable the APIs

9. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Cloud Run Admin, Eventarc Event Receiver, Logs Writer, Storage Object Creator, Workflows Invoker.

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

10. Si habilitaste el agente de servicio de Cloud Pub/Sub el 8 de abril de 2021 o antes de esa fecha, para admitir las solicitudes de envío de Pub/Sub autenticadas, otorga el rol de creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) al agente de servicio. De lo contrario, esta función se otorga de forma predeterminada:
    1. En la consola de Google Cloud, ve a IAM.
       

       Ir a IAM

    2. Selecciona la casilla de verificación Incluir asignaciones de roles proporcionadas por Google.
    3. En la columna Nombre, busca la Cuenta de servicio de Cloud Pub/Sub y, luego, haz clic en Editar principal en la fila correspondiente.
    4. Haz clic en Agregar rol o Agregar otro rol.
    5. En la lista Seleccionar un rol, filtra por Creador de tokens de cuenta de servicio y, luego, selecciona el rol.
    6. Haz clic en Guardar.

11. 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.

Cloud Shell es compatible con los pasos de la línea de comandos de este instructivo.

gcloud

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Artifact Registry, Cloud Build, Cloud Run, Cloud Storage, Compute Engine, Eventarc, and Workflows APIs:

   gcloud services enable artifactregistry.googleapis.com cloudbuild.googleapis.com compute.googleapis.com run.googleapis.com storage.googleapis.com eventarc.googleapis.com workflows.googleapis.com

7. Set up authentication:

   1. Create the service account:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Replace SERVICE_ACCOUNT_NAME with a name for the service account.

   2. Grant roles to the service account. Run the following command once for each of the following IAM roles: roles/eventarc.eventReceiver, roles/logging.logWriter, roles/run.admin, roles/storage.objectCreator, roles/workflows.invoker :

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=ROLE

      Replace the following:

      • SERVICE_ACCOUNT_NAME: the name of the service account
      • PROJECT_ID: the project ID where you created the service account
      • ROLE: the role to grant
      Note: The --role flag affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

10. Create or select a Google Cloud project.

    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

11. Make sure that billing is enabled for your Google Cloud project.

12. Enable the Artifact Registry, Cloud Build, Cloud Run, Cloud Storage, Compute Engine, Eventarc, and Workflows APIs:

    gcloud services enable artifactregistry.googleapis.com cloudbuild.googleapis.com compute.googleapis.com run.googleapis.com storage.googleapis.com eventarc.googleapis.com workflows.googleapis.com

13. Set up authentication:

    1. Create the service account:

       gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

       Replace SERVICE_ACCOUNT_NAME with a name for the service account.

    2. Grant roles to the service account. Run the following command once for each of the following IAM roles: roles/eventarc.eventReceiver, roles/logging.logWriter, roles/run.admin, roles/storage.objectCreator, roles/workflows.invoker :

       gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=ROLE

       Replace the following:

       • SERVICE_ACCOUNT_NAME: the name of the service account
       • PROJECT_ID: the project ID where you created the service account
       • ROLE: the role to grant
       Note: The --role flag affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
14. Si habilitaste el agente de servicio de Cloud Pub/Sub el 8 de abril de 2021 o antes de esa fecha, para admitir las solicitudes de envío de Pub/Sub autenticadas, otorga el rol de creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) al agente de servicio. De lo contrario, este rol se otorga de forma predeterminada:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member=serviceAccount:[e-mail] \
        --role=roles/iam.serviceAccountTokenCreator

Reemplaza PROJECT_NUMBER por el número de proyecto de Google Cloud. Para encontrar el número del proyecto, ve a la página de bienvenida de la consola de Google Cloud o ejecuta el siguiente comando:

gcloud projects describe PROJECT_ID --format='value(projectNumber)'

Crea un trabajo de Cloud Run

En este instructivo, se usa código de muestra que puedes encontrar en GitHub. El objeto Deployment crea una imagen de contenedor para crear un trabajo de Cloud Run. La secuencia de comandos también crea un bucket de Cloud Storage. El El trabajo de Cloud Run lee todos los datos de eventos almacenados en el bucket de Cloud Storage y, luego, imprime los datos del evento.

1. Si ejecutas la secuencia de comandos de implementación en Cloud Shell y la cuenta de servicio predeterminada de Compute Engine no tiene el rol de editor, otorga los siguientes roles en el proyecto a la cuenta de servicio predeterminada de Compute Engine. (De lo contrario, puedes omitir este y continuaremos con la clonación del repositorio de la app de ejemplo en el paso siguiente).

   Nota: La iam.automaticIamGrantsForDefaultServiceAccounts de la política de la organización impide que el rol de Editor automáticamente a cuentas de servicio predeterminadas. Si creaste tu organización después del 3 de mayo de 2024, esta restricción se aplicará de forma predeterminada.

   1. Otorga el Función de escritor de Artifact Registry (roles/artifactregistry.writer):

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:[e-mail] \
          --role=roles/artifactregistry.writer

      Reemplaza PROJECT_NUMBER por el número de proyecto de Google Cloud. Para encontrar el número del proyecto, ve a la página de bienvenida de la consola de Google Cloud o ejecuta el siguiente comando:

      gcloud projects describe PROJECT_ID --format='value(projectNumber)'

   2. Otorga el rol de usuario de objetos de almacenamiento (roles/storage.objectUser):

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:[e-mail] \
          --role=roles/storage.objectUser

   3. Otorga el rol de escritor de registros de Logging (roles/logging.logWriter):

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:[e-mail] \
          --role=roles/logging.logWriter

2. Clona el repositorio de la app de ejemplo en tu local para obtener el código máquina virtual:

   git clone https://github.com/GoogleCloudPlatform/workflows-demos.git

   Como alternativa, puedes descarga la muestra como un archivo ZIP

3. Dirígete al directorio que contiene el código de muestra:

   cd workflows-demos/cloud-run-jobs-payload-gcs/message-payload-job

4. Ejecuta la secuencia de comandos de implementación para crear el trabajo de Cloud Run:

   ./deploy-job.sh

La secuencia de comandos crea un bucket de Cloud Storage con el nombre message-payload-PROJECT_ID, donde PROJECT_ID es el ID de tu proyecto de Google Cloud. También se crea un trabajo de Cloud Run llamado message-payload-job.

Implementa un flujo de trabajo que ejecute el trabajo de Cloud Run

Define e implementa un flujo de trabajo que ejecute el trabajo de Cloud Run que acabas de crear. La definición de un flujo de trabajo está compuesta por una serie de pasos descritos con la sintaxis de Workflows.

El flujo de trabajo recibe un evento, guarda sus datos en un bucket de Cloud Storage y, luego, ejecuta un trabajo de Cloud Run para procesarlos.

Console

1. En la consola de Google Cloud, ve a la página Flujos de trabajo:

   Ir a Workflows

2. Haz clic en Crear.

3. Ingresa un nombre para el flujo de trabajo nuevo, como message-payload-workflow.

4. Elige una región adecuada. por ejemplo, us-central1.

5. En el campo Cuenta de servicio, selecciona la cuenta de servicio que creaste antes.

   La cuenta de servicio funciona como la identidad del flujo de trabajo. Deberías tener ya otorgaste los siguientes roles a la cuenta de servicio:

   • Administrador de Cloud Run: Para ejecutar trabajos de Cloud Run
   • Escritor de registros: Para escribir entradas de registro
   • Creador de objetos de Storage: Para crear objetos en Cloud Storage

6. Haz clic en Siguiente.

7. En el editor de flujos de trabajo, ingresa la siguiente definición para tu flujo de trabajo:

   main:
       params: [event]
       steps:
           - init:
               assign:
                   - project_id: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
                   - event_bucket: ${"message-payload-" + project_id}
                   - event_file: ${event.id + ".data.json"}
                   - job_name: message-payload-job
                   - job_location: us-central1
           - log_event:
               call: sys.log
               args:
                   data: ${event}
           - write_payload_to_gcs:
               call: http.post
               args:
                   url: ${"https://storage.googleapis.com/upload/storage/v1/b/" + event_bucket + "/o"}
                   auth:
                       type: OAuth2
                   query:
                       name: ${event_file}
                   body:
                       ${event.data}
           - run_job_to_process_payload:
               call: googleapis.run.v1.namespaces.jobs.run
               args:
                   name: ${"namespaces/" + project_id + "/jobs/" + job_name}
                   location: ${job_location}
                   body:
                       overrides:
                           containerOverrides:
                               env:
                                   - name: INPUT_BUCKET
                                     value: ${event_bucket}
                                   - name: INPUT_FILE
                                     value: ${event_file}
               result: job_execution
           - finish:
               return: ${job_execution}

8. Haz clic en Implementar.

gcloud

1. Crea un archivo de código fuente para tu flujo de trabajo:

   touch message-payload-workflow.yaml

2. Copia la siguiente definición de flujo de trabajo en message-payload-workflow.yaml:

   main:
       params: [event]
       steps:
           - init:
               assign:
                   - project_id: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
                   - event_bucket: ${"message-payload-" + project_id}
                   - event_file: ${event.id + ".data.json"}
                   - job_name: message-payload-job
                   - job_location: us-central1
           - log_event:
               call: sys.log
               args:
                   data: ${event}
           - write_payload_to_gcs:
               call: http.post
               args:
                   url: ${"https://storage.googleapis.com/upload/storage/v1/b/" + event_bucket + "/o"}
                   auth:
                       type: OAuth2
                   query:
                       name: ${event_file}
                   body:
                       ${event.data}
           - run_job_to_process_payload:
               call: googleapis.run.v1.namespaces.jobs.run
               args:
                   name: ${"namespaces/" + project_id + "/jobs/" + job_name}
                   location: ${job_location}
                   body:
                       overrides:
                           containerOverrides:
                               env:
                                   - name: INPUT_BUCKET
                                     value: ${event_bucket}
                                   - name: INPUT_FILE
                                     value: ${event_file}
               result: job_execution
           - finish:
               return: ${job_execution}

3. Para implementar el flujo de trabajo, ingresa el siguiente comando:

   gcloud workflows deploy message-payload-workflow \
       --location=us-central1 \
       --source=message-payload-workflow.yaml \
       --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

   Reemplaza lo siguiente:

   • SERVICE_ACCOUNT_NAME: Es el nombre de la cuenta de servicio que creaste anteriormente
   • PROJECT_ID: Es el ID de tu Proyecto de Google Cloud

   La cuenta de servicio funciona como la identidad del flujo de trabajo. Ya deberías haber otorgado los siguientes roles a la cuenta de servicio:

   • roles/logging.logWriter: Se usa para escribir entradas de registro.
   • roles/run.admin: Para ejecutar trabajos de Cloud Run
   • roles/storage.objectCreator: Para crear objetos en Cloud Storage

El flujo de trabajo hace lo siguiente:

1. Paso init: Acepta un evento como argumento y establece las variables necesarias.

2. Paso log_event: Crea una entrada de registro en Cloud Logging con la función. sys.log.

3. Paso write_payload_to_gcs: Hace una solicitud HTTP POST y escribe el evento. de datos de carga útil a un archivo de bucket de Cloud Storage.

4. Paso run_job_to_process_payload: Usa el método del conector de la API de Administrador de Cloud Run, googleapis.run.v1.namespaces.jobs.run, para ejecutar la tarea. El bucket de Cloud Storage y el nombre del archivo de datos se pasan como variables de anulación del flujo de trabajo al trabajo.

5. Paso finish: muestra información sobre la ejecución del trabajo como resultado de el flujo de trabajo.

Crea un tema de Pub/Sub

Crea un tema de Pub/Sub para poder publicar un mensaje en él. Se usa un evento de Pub/Sub para demostrar cómo enrutar un evento con Workflows y guardarlo en Cloud Storage para que un trabajo de Cloud Run pueda procesar los datos del evento.

Console

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

   Ir a temas

2. Haz clic en Crear tema.

3. En el campo ID del tema, ingresa un ID para el tema, como message-payload-topic

4. Mantén la opción Agregar una suscripción predeterminada.

5. No selecciones las otras opciones.

6. Haz clic en Crear.

gcloud

Para crear un tema con el ID message-payload-topic, ejecuta el siguiente comando: gcloud pubsub topics create :

gcloud pubsub topics create message-payload-topic

Crea un activador de Eventarc para enrutar eventos al flujo de trabajo

Para ejecutar automáticamente el flujo de trabajo y, a su vez, el trabajo de Cloud Run, crea un activador de Eventarc que responda a los eventos de Pub/Sub y que dirija los eventos al flujo de trabajo. Cada vez que se escribe un mensaje en el tema de Pub/Sub, el evento activa una ejecución del flujo de trabajo.

Console

1. En la consola de Google Cloud, ve a la página Flujos de trabajo:

   Ir a Workflows

2. Haz clic en el nombre de tu flujo de trabajo, como message-payload-workflow.

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

4. En la página Editar flujo de trabajo, en la sección Activadores, Haz clic en Agregar activador nuevo > Eventarc.

   Se abrirá el panel Evento de Eventarc.

5. En el campo Nombre del activador, ingresa un nombre para el activador, como message-payload-trigger

6. En la lista Proveedor de eventos, selecciona Cloud Pub/Sub.

7. En la lista Evento, selecciona google.cloud.pubsub.topic.v1.messagePublished

8. Desde la lista Selecciona un tema de Cloud Pub/Sub, elige el tema de Pub/Sub que creaste anteriormente.

9. En el campo Cuenta de servicio, selecciona la cuenta de servicio que creaste antes.

   La cuenta de servicio funciona como la identidad del activador. Deberías tener ya otorgaste los siguientes roles a la cuenta de servicio:

   • Receptor de eventos de Eventarc: Para recibir eventos
   • Invocador de flujos de trabajo: Para ejecutar flujos de trabajo

10. Haz clic en Guardar activador.

    El activador de Eventarc ahora aparece en la sección Activadores de la página Editar flujo de trabajo.

11. Haz clic en Siguiente.

12. Haz clic en Implementar.

gcloud

Para crear un activador de Eventarc, ejecuta el siguiente comando:

gcloud eventarc triggers create message-payload-trigger \
    --location=us-central1 \
    --destination-workflow=message-payload-workflow \
    --destination-workflow-location=us-central1 \
    --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
    --transport-topic=projects/PROJECT_ID/topics/message-payload-topic \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Reemplaza lo siguiente:

• PROJECT_IDEl ID de tu proyecto de Google Cloud.
• SERVICE_ACCOUNT_NAME: Es el nombre del servicio. cuenta que creaste anteriormente.

La cuenta de servicio funciona como la identidad del activador. Deberías tener ya otorgaste los siguientes roles a la cuenta de servicio:

• roles/eventarc.eventReceiver: Para recibir eventos
• roles/workflows.invoker: Para ejecutar flujos de trabajo

Activa el flujo de trabajo

Prueba el sistema de extremo a extremo mediante la publicación de un mensaje en Pub/Sub y generar un evento. Para obtener más información, consulta Activar un flujo de trabajo con eventos o mensajes de Pub/Sub.

1. Publica un mensaje en el tema de Pub/Sub para generar un evento:

   gcloud pubsub topics publish message-payload-topic --message="Hello World"
   

   El evento se enruta al flujo de trabajo que registra el mensaje del evento y guarda datos de eventos al bucket de Cloud Storage y ejecuta el trabajo de Cloud Run para procesar los datos guardados en en Google Cloud Storage. Este proceso puede tardar un minuto.

2. Para confirmar que el trabajo de Cloud Run se haya ejecutado según lo esperado, consulta las ejecuciones del trabajo:

   gcloud run jobs executions list --job=message-payload-job

   Deberías ver una nueva ejecución de trabajo en el resultado.

3. Para ver las entradas de registro relacionadas con eventos creadas mediante la activación del flujo de trabajo, ejecuta el siguiente comando:

   gcloud logging read "resource.type=cloud_run_job AND textPayload:Payload"
   

4. Busca una entrada de registro similar a lo siguiente:

   textPayload: "Payload: {'message': {'data': 'SGVsbG8gV29ybGQ=', 'messageId': '8834108235224238',\
   \ 'publishTime': '2023-09-20T17:07:52.921Z'}, 'subscription': 'projects/MY_PROJECT/subscriptions/eventarc-us-central1-message-payload-trigger-sub-741'}"
   ...
   resource:
   labels:
     job_name: message-payload-job
     location: us-central1
     project_id: MY_PROJECT
   type: cloud_run_job
   textPayload: Processing message payload gs://message-payload-MY_PROJECT/8254002311197919.data.json
   

5. Puedes confirmar que los resultados son los esperados viendo los datos de eventos en el objeto del bucket de Cloud Storage.

   1. Recupera el nombre de tu bucket:

      gcloud storage ls

      El resultado es similar a este:

      gs://message-payload-PROJECT_ID/

   2. Enumera los objetos de tu bucket:

      gcloud storage ls gs://message-payload-PROJECT_ID/** --recursive

      El resultado debería ser similar al siguiente ejemplo:

      gs://message-payload-PROJECT_ID/OBJECT_ID.data.json

      Toma nota de OBJECT_ID para usar en el siguiente paso.

   3. Descarga el objeto en el bucket como un archivo:

      gcloud storage cp gs://message-payload-PROJECT_ID/OBJECT_ID.data.json message-event.txt

      Reemplaza OBJECT_ID por el ID que se mostró en el paso anterior.

   4. En un editor de texto, abre el archivo message-event.txt. El cuerpo del evento escrito en el archivo debería ser similar al siguiente:

      {
        "message": {
          "data": "SGVsbG8gV29ybGQ=",
          "messageId": "8254002311197919",
          "publishTime": "2023-09-20T16:54:29.312Z"
        },
        "subscription": "projects/MY_PROJECT/subscriptions/eventarc-us-central1-message-payload-trigger-sub-741"
      }
      

      Ten en cuenta que, si decodificas el valor de datos de SGVsbG8gV29ybGQ= de su Formato Base64, “Hello World” el resultado.

Limpia

Si creaste un proyecto nuevo para este instructivo, bórralo. Si usaste un proyecto existente y deseas conservarlo sin los cambios que se agregaron en este instructivo, borra los recursos creados para el instructivo.

Borra el proyecto

La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.

Para borrar el proyecto, haz lo siguiente:

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varias infraestructuras, instructivos y guías de inicio rápido la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Elimina recursos de instructivos

Borra los recursos que creaste en este instructivo:

1. Borra el tema de Pub/Sub.

2. Borrar el activador de Eventarc.

3. Borra el flujo de trabajo de Workflows.

4. Borra el trabajo de Cloud Run.

5. Borra el depósito de Cloud Storage

¿Qué sigue?

• Obtén más información sobre los trabajos de Cloud Run.
• Obtén más información sobre los conectores de Workflows.
• Obtén más información sobre Workflows.