Instructivo de Cloud Storage

En este sencillo instructivo, se demuestra cómo escribir, implementar y activar una función de Cloud Functions en segundo plano con un activador de Cloud Storage.

Objetivos

Costos

Este instructivo usa componentes facturables de Cloud Platform, incluidos los siguientes:

  • Google Cloud Functions
  • Google Cloud Storage

Usa la calculadora de precios para generar una estimación de los costos según el uso previsto.

Los usuarios nuevos de Cloud Platform pueden ser aptos para una prueba gratuita.

Antes de comenzar

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. Select or create a Google Cloud Platform project.

    Go to the Manage resources page

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. {% dynamic if "no_credentials" in setvar.task_params %} {% dynamic setvar credential_type %}NO_AUTH{% dynamic endsetvar %} {% dynamic if not setvar.redirect_url %} {% dynamic setvar redirect_url %}https://console.cloud.google.com{% dynamic endsetvar %} {% dynamic endif %}{% dynamic endif %} {% dynamic if setvar.in_henhouse_no_auth_whitelist %} {% dynamic if not setvar.credential_type %}{% dynamic setvar credential_type %}NO_AUTH{% dynamic endsetvar %} {% dynamic endif %} {% dynamic elif setvar.in_henhouse_service_account_whitelist %} {% dynamic if not setvar.credential_type %}{% dynamic setvar credential_type %}SERVICE_ACCOUNT{% dynamic endsetvar %} {% dynamic endif %}{% dynamic endif %} {% dynamic if not setvar.service_account_roles and setvar.credential_type == "SERVICE_ACCOUNT" %} {% dynamic setvar service_account_roles %} {% dynamic endsetvar %} {% dynamic endif %} {% dynamic setvar console %} {% dynamic if "no_steps" not in setvar.task_params %}
  5. {% dynamic endif %} {% dynamic if setvar.api_list %} {% dynamic if setvar.in_henhouse_no_auth_whitelist or setvar.in_henhouse_service_account_whitelist %} Configurar un proyecto de GCP Console.

    Configurar un proyecto

    Haz clic para realizar alguna de las siguientes acciones:

    • Crear o seleccionar un proyecto.
    • Habilitar las {% dynamic if setvar.api_names %}{% dynamic print setvar.api_names %}{% dynamic else %}{% dynamic endif %}{% dynamic if "," in setvar.api_list %} API{% dynamic elif "API" in setvar.api_names %}{% dynamic else %} API{% dynamic endif %} necesarias para el proyecto.
    • {% dynamic if setvar.credential_type == 'SERVICE_ACCOUNT' %}
    • Crear una cuenta de servicio.
    • Descargar una clave privada como JSON.
    • {% dynamic endif %}

    Puedes visualizar y administrar estos recursos en GCP Console en cualquier momento.

    {% dynamic else %}{% dynamic if "no_text" not in setvar.task_params %} Habilita las {% dynamic if setvar.api_names %}{% dynamic print setvar.api_names %}{% dynamic else %}{% dynamic endif %}{% dynamic if "," in setvar.api_list %} API{% dynamic elif "API" in setvar.api_names %}{% dynamic else %} API{% dynamic endif %} necesarias. {% dynamic endif %}

    Habilita las {% dynamic if "," in setvar.api_list %} API{% dynamic else %} API{% dynamic endif %}

    {% dynamic endif %}{% dynamic endif %}{% dynamic if "no_steps" not in setvar.task_params %}
  6. {% dynamic endif %}{% dynamic endsetvar %}{% dynamic print setvar.console %}
  7. Install and initialize the Cloud SDK.
  8. Actualiza y, luego, instala los componentes de gcloud:

    Node.js 6

    gcloud components update

    Node.js 8 (Beta)

    gcloud components update &&
    gcloud components install beta

    Python (Beta)

    gcloud components update &&
    gcloud components install beta

    Go (Beta)

    gcloud components update &&
    gcloud components install beta
  9. Prepara tu entorno de programación:

Prepara la aplicación

  1. Crea un depósito de Cloud Storage para subir un archivo de prueba, en el que YOUR_TRIGGER_BUCKET_NAME es un nombre de depósito único a nivel global:

    gsutil mb gs://YOUR_TRIGGER_BUCKET_NAME
    
  2. Clona el repositorio de la app de muestra en tu máquina local:

    Node.js 6

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

    De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.

    Node.js 8 (Beta)

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

    De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.

    Python (Beta)

    git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

    De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.

    Go (Beta)

    git clone https://github.com/GoogleCloudPlatform/golang-samples.git

    De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.

  3. Ve al directorio que contiene el código de muestra de Cloud Functions, como sigue:

    Node.js 6

    cd nodejs-docs-samples/functions/helloworld/

    Node.js 8 (Beta)

    cd nodejs-docs-samples/functions/node8/

    Python (Beta)

    cd python-docs-samples/functions/gcs/

    Go (Beta)

    cd golang-samples/functions/helloworld/storage_generic/

Implementa y activa la función

