Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Crea un activador mediante Registros de auditoría de Cloud y la consola de Google Cloud

En esta guía de inicio rápido, se muestra cómo recibir eventos directos de Cloud Storage en un servicio de Cloud Run no autenticado.

Puedes completar esta guía de inicio rápido con la consola de Google Cloud. Para obtener instrucciones sobre cómo usar Google Cloud CLI, consulta Recibe eventos mediante los registros de auditoría de Cloud (CLI de gcloud).

En esta guía de inicio rápido, podrás hacer lo siguiente:

  1. Crear un bucket de Cloud Storage para que sea una fuente del evento

  2. Implementar un servicio del receptor de eventos en Cloud Run

  3. Crear un activador de Eventarc para filtrar y enrutar los eventos

  4. Generar un evento mediante la carga de un archivo al bucket de Cloud Storage y visualizarlo en los registros de Cloud Run.


Para obtener una guía paso a paso sobre esta tarea directamente en la consola de Google Cloud haz clic en Guiarme:

GUIARME


En las siguientes secciones, se explican los mismos pasos que cuando se hace clic en Guiarme.

Antes de comenzar

Algunos de los pasos de este documento podrían no funcionar correctamente si tu organización aplica restricciones a tu entorno de Google Cloud. En ese caso, es posible que no puedas completar tareas como crear direcciones IP públicas o claves de cuenta de servicio. Si realizas una solicitud que muestra un error sobre las restricciones, consulta cómo desarrollar aplicaciones en un entorno restringido de Google Cloud.

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  4. Habilita las API de Cloud Build and Eventarc.

    Habilita las API

  5. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  6. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  7. Habilita las API de Cloud Build and Eventarc.

    Habilita las API

Cree un bucket de Cloud Storage

En esta guía de inicio rápido, se usa Cloud Storage como la fuente del evento.

  1. En la consola de Google Cloud ve a Cloud Storage.

    Ir a Cloud Storage

  2. Haz clic en Crear bucket.

    Bucket nuevo.

  3. Ingresa un Nombre único para el bucket. Por ejemplo, helloworld-bucket

  4. Haga clic en Continuar.

  5. En Tipo de ubicación, selecciona Región y, luego, us-central1 (Iowa).

  6. Acepta los otros valores predeterminados.

  7. Haz clic en Crear.

Después de crear la fuente del evento, puedes implementar el servicio del receptor de eventos en Cloud Run.

Implementa el servicio del receptor de eventos en Cloud Run

Implementa un servicio de Cloud Run que reciba y registre eventos.

  1. Bifurca el repositorio de muestra en tu cuenta de GitHub:

    Comienza a usarlo

    1. En GitHub, navega hasta GoogleCloudPlatform/golang-samples.

    2. Haz clic en Bifurcar.

      Captura de pantalla del botón de bifurcación

    3. Si se te solicita, selecciona la ubicación en la que deseas bifurcar el repositorio.

    Java

    1. En GitHub, navega hasta GoogleCloudPlatform/java-docs-samples.

    2. Haz clic en Bifurcar.

      Captura de pantalla del botón de bifurcación

    3. Si se te solicita, selecciona la ubicación en la que deseas bifurcar el repositorio.

    .NET

    1. En GitHub, navega hasta GoogleCloudPlatform/dotnet-docs-samples.

    2. Haz clic en Bifurcar.

      Captura de pantalla del botón de bifurcación

    3. Si se te solicita, selecciona la ubicación en la que deseas bifurcar el repositorio.

    Node.js

    1. En GitHub, navega hasta GoogleCloudPlatform/nodejs-docs-samples.

    2. Haz clic en Bifurcar.

      Captura de pantalla del botón de bifurcación

    3. Si se te solicita, selecciona la ubicación en la que deseas bifurcar el repositorio.

    Python

    1. En GitHub, navega hasta GoogleCloudPlatform/python-docs-samples.

    2. Haz clic en Bifurcar.

      Captura de pantalla del botón de bifurcación

    3. Si se te solicita, selecciona la ubicación en la que deseas bifurcar el repositorio.

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

    Ir a Cloud Run

  3. Haz clic en Crear servicio.

  4. En el formulario Crear servicio, selecciona Implementar continuamente nuevas revisiones desde un repositorio de código fuente.

  5. Haz clic en Configuración con Cloud Build (Set up with Cloud Build).

  6. En el formulario Configurar con Cloud Build, completa los siguientes pasos:

    Página Configurar con Cloud Build

    1. Si se te solicita, habilita la API de Cloud Build.
    2. En la lista Proveedor del repositorio, selecciona GitHub.

    3. En la lista Repositorio, selecciona el repositorio de GitHub que bifurcaste.

    4. Una vez que hayas seleccionado tu cuenta y repositorio de GitHub, selecciona la casilla de verificación para aceptar los términos de la renuncia de responsabilidad de consentimiento y, luego, haz clic en Siguiente.

    5. Deja el campo Rama como ^main$.

    6. En Tipo de compilación, selecciona Dockerfile y proporciona la ubicación de origen del Dockerfile:

      eventarc/audit-storage/Dockerfile
      

      O bien, para el ejemplo de Go:

      eventarc/audit_storage/Dockerfile
      
    7. Haz clic en Guardar.

  7. En el formulario Crear servicio, escribe un nombre de servicio. Por ejemplo, helloworld-events

  8. Acepta la Región predeterminada como la ubicación de tu servicio, por ejemplo, us-central1(Iowa).

  9. Acepta los valores predeterminados de Precios y asignación de CPU y Ajuste de escala automático.

  10. En la sección Ingress, selecciona Permitir todo el tráfico.

  11. En la sección Autenticación, selecciona Permitir invocaciones no autenticadas.

  12. Haz clic en Crear.

