Configura Google Cloud Storage

Python 2.7/3 |Java 8/11/17 |PHP 5/7+ |Ruby |Go 1.11/ 1.12+ |Node.js

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.

Esta API es compatible con entornos de ejecución de primera generación y se puede usar en actualizaciones a los entornos de ejecución de segunda generación correspondientes. Si actualizas al entorno de ejecución de Go 1.12+ de App Engine, consulta la guía de migración para obtener información sobre tus opciones de migración para servicios agrupados en paquetes heredados.

Configura el proyecto

Sigue las instrucciones en Crea una aplicación de libro de visitas para configurar tu entorno, crear un proyecto de Cloud y comprender cómo las aplicaciones de Go 1.11 están estructuradas en App Engine. Escribe y guarda el ID del proyecto para usar con tu aplicación.

Activa un bucket de Cloud Storage

Para utilizar Cloud Storage, deberás activar, al menos, un bucket. Es posible que desees utilizar el bucket predeterminado que proporciona los primeros 5 GB de almacenamiento de forma gratuita. Puedes activar y usar otro bucket de Cloud Storage siempre que lo desees, pero solo el bucket predeterminado incluye los primeros 5 GB de almacenamiento gratuito. 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.

Nota: Cuando creas un bucket predeterminado, también obtienes un bucket de etapa de pruebas con el mismo nombre, pero con staging. antepuesto. Puedes usar este bucket de etapa de pruebas para los archivos temporales que se usan con el fin de realizar pruebas y evaluaciones. Este bucket también tiene un límite de 5 GB, pero se vacía de forma automática cada semana.

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

   Nota: Si deseas obtener instrucciones para Windows, consulta la sección de Windows de la introducción al lenguaje de programación 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/...

   Nota: Estos paquetes se descargarán al directorio src de tu GOPATH.

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 Google Cloud Storage es un servicio que se paga por el 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 Google Cloud Console, 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?

• Accede a la documentación de referencia de la API.
• Obtén información sobre cómo realizar operaciones de lectura y escritura en Cloud Storage con la biblioteca cliente de App Engine para Cloud Storage.
• Revisa la muestra de App Engine y Google Cloud Storage.
• Consulta toda la documentación de Cloud Storage, incluso las muestras y los instructivos adicionales.