Como configurar o Google Cloud Storage

É possível usar um intervalo do Cloud Storage para armazenar e exibir arquivos, como filmes, imagens ou outros conteúdos estáticos. Neste documento, descrevemos como configurar seu ambiente para usar a biblioteca de cliente do App Engine para Cloud Storage.

Configurar o projeto

Siga as instruções em Como criar um aplicativo de livro de visitas para configurar o ambiente, criar um projeto do GCP e entender como os aplicativos em Python 2 são estruturados no App Engine. Anote e guarde o ID do projeto para uso com seu aplicativo.

Como ativar um intervalo do Cloud Storage

Para usar o Cloud Storage, é preciso ativar pelo menos um intervalo. Você pode usar o intervalo padrão que fornece gratuitamente os primeiros 5 GB de armazenamento. Se quiser, sempre será possível ativar e usar outro intervalo do Cloud Storage. No entanto, apenas o intervalo padrão inclui os primeiros 5 GB de armazenamento gratuitos. O intervalo padrão também inclui uma cota gratuita para operações de E/S do Cloud Storage. Consulte Preços, cotas e limites para mais detalhes.

Para ativar o intervalo padrão do Cloud Storage para seu aplicativo:

  1. Clique em Criar na seção Intervalo padrão do Cloud Storage da página "Configurações do App Engine" do projeto. Observe que o nome desse intervalo está no formato <project-id>.appspot.com.

  2. Se você precisar de mais armazenamento, além do limite de 5 GB, aumente-o ativando o faturamento do seu projeto. Assim, ele se tornará um intervalo pago. Além disso, você será cobrado pelo armazenamento que exceder o limite dos 5 GB.

Se quiser ativar um ou mais intervalos pagos, siga as instruções em Como criar um intervalo.

Como configurar permissões de intervalo e de objeto

Por padrão, ao criar um intervalo para seu projeto, o aplicativo tem todas as permissões necessárias para leitura e gravação.

Se você quiser definir permissões para que outros usuários possam acessar o intervalo e o conteúdo dele, consulte Como definir permissões de intervalo e Como definir permissões de objeto.

Fazer o download da biblioteca de cliente

É possível fazer o download da biblioteca de cliente do App Engine para Cloud Storage usando ferramentas conhecidas, como pip ou Git (em inglês). Outra opção é fazer o download da biblioteca manualmente no GitHub. Escolha o método preferido:

Git

Se você tiver a Git instalada, será possível clonar o repositório do GitHub para a biblioteca de cliente do App Engine para Cloud Storage da seguinte maneira:

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

pip

Se você tiver o setuptools instalado, será possível usar a pip para fazer o download e instalar a biblioteca de cliente do App Engine para Cloud Storage da seguinte maneira:

pip install GoogleAppEngineCloudStorageClient -t <your_app_directory/lib>

Download manual

No GitHub, é possível fazer o download de um arquivo ZIP que contém a biblioteca de cliente do App Engine para Cloud Storage:

Biblioteca de cliente do App Engine para Cloud Storage no GitHub

Instale a biblioteca no diretório que você está usando para bibliotecas de terceiros, como lib. Para mais informações, consulte Como usar bibliotecas terceirizadas.

Como usar a biblioteca de cliente com o servidor do aplicativo de desenvolvimento

É possível usar a biblioteca de cliente com o servidor de desenvolvimento. No entanto, como não há emulação local do Cloud Storage, todas as solicitações de leitura e gravação de arquivos precisam ser enviadas pela Internet para um intervalo real do Cloud Storage.

Para usar a biblioteca de cliente com o servidor do aplicativo de desenvolvimento:

  1. Ative um intervalo do Cloud Storage.

  2. Execute dev_appserver.py com a sinalização --default_gcs_bucket_name [BUCKET_NAME], substituindo [BUCKET_NAME] pelo nome do intervalo do Cloud Storage que você está usando.

    Essa sinalização controla o intervalo que será retornado quando seu aplicativo chamar file.DefaultBucketName(ctx).

Preços, cotas e limites

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

O Google Cloud Storage é um serviço pago de acordo com o uso. Por isso, você será cobrado de acordo com a planilha de preços do Cloud Storage.

Alternativas de acesso ao Cloud Storage

Em vez de usar a biblioteca de cliente, você pode usar as seguintes opções:

Próximas etapas

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Python 2