Configurar o Google Cloud Storage

Pode usar um contentor do Cloud Storage para armazenar e publicar ficheiros, como filmes, imagens ou outro conteúdo estático. Este documento descreve como configurar o seu ambiente para usar a biblioteca cliente do App Engine para o Cloud Storage.

Configurar o seu projeto

Crie um Google Cloud projeto e compreenda como as apps Python 2 estão estruturadas no App Engine. Anote e guarde o ID do projeto para usar com a sua aplicação.

Ativar um contentor do Cloud Storage

Para usar o Cloud Storage, tem de ativar, pelo menos, um contentor. Recomendamos que use o contentor predefinido, que oferece os primeiros 5 GB de armazenamento gratuitamente. Pode ativar e usar outro contentor do Cloud Storage. O contentor predefinido inclui os primeiros 5 GB de armazenamento gratuitamente. O contentor predefinido também inclui uma quota gratuita para operações de I/O do Cloud Storage. Consulte a secção Preços, quotas e limites para ver mais detalhes.

Para ativar o contentor do Cloud Storage predefinido para a sua app:

  1. Clique em Criar em Recipiente do Cloud Storage predefinido na página Definições do App Engine do seu projeto. Repare no nome deste contentor: está no formato <project-id>.appspot.com.

  2. Se precisar de mais armazenamento do que o limite de 5 GB, pode aumentar este limite ativando a faturação para o seu projeto, o que o torna um contentor pago. Ser-lhe-á cobrado o armazenamento que exceda o limite de 5 GB.

Se quiser ativar um ou mais depósitos pagos, siga as instruções em Criar um depósito para os ativar.

Definir autorizações de objetos e contentores

Pode encontrar informações sobre como permitir que a conta de serviço da sua app ou outros utilizadores acedam ao contentor de armazenamento e ao respetivo conteúdo em Definir autorizações do contentor e Definir autorizações de objetos.

Transferir a biblioteca de cliente

Pode transferir a biblioteca cliente do App Engine para o Cloud Storage através de ferramentas populares, como pip ou Git. Em alternativa, pode transferir a biblioteca manualmente a partir do GitHub. Escolha o seu método preferido:

Git

Se tiver o Git instalado, pode clonar o repositório do GitHub para a biblioteca de cliente do Cloud Storage do App Engine da seguinte forma:

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

pip

Pode usar pip para instalar a biblioteca de cliente do Cloud Storage da seguinte forma:

pip install google-cloud-storage

Transferência manual

Pode transferir um ficheiro ZIP que contenha a biblioteca de cliente do App Engine para o Cloud Storage a partir do GitHub:

Biblioteca cliente do App Engine para o Cloud Storage no GitHub

Instale a biblioteca no diretório que está a usar para bibliotecas de terceiros, como lib. Para mais informações, consulte o artigo Usar bibliotecas de terceiros.

Usar a biblioteca cliente com o servidor de apps de desenvolvimento

Pode usar a biblioteca cliente com o servidor de programação. No entanto, como não existe uma emulação local do Cloud Storage, todos os pedidos de leitura e escrita de ficheiros têm de ser enviados através da Internet para um contentor do Cloud Storage real.

Para usar a biblioteca cliente com o servidor de apps de desenvolvimento:

  1. Ative um contentor do Cloud Storage.

  2. Execute dev_appserver.py com a flag --default_gcs_bucket_name [BUCKET_NAME], substituindo [BUCKET_NAME] pelo nome do contentor do Cloud Storage que está a usar.

    Este sinalizador controla o grupo que é devolvido quando a sua aplicação chama file.DefaultBucketName(ctx).

Preços, quotas e limites

Não existem cobranças de largura de banda associadas à realização de chamadas para o Cloud Storage a partir da biblioteca de cliente do App Engine. No entanto, existem cobranças de operações. Além disso, as chamadas são contabilizadas na sua quota de obtenção de URLs, uma vez que a biblioteca usa o serviço de obtenção de URLs para interagir com o Cloud Storage.

Tenha em atenção que o Cloud Storage é um serviço pago; a faturação é feita de acordo com a folha de preços do Cloud Storage.

Formas alternativas de aceder ao Cloud Storage

Em vez de usar a biblioteca de cliente, pode usar o seguinte:

  • O navegador do Cloud Storage na Google Cloud consola, que é útil para carregar objetos rapidamente.
  • gsutil, que é uma ferramenta de linha de comandos para trabalhar com ficheiros no Cloud Storage.

O que se segue?