Actualmente, las funciones de Cloud Storage se basan en notificaciones de Pub/Sub desde Cloud Storage y admiten tipos de eventos similares:

En las siguientes secciones, se describe cómo implementar y activar una función para cada uno de estos tipos de eventos.

Finalización del objeto

Los eventos de finalización del objeto se activan cuando una operación de “escritura” de un objeto de Cloud Storage se finaliza correctamente. En particular, esto significa que crear un objeto nuevo o sobrescribir uno existente activa este evento. Este activador ignora las operaciones de actualización de archivo y metadatos.

Finalización del objeto: Implementa la función

Consulta la función de muestra que maneja los eventos de Cloud Storage:

Node.js 6

/**
 * Generic background Cloud Function to be triggered by Cloud Storage.
 *
 * @param {object} event The Cloud Functions event.
 * @param {function} callback The callback function.
 */
exports.helloGCSGeneric = (event, callback) => {
  const file = event.data;

  console.log(`  Event: ${event.eventId}`);
  console.log(`  Event Type: ${event.eventType}`);
  console.log(`  Bucket: ${file.bucket}`);
  console.log(`  File: ${file.name}`);
  console.log(`  Metageneration: ${file.metageneration}`);
  console.log(`  Created: ${file.timeCreated}`);
  console.log(`  Updated: ${file.updated}`);

  callback();
};

Según la configuración predeterminada, Cloud Functions busca tu código en un archivo llamado index.js.

Node.js 8 (Beta)

/**
 * Generic background Cloud Function to be triggered by Cloud Storage.
 *
 * @param {object} data The event payload.
 * @param {object} context The event metadata.
 */
exports.helloGCSGeneric = (data, context) => {
  const file = data;
  console.log(`  Event ${context.eventId}`);
  console.log(`  Event Type: ${context.eventType}`);
  console.log(`  Bucket: ${file.bucket}`);
  console.log(`  File: ${file.name}`);
  console.log(`  Metageneration: ${file.metageneration}`);
  console.log(`  Created: ${file.timeCreated}`);
  console.log(`  Updated: ${file.updated}`);
};

Según la configuración predeterminada, Cloud Functions busca tu código en un archivo llamado index.js.

Python (Beta)

def hello_gcs_generic(data, context):
    """Background Cloud Function to be triggered by Cloud Storage.
       This generic function logs relevant data when a file is changed.

    Args:
        data (dict): The Cloud Functions event payload.
        context (google.cloud.functions.Context): Metadata of triggering event.
    Returns:
        None; the output is written to Stackdriver Logging
    """

    print('Event ID: {}'.format(context.event_id))
    print('Event type: {}'.format(context.event_type))
    print('Bucket: {}'.format(data['bucket']))
    print('File: {}'.format(data['name']))
    print('Metageneration: {}'.format(data['metageneration']))
    print('Created: {}'.format(data['timeCreated']))
    print('Updated: {}'.format(data['updated']))

Cloud Functions busca tu código en un archivo llamado main.py.

Go (Beta)

// Package helloworld provides a set of Cloud Function samples.
package helloworld

import (
	"context"
	"fmt"
	"log"
	"time"

	"cloud.google.com/go/functions/metadata"
)

// GCSEvent is the payload of a GCS event. Please refer to the docs for
// additional information regarding GCS events.
type GCSEvent struct {
	Bucket         string    `json:"bucket"`
	Name           string    `json:"name"`
	Metageneration string    `json:"metageneration"`
	ResourceState  string    `json:"resourceState"`
	TimeCreated    time.Time `json:"timeCreated"`
	Updated        time.Time `json:"updated"`
}

// HelloGCSInfo prints information about a GCS event.
func HelloGCSInfo(ctx context.Context, e GCSEvent) error {
	meta, err := metadata.FromContext(ctx)
	if err != nil {
		return fmt.Errorf("metadata.FromContext: %v", err)
	}
	log.Printf("Event ID: %v\n", meta.EventID)
	log.Printf("Event type: %v\n", meta.EventType)
	log.Printf("Bucket: %v\n", e.Bucket)
	log.Printf("File: %v\n", e.Name)
	log.Printf("Metageneration: %v\n", e.Metageneration)
	log.Printf("Created: %v\n", e.TimeCreated)
	log.Printf("Updated: %v\n", e.Updated)
	return nil
}

Para implementar la función, ejecuta el siguiente comando en el directorio en el que se ubica el código de muestra:

Node.js 6

gcloud functions deploy helloGCSGeneric --runtime nodejs6 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize

Node.js 8 (Beta)

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize

Python (Beta)

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize

Go (Beta)

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize

en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage que activa la función.

Finalización del objeto: Activa la función

Sigue estos pasos para activar la función:

  1. Crea un archivo gcf-test.txt vacío en el directorio en el que se ubica el código de muestra.

  2. Sube el archivo a Cloud Storage para activar la función:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage al que subirás un archivo de prueba.

  3. Verifica los registros para asegurarte de que las ejecuciones se completaron:

    gcloud functions logs read --limit 50
    

