Este documento descreve como usar a Bibliotecas de cliente do Cloud para Cloud Storage no seu app para armazenar e recuperar dados
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://<var>YOUR_BUCKET_NAME</var>
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:
Versão 11/17
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-11/cloudstorage
Versão 8
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-8/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 JSON.
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.
versão 11/17
versão 8
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.
versão 11/17
Versão 8
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.
versão 11/17
Versão 8
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.