Configurar Google Cloud Storage

Puedes usar un segmento de Cloud Storage para almacenar y servir archivos, como películas, imágenes u otro contenido estático. En este documento se describe cómo configurar el entorno para usar la biblioteca de cliente de App Engine para Cloud Storage.

Esta API es compatible con los tiempos de ejecución de primera generación y se puede usar al actualizar a los tiempos de ejecución de segunda generación correspondientes. Si vas a actualizar al tiempo de ejecución de App Engine Go 1.12 o una versión posterior, consulta la guía de migración para obtener información sobre las opciones de migración de los servicios empaquetados antiguos.

Configurar un proyecto

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

Activar un segmento de Cloud Storage

Para usar Cloud Storage, debes activar al menos un segmento. Puedes usar el segmento predeterminado, que ofrece los primeros 5 GB de almacenamiento de forma gratuita. Puedes activar y usar otro segmento de Cloud Storage. El segmento predeterminado incluye los primeros 5 GB de almacenamiento de forma gratuita. El segmento predeterminado también incluye una cuota gratuita para las operaciones de E/S de Cloud Storage. Consulta la página Precios, cuotas y límites para obtener más información.

Para activar el segmento de Cloud Storage predeterminado de tu aplicación, haz lo siguiente:

1. En la página Configuración de App Engine de tu proyecto, haz clic en Crear, en Segmento de Cloud Storage predeterminado. Fíjate en el nombre de este contenedor, que tiene el formato <project-id>.appspot.com.

2. Si necesitas más almacenamiento que el límite de 5 GB, puedes aumentar este límite habilitando la facturación en tu proyecto, lo que convertirá el segmento en un segmento de pago. Se te cobrará por el almacenamiento que supere el límite de 5 GB.

Si quieres activar uno o varios segmentos de pago, sigue las instrucciones que se indican en la sección Crear un segmento para activarlos.

Nota: Cuando creas un segmento predeterminado, también obtienes un segmento de almacenamiento provisional con el mismo nombre, pero con el prefijo staging.. Puedes usar este contenedor de almacenamiento provisional para los archivos temporales que se usen con fines de prueba y de almacenamiento provisional. También tiene un límite de 5 GB, pero se vacía automáticamente cada semana.

Definir permisos de segmentos y objetos

Puedes consultar información sobre cómo permitir que la cuenta de servicio de tu aplicación u otros usuarios accedan al contenedor de almacenamiento y a su contenido en Configurar permisos de contenedor y Configurar permisos de objeto.

Descargar la biblioteca de cliente

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

1. Si es necesario, define el GOPATH. Si usas Linux y macOS, puedes configurar tu GOPATH de la siguiente manera:

   mkdir -p $HOME/go
   export GOPATH=$HOME/go

   Nota: Para ver las instrucciones de Windows, consulta la sección Windows del artículo Getting Started with the Go Programming Language (Empezar a usar el 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 en el directorio GOPATH de src.

Para obtener información sobre cómo instalar la biblioteca de cliente, consulta la página Bibliotecas de cliente de Cloud Storage.

Usar la biblioteca de cliente con el servidor de aplicaciones de desarrollo

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

Para usar la biblioteca de cliente con el servidor de aplicaciones de desarrollo, sigue estos pasos:

1. Activa un segmento de Cloud Storage.

2. Ejecuta dev_appserver.py con la marca --default_gcs_bucket_name [BUCKET_NAME] y sustituye [BUCKET_NAME] por el nombre del segmento de Cloud Storage que estés usando.

   Esta marca controla el contenedor que se devolverá cuando tu aplicación llame a file.DefaultBucketName(ctx).

Precios, cuotas y límites

No se aplican cargos por el ancho de banda asociado a las llamadas a Cloud Storage desde la biblioteca de cliente de App Engine. Sin embargo, hay cargos por operaciones. Además, las llamadas se contabilizan en tu cuota de obtención de URLs, ya que la biblioteca usa el servicio de obtención de URLs para interactuar con Cloud Storage.

Ten en cuenta que Cloud Storage es un servicio de pago por uso, por lo que se te cobrará según la hoja de precios de Cloud Storage.

Formas alternativas de acceder a Cloud Storage

En lugar de usar la biblioteca de cliente, puedes usar lo siguiente:

• El Navegador de Cloud Storage de la consola deGoogle Cloud , que es útil para subir objetos rápidamente.
• gsutil, una herramienta de línea de comandos para trabajar con archivos en Cloud Storage.

Siguientes pasos

• Consulta la documentación de referencia de la API.
• Consulta cómo leer y escribir en Cloud Storage con la biblioteca de cliente de App Engine para Cloud Storage.
• Consulta el ejemplo de App Engine y Google Cloud Storage.
• Consulta el conjunto completo de la documentación de Cloud Storage, incluidos otros ejemplos y tutoriales.