Eliminación del objeto

Los eventos de eliminación del objeto son más útiles para los depósitos sin control de versiones. Se activan cuando se elimina una versión antigua de un objeto. Además, también lo hacen cuando se sobrescribe un objeto. Los activadores de eliminación del objeto también se pueden usar con los depósitos con control de versiones, que se activan cuando la versión de un objeto se borra permanentemente.

Eliminación del objeto: Implementa la función

Con el mismo código de muestra que en el ejemplo de finalización, implementa la función con el evento de eliminación del objeto como su activador. Ejecuta el siguiente comando en el directorio en el que se ubica el código de muestra:

Node.js 6

gcloud functions deploy helloGCSGeneric --runtime nodejs6 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete

Node.js 8 (Beta)

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete

Python (Beta)

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete

Go (Beta)

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete

en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage que activa la función.

Eliminación del objeto: Activa la función

Sigue estos pasos para activar la función:

  1. Crea un archivo gcf-test.txt vacío en el directorio en el que se ubica el código de muestra.

  2. Asegúrate de que tu depósito no tiene control de versiones:

    gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
    
  3. Sube el archivo a Cloud Storage:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage al que subirás un archivo de prueba. En este punto, la función no debería ejecutarse aún.

  4. Borra el archivo para activar la función:

    gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
    
  5. Verifica los registros para asegurarte de que las ejecuciones se completaron:

    gcloud functions logs read --limit 50
    

Ten en cuenta que la función puede tardar algún tiempo en terminar de ejecutarse.

Archivado del objeto

Los eventos de archivado del objeto se pueden usar solo con depósitos con control de versiones. Se activan cuando se archiva una versión antigua de un objeto. En particular, esto significa que cuando un objeto se sobrescribe o borra, se activa un evento de archivado.

Archivado del objeto: Implementa la función

Con el mismo código de muestra que en el ejemplo de finalización, implementa la función con el evento de archivado del objeto como su activador. Ejecuta el siguiente comando en el directorio en el que se ubica el código de muestra:

Node.js 6

gcloud functions deploy helloGCSGeneric --runtime nodejs6 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive

Node.js 8 (Beta)

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive

Python (Beta)

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive

Go (Beta)

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive

en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage que activa la función.

Archivado del objeto: Activa la función

Sigue estos pasos para activar la función:

  1. Crea un archivo gcf-test.txt vacío en el directorio en el que se ubica el código de muestra.

  2. Asegúrate de que tu depósito tiene habilitado el control de versiones:

    gsutil versioning set on gs://YOUR_TRIGGER_BUCKET_NAME
    
  3. Sube el archivo a Cloud Storage:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage al que subirás un archivo de prueba. En este punto, la función no debería ejecutarse aún.

  4. Guarda el archivo para activar la función:

    gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
    
  5. Revisa los registros para asegurarte de que las ejecuciones se completaron:

    gcloud functions logs read --limit 50
    

Actualización de metadatos del objeto

Los eventos de actualización de metadatos del objeto se activan cuando se actualizan los metadatos del objeto existente.

Actualización de metadatos del objeto: Implementa la función

Con el mismo código de muestra que en el ejemplo de finalización, implementa la función con el evento de actualización de metadatos del objeto como su activador. Ejecuta el siguiente comando en el directorio en el que se ubica el código de muestra:

Node.js 6

gcloud functions deploy helloGCSGeneric --runtime nodejs6 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate

Node.js 8 (Beta)

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate

Python (Beta)

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate

Go (Beta)

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate

en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage que activa la función.

Actualización de metadatos del objeto: Activa la función

Sigue estos pasos para activar la función:

  1. Crea un archivo gcf-test.txt vacío en el directorio en el que se ubica el código de muestra.

  2. Asegúrate de que tu depósito no tiene control de versiones:

    gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
    
  3. Sube el archivo a Cloud Storage:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    en el que YOUR_TRIGGER_BUCKET_NAME es el nombre del depósito de Cloud Storage al que subirás un archivo de prueba. En este punto, la función no debería ejecutarse aún.

  4. Actualiza los metadatos del archivo:

    gsutil -m setmeta -h "Content-Type:text/plain" gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
    
  5. Revisa los registros para asegurarte de que las ejecuciones se completaron:

    gcloud functions logs read --limit 50
    

Limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud Platform por los recursos que usaste en este instructivo:

Cómo borrar 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:

  1. In the GCP Console, go to the Projects page.

    Go to the Projects page

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

Borra la función de Cloud Functions

Borrar las funciones de Cloud Functions no quita ningún recurso almacenado en Cloud Storage.

Para borrar la función de Cloud Functions que creaste en este instructivo, ejecuta el siguiente comando:

Node.js

gcloud functions delete helloGCSGeneric 

Python (Beta)

gcloud functions delete hello_gcs_generic 

Go (Beta)

gcloud functions delete HelloGCSInfo 

También puedes borrar las funciones de Cloud Functions desde Google Cloud Platform Console.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Cloud Functions