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.

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 Python 3 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.

Configurando el proyecto

Crea un proyecto de Google Cloud y comprende cómo se estructuran las apps de Python 2 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.

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

Puedes descargar la biblioteca cliente de App Engine para Cloud Storage con herramientas populares como pip o Git. Como alternativa, puedes descargar la biblioteca de forma manual desde GitHub. Elige tu método preferido.

Git

Si tienes Git instalada, puedes clonar el repositorio de GitHub de la biblioteca cliente de App Engine para Cloud Storage de la siguiente manera:

git clone https://github.com/googleapis/python-storage.git

pip

Puedes usar pip para instalar la biblioteca cliente de Cloud Storage de la siguiente manera:

pip install google-cloud-storage

Importante: El comando pip descarga e instala la distribución PyPi de la biblioteca cliente de Cloud Storage. Esta distribución no incluye código de demostración ni de prueba. Para obtener estos archivos, clona o descarga el repositorio de GitHub de la biblioteca.

Descarga manual

Puedes descargar un archivo ZIP que contiene la biblioteca cliente de App Engine para Cloud Storage desde GitHub:

Biblioteca cliente de App Engine para Cloud Storage en GitHub

Instala la biblioteca en el directorio que usas para las bibliotecas de terceros, como lib. Para obtener más información, consulta Usa bibliotecas de terceros.

Utiliza la biblioteca cliente con el servidor de desarrollo para aplicaciones

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?

• Visita 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.