Use o Cloud Storage para disponibilizar arquivos como filmes, imagens ou outros conteúdos estáticos.
Este documento descreve como usar as bibliotecas de cliente do Cloud para Cloud Storage no seu app para armazenar e recuperar dados do Cloud Storage.
Antes de começar
- Siga as instruções em Como configurar o ambiente de desenvolvimento para configurar o ambiente e o projeto e entender como os aplicativos são estruturados no App Engine. Anote e salve o ID do projeto. Você precisará dele para executar o aplicativo de amostra descrito neste documento.
Certifique-se de criar um bucket do Cloud Storage para o aplicativo invocando o seguinte comando:
gcloud storage buckets create gs://YOUR_BUCKET_NAME
Configure o bucket como acessível para leitura pública para disponibilização de arquivos:
gcloud storage buckets add-iam-policy-binding gs://<var>YOUR_BUCKET_NAME</var> --member=allUsers --role=roles/storage.objectViewer
Faça o download da amostra
Go
Para clonar o repositório:
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
cd golang-samples/appengine_flexible/storage
Java
Para clonar o repositório:
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-17/cloudstorage
Node.js
Para clonar o repositório:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible
PHP
Para clonar o repositório:
git clone https://github.com/GoogleCloudPlatform/php-docs-samples
cd php-docs-samples/appengine/flexible/storage
Python
Para clonar o repositório:
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible/storage
Ruby
Para clonar o repositório:
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/flexible/storage/
.NET
Faça o download do aplicativo de amostra e extraia-o.
Se você estiver usando a linha de comando, navegue até o seguinte diretório de aplicativos:
dotnet-docs-samples\appengine\flexible\CloudStorage\CloudStorage.Sample
Para executar o aplicativo localmente, configure uma conta de serviço e faça o download das credenciais:
Abra a lista de credenciais no console do Google Cloud.
Clique em Criar credenciais.
Selecione Chave da conta de serviço.
A janela Criar chave da conta de serviço é exibida.
Clique na lista Conta de serviço e selecione Compute conta de serviço padrão do mecanismo.
Selecione JSON como Tipo de chave.
Clique em Criar.
Uma janela Nova chave privada é exibida e o download da chave privada é realizado automaticamente.
Clique em Fechar.
Edite a configuração do projeto e instale as dependências
Go
Em app.yaml
, defina GCLOUD_STORAGE_BUCKET
. Esse valor é o
nome do bucket do Cloud Storage criado anteriormente.
Java
Em app.yaml
, defina BUCKET_NAME
como o Cloud Storage criado anteriormente para o projeto.
Em pom.xml
, defina com.google.cloud
como uma dependência e especifique
google-cloud-storage
como o artifactID dessa dependência. Isso fornece as
funções para usar o Cloud Storage.
Node.js
Em app.yaml
, adicione o ID do projeto ao
valor do ambiente GOOGLE_CLOUD_PROJECT
. Em seguida, configure o valor de ambiente GCLOUD_STORAGE_BUCKET
para o nome do
bucket do Cloud Storage criado anteriormente.
Em package.json
, adicione @google-cloud/storage
como uma dependência, que
fornece as funções para usar o Cloud Storage.
Consulte o arquivo README.md
para instruções sobre como executar e testar localmente.
PHP
Em app.yaml
, defina CLOUD_STORAGE_BUCKET
. Esse valor é o
nome do bucket do Cloud Storage criado anteriormente.
Em composer.json
, observe que é preciso incluir a biblioteca de cliente do Cloud, porque isso fornece as funções do Cloud Storage.
Python
Em app.yaml
, defina GOOGLE_STORAGE_BUCKET
. Esse valor é o
nome do bucket do Cloud Storage criado anteriormente.
Em requirements.txt
, observe que é preciso incluir a
biblioteca google-cloud-storage
, porque isso fornece as funções
do Cloud Storage.
Ruby
Em app.yaml
, defina GCLOUD_STORAGE_BUCKET
como o Cloud Storage criado anteriormente para o projeto.
É necessário incluir a biblioteca gcloud
em Gemfile
para usar os recursos do Cloud Storage.
.NET
No arquivo app.yaml
, defina TEST_GOOGLE_BUCKET_NAME
como o Cloud Storage criado anteriormente para o projeto.
env_variables:
TEST_GOOGLE_BUCKET_NAME: [your-bucket-name]
Código do aplicativo
Go
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Quando o usuário seleciona um arquivo e clica em enviar, o gerenciador de uploads grava o arquivo no bucket do Cloud Storage usando a função NewWriter do Cloud Storage.
Para recuperar esse arquivo do Cloud Storage, especifique o nome do bucket e o nome do arquivo. Armazene esses valores no app para uso futuro.
Java
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Quando o usuário seleciona um arquivo e clica em
"Enviar", o gerenciador de solicitações doPost
grava o arquivo no
bucket do Cloud Storage usando o
Storage.create.
Para recuperar esse arquivo do Cloud Storage, especifique o nome do bucket e o nome do arquivo. Armazene esses valores no app para uso futuro.
Node.js
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Depois que o usuário seleciona o arquivo e clica em enviar, o gerenciador de upload carrega o conteúdo do arquivo em um blob e o salva no Cloud Storage.
Após o upload do arquivo no Cloud Storage, o URL público dele é retornado. É possível usá-lo para disponibilizar o arquivo diretamente do Cloud Storage. Armazene esse valor no app para uso futuro.
PHP
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Depois que o usuário seleciona o arquivo e clica em enviar, o gerenciador de upload carrega o conteúdo do arquivo em um blob e o salva no Cloud Storage.
Após o upload do arquivo no Cloud Storage, o URL público dele é retornado. É possível usá-lo para disponibilizar o arquivo diretamente do Cloud Storage. Armazene esse valor no app para uso futuro.
Python
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Quando o usuário seleciona um arquivo e clica em "Enviar", o gerenciador de uploads carrega o conteúdo do arquivo em um blob e o grava no bucket (links em inglês) do Cloud Storage.
Após o upload do arquivo no Cloud Storage, o URL público dele é retornado. É possível usá-lo para disponibilizar o arquivo diretamente do Cloud Storage. Armazene esse valor no app para uso futuro.
Ruby
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Depois que o usuário seleciona o arquivo e clica em enviar, o gerenciador de upload carrega o conteúdo do arquivo em um blob e o salva no Cloud Storage.
Após o upload do arquivo no Cloud Storage, o URL público dele é retornado. É possível usá-lo para disponibilizar o arquivo diretamente do Cloud Storage. Armazene esse valor no app para uso futuro.
.NET
O aplicativo de amostra apresenta uma página da Web que solicita ao usuário um arquivo para armazenar no Cloud Storage. Depois que o usuário seleciona o arquivo e clica em enviar, o gerenciador de upload carrega o conteúdo do arquivo em um blob e o salva no Cloud Storage.
Após o upload do arquivo no Cloud Storage, o URL público dele é retornado. É possível usá-lo para disponibilizar o arquivo diretamente do Cloud Storage. Armazene esse valor no app para uso futuro.
Para mais informações
Consulte a documentação do Cloud Storage para informações completas.