Cómo configurar Google Cloud Storage

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

Cómo configurar tu proyecto

Sigue las instrucciones en Cómo crear una aplicación de Guestbook para configurar tu entorno, crear un proyecto de GCP y comprender cómo se estructuran las aplicaciones de Java en App Engine. Escribe y guarda el ID del proyecto para usar con tu aplicación.

Cómo activar un depósito de Cloud Storage

Para utilizar Cloud Storage, deberás activar, al menos, un depósito. Es posible que desees utilizar el depósito predeterminado que proporciona los primeros 5 GB de almacenamiento de forma gratuita. Puedes activar y usar otro depósito de Cloud Storage siempre que lo desees, pero solo el depósito predeterminado incluye los primeros 5 GB de almacenamiento gratuito. El depósito predeterminado además incluye una cuota gratuita para operaciones de E/S de Cloud Storage. Consulta Precios, cuotas y límites para obtener más detalles.

A fin de activar el depósito de Cloud Storage predeterminado para tu aplicación, realiza los siguientes pasos:

  1. Haz clic en Crear, en Depósito de Cloud Storage predeterminado desde la configuración de App Engine para tu proyecto. Presta atención al nombre de este depósito: tiene el formato <project-id>.appspot.com.

  2. Si necesitas más espacio de almacenamiento que el límite de 5 GB, puedes aumentarlo; para ello, habilita la facturación en el proyecto. Esto dará como resultado un depósito 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 en Crear un depósito para activarlos.

Cómo configurar permisos de depósitos y objetos

Según la configuración predeterminada, cuando creas un depósito para tu proyecto, la aplicación tiene todos los permisos necesarios a fin de leer ese depósito y escribirlo.

Si deseas establecer permisos para permitir que otros usuarios accedan al depósito y su contenido, consulta Cómo configurar permisos de depósitos y Cómo configurar permisos de objetos.

Cómo descargar la biblioteca cliente

Puedes descargar la biblioteca utilizando herramientas populares como Apache Maven, Apache Ivy o Git, o puedes descargar la biblioteca manualmente desde el repositorio de Maven. Elige tu método preferido.

Git

Si tienes Git instalado, puedes clonar el repositorio de GitHub de la biblioteca cliente de Google Cloud Storage de la siguiente manera:

git clone https://github.com/GoogleCloudPlatform/appengine-gcs-client.git

Maven

Los usuarios de Maven deben incluir lo siguiente en el archivo pom.xml de su aplicación:

<dependency>
    <groupId>com.google.appengine.tools</groupId>
    <artifactId>appengine-gcs-client</artifactId>
    <version>0.7</version>
</dependency>

Ivy

Los usuarios de Ivy deben incluir lo siguiente en el archivo ivy.xml de su aplicación:

<dependency org="com.google.appengine.tools"
            name="appengine-gcs-client"
            rev="latest.integration" />

Descarga manual

Visita el repositorio Maven de la biblioteca y descarga los últimos archivos JAR de clase, fuente y JavaDoc:

Además, deberás descargar las siguientes dependencias y, luego, incluirlas en tu aplicación:

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

Cómo utilizar la biblioteca cliente con el servidor de desarrollo de la aplicación

Puedes utilizar la biblioteca cliente con el servidor de desarrollo. Sin embargo, como 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 depósito de Cloud Storage real.

A fin de usar la biblioteca cliente con el servidor de desarrollo de la aplicación, realiza los siguientes pasos:

  1. Activa un depósito de Cloud Storage.

  2. Ejecuta dev_appserver.py con el marcador --default_gcs_bucket_name [BUCKET_NAME] y reemplaza [BUCKET_NAME] con el nombre del depósito de Cloud Storage que utilizas.

    Este marcador controla el depósito que se mostrará cuando la aplicación llame a file.DefaultBucketName(ctx).

Precios, cuotas y límites

No existen cargos de ancho de banda relacionados con las llamadas de la biblioteca cliente de Google Cloud Storage a Cloud Storage. 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 utiliza el servicio de recuperación de URL para interactuar con Cloud Storage.

Ten en cuenta que Google Cloud Storage es un servicio de pago por uso; 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 cliente, podrías usar lo siguiente:

  • Navegador de Cloud Storage en Google Cloud Platform Console, el cual es útil para subir objetos rápidamente.
  • gsutil, que es una herramienta de línea de comandos para trabajar con archivos en Cloud Storage.

¿Qué sigue?

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

Enviar comentarios sobre...

Entorno estándar de App Engine para Java