Configura Google Cloud Storage

Puedes usar un depósito de Cloud Storage para almacenar y entregar archivos, como películas, imágenes y otro tipo de contenido estático. En este documento, se describe cómo configurar tu entorno a fin de usar la biblioteca cliente de App Engine para Cloud Storage.

Configurando el proyecto

Crea un proyecto de Google Cloud y comprende cómo se estructuran las apps de Go 1.11 en App Engine. Escribe y guarda el ID del proyecto para usarlo con tu aplicación.

Activa un bucket de Cloud Storage

Para utilizar Cloud Storage, deberás activar, al menos, un bucket. Te recomendamos que utilices el bucket predeterminado que proporciona los primeros 5 GB de almacenamiento de forma gratuita. Puedes activar y usar otro bucket de Cloud Storage. El bucket predeterminado incluye los primeros 5 GB de almacenamiento sin costo. El bucket predeterminado también incluye una cuota gratuita para operaciones de E/S de Cloud Storage. Consulta Precios, cuotas y límites para obtener más detalles.

Para activar el bucket predeterminado de Cloud Storage en tu aplicación, realiza los siguientes pasos:

  1. Haz clic en Crear en Bucket predeterminado de Cloud Storage desde la página de configuración de App Engine de tu proyecto. Observa que el nombre de este bucket tiene la forma <project-id>.appspot.com.

  2. Si necesitas más espacio de almacenamiento que 5 GB, puedes aumentarlo si habilitas la facturación para el proyecto. De esta forma, obtienes un bucket pago. Se te cobrará por el almacenamiento que supere los 5 GB.

Si deseas activar uno o más depósitos pagos, sigue las instrucciones que se brindan en Crea un depósito para activarlos.

Configura permisos de depósitos y objetos

Puedes obtener información sobre cómo autorizar a la cuenta de servicio de tu app o a otros usuarios para que accedan al bucket de almacenamiento y a su contenido en Configura los permisos del bucket y Configura los permisos de objetos.

Descarga la biblioteca cliente

La biblioteca cliente de App Engine para Cloud Storage está disponible mediante la herramienta go. Para descargar la biblioteca, sigue estos pasos:

  1. Configura el GOPATH si es necesario. Si usas Linux o macOS, puedes configurar GOPATH como se indica a continuación:

    mkdir -p $HOME/go
    export GOPATH=$HOME/go
  2. Descarga los paquetes oauth2, storage y appengine:

    go get -u golang.org/x/oauth2
    go get -u cloud.google.com/go/storage
    go get -u google.golang.org/appengine/...
Para obtener más información sobre cómo instalar la biblioteca cliente, consulta la página Bibliotecas cliente de Cloud Storage.

Utiliza la biblioteca cliente con el servidor de desarrollo para apps

Puedes utilizar la biblioteca cliente con el servidor de desarrollo. Sin embargo, dado que no existe una emulación local de Cloud Storage, todas las solicitudes para leer y escribir archivos deben enviarse a través de Internet a un bucket de Cloud Storage real.

Si deseas usar la biblioteca cliente con el servidor de desarrollo para aplicaciones, realiza los siguientes pasos:

  1. Activa un depósito de Cloud Storage.

  2. Ejecuta dev_appserver.py con la marca --default_gcs_bucket_name [BUCKET_NAME] y reemplaza [BUCKET_NAME] por el nombre del bucket de Cloud Storage que usas.

    Esta marca controla qué bucket se mostrará cuando tu aplicación llame a file.DefaultBucketName(ctx).

Precios, cuotas y límites

No hay cargos de ancho de banda asociados con la realización de llamadas a Cloud Storage desde la biblioteca cliente de App Engine. Sin embargo, sí existen cargos por operaciones. Además, las llamadas se imputarán a la cuota de recuperación de URL, ya que la biblioteca usa el servicio de recuperación de URL para interactuar con Cloud Storage.

Ten en cuenta que Cloud Storage es un servicio de pago por uso. Se te cobrará de acuerdo con la hoja de precios de Cloud Storage.

Alternativas para acceder a Cloud Storage

En lugar de usar la biblioteca cliente, podrías usar esto:

  • El navegador de Cloud Storage en la consola de Google Cloud, que es útil para subir objetos con rapidez
  • gsutil, que es una herramienta de línea de comandos para trabajar con archivos en Cloud Storage

¿Qué sigue?