Crea un activador de Eventarc

El activador de Eventarc enviará eventos desde el bucket de Cloud Storage al servicio helloworld-events de Cloud Run.

  1. En la consola de Google Cloud, ve a Eventarc.

    Ve a Eventarc

  2. Haz clic en Crear activador.

  3. Escribe un nombre de activador.

    Por ejemplo, helloworld-trigger.

  4. En la lista Proveedor del evento, selecciona Fuentes de Google > Cloud Storage.

  5. En la lista Evento, selecciona Directo > google.cloud.storage.object.v1.finalized.

  6. Para Bucket, especifica el bucket helloworld-bucket de Cloud Storage que creaste antes.

  7. Si se te solicita, otorga lo siguiente:

    • El rol iam.serviceAccountTokenCreator en la cuenta de servicio de Pub/Sub
    • El role pubsub.publisher a la cuenta de servicio de Cloud Storage
  8. Usa la Cuenta de servicio predeterminada de Compute como la cuenta de servicio que invoca el servicio.

  9. En la lista Destino del evento, selecciona Cloud Run.

  10. Para el servicio de Cloud Run, selecciona el servicio helloworld-events que creaste antes.

  11. Haz clic en Crear.

Genera y visualiza un evento

Genera un evento y confirma que el activador de Eventarc funcione según lo esperado.

  1. Para generar un evento, haz lo siguiente:

    1. Crea un archivo de texto con el nombre random.txt y el texto "Hello World".

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

      Ir a Cloud Storage

    3. Haz clic en el nombre del bucket de almacenamiento que creaste.

    4. En la pestaña Objetos, haz clic en Subir archivos y sube el archivo random.txt.

    La carga genera un evento y el servicio de Cloud Run registra el mensaje del evento.

  2. Sigue estos pasos para ver la entrada de registro:

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

      Ir a Cloud Run

    2. Haz clic en el nombre del servicio que creaste.

    3. Para recuperar las entradas de registro de todas las revisiones del servicio, haz clic en la pestaña Registros en la página Detalles del servicio. Puedes filtrar por nivel de gravedad del registro

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

      Received event of type google.cloud.storage.object.v1.finalized. Event data: [...]

¡Felicitaciones! Implementaste un servicio de receptor de eventos en Cloud Run de forma correcta, creaste un activador de Eventarc, generaste un evento desde Cloud Storage y lo viste en los registros de Cloud Run.

Limpia

Si bien Cloud Run no cobra cuando el servicio no se usa, es posible que se te cobre por almacenar la imagen del contenedor en Container Registry, por los recursos de Cloud Run, y por almacenar archivos en el bucket de Cloud Storage.

Puedes borrar tu imagen, borrar tu bucket de almacenamiento y borrar tu servicio.

Para borrar el activador de Eventarc, sigue estos pasos:

  1. En la consola de Google Cloud, ve a Eventarc.

    Ve a Eventarc

  2. Haz clic en el nombre del activador que creaste.

  3. En la página Detalles de los activadores, haz clic en Borrar.

Como alternativa, puedes borrar el proyecto de Cloud para evitar que se generen cargos. Si borras el proyecto de Cloud, se dejan de facturar todos los recursos que usaste en ese proyecto.

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

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

¿Qué sigue?