Primeiros passos: como usar a ferramenta gsutil

Nesta página, você verá como executar tarefas básicas no Cloud Storage usando a ferramenta de linha de comando gsutil.

Os custos gerados no Cloud Storage são baseados nos recursos que você usa. Este guia de início rápido geralmente usa menos de US$ 0,01 em recursos do Cloud Storage.

Antes de começar

1. Faça login na sua Conta do Google.

   Se você ainda não tiver uma, inscreva-se.

2. No Console do Cloud, na página do seletor de projetos, clique em Criar para começar a criar um novo projeto do Cloud.

   Acesse a página do seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

4. Instale o SDK do Cloud.

   Quando solicitado, escolha o projeto que você criou acima.

5. Instale o Python 3.8

   Se você está usando o Windows e marcou a caixa de seleção pertinente quando instalou o SDK do Cloud, isso foi feito automaticamente.

Observação: ao usar o Cloud Shell ou uma instância do Compute Engine, o Python e a gsutil serão pré-instalados e autenticados. Se a instância do Compute Engine estiver configurada sem o escopo da conta de serviço no Cloud Storage, execute gsutil config e siga as instruções.

Observação: se você usa o Windows e não instalou a gsutil como parte do SDK do Cloud, preceda cada comando gsutil com python (por exemplo, python gsutil mb gs://my-awesome-bucket). Para mais informações, consulte as Perguntas frequentes sobre o Python no Windows (em inglês).

Criar um bucket

buckets são os contêineres básicos que armazenam seus dados no Cloud Storage.

Para criar um bucket:

1. Abra uma janela de terminal.

2. Use o comando gsutil mb e um nome exclusivo para criar um bucket:

   gsutil mb -b on -l us-east1 gs://my-awesome-bucket/

   Esse comando usa um bucket chamado "my-awesome-bucket". Escolha seu próprio nome de bucket globalmente exclusivo.

   Consulte os requisitos de nomenclatura de bucket.

   • Precisam conter apenas letras minúsculas, números, traços (-), sublinhados (_) e pontos (.). Não é permitido usar espaços. Precisam ser verificados caso incluam pontos.
   • Precisam começar e terminar com um número ou uma letra.
   • Precisam ter de 3 a 63 caracteres. Ter até 222 caracteres caso incluam pontos, mas cada componente separado por ponto não pode ter mais do que 63 caracteres.
   • Nomes de bucket não podem ser representados como um endereço IP na notação decimal com pontos (por exemplo, 192.168.5.4).
   • Nomes de bucket não podem começar com o prefixo "goog".
   • Não podem conter a palavra "google" ou aproximações dela, como "g00gle".

   Além disso, para fins de conformidade com o DNS e compatibilidade futura, não use sublinhados (_) ou um ponto ao lado de outro ponto ou traço. Por exemplo, "..", "-." ou ".-" não são nomes DNS válidos.

   Cuidado: não inclua informações confidenciais no nome do bucket, já que o namespace dele é global e visível para o público.

   Se funcionar, o comando retornará:

   Creating gs://my-awesome-bucket/...

Você acabou de criar um bucket para armazenar seus dados!

Observação: se o nome do bucket escolhido já estiver em uso, seja por você ou por outra pessoa, o comando retornará:

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Tente novamente com outro nome de bucket.

Fazer upload de um objeto no bucket

1. Clique com o botão direito na imagem acima e salve-a em algum lugar do computador, por exemplo, na área de trabalho.

   Observação: se você estiver usando o Cloud Shell ou uma instância do Compute Engine, faça o download da imagem usando wget https://cloud.google.com/storage/images/kitten.png.

2. Use o comando gsutil cp para copiar a imagem do local em que você a salvou para o bucket criado:

   gsutil cp Desktop/kitten.png gs://my-awesome-bucket

   Se funcionar, o comando retornará:

   Copying file://Desktop/kitten.png [Content-Type=image/png]...
   Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
   Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

   Você acabou de armazenar um objeto no bucket.

Observação: use a tecla Tab para preencher automaticamente o nome do bucket.

Faça o download do objeto do seu bucket

1. Use o comando gsutil cp para fazer o download da imagem armazenada no seu bucket para algum lugar no computador, como a área de trabalho:

   gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

   Se funcionar, o comando retornará:

   Copying gs://my-awesome-bucket/kitten.png...
   Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
   Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

   Você acabou de transferir algo do seu bucket.

Copie o objeto para uma pasta no bucket

1. Use o comando gsutil cp para criar uma pasta e copiar a imagem nela:

   gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

   Observação: as pastas no Cloud Storage têm limitações em comparação com os sistemas de arquivos locais, mas muitas das mesmas operações são compatíveis.

   Se funcionar, o comando retornará:

   Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
   Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

   Você acabou de copiar a imagem para uma nova pasta no seu bucket.

Liste conteúdos de um bucket ou pasta

1. Use o comando gsutil ls para listar o conteúdo no nível superior do bucket:

   gsutil ls gs://my-awesome-bucket

   Se for bem-sucedido, o comando retornará uma mensagem como esta:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/just-a-folder/

   Você acabou de ver o conteúdo no nível superior do seu bucket.

Liste detalhes para um objeto

1. Use o comando gsutil ls, com a sinalização -l para ver alguns detalhes sobre uma de suas imagens:

   gsutil ls -l gs://my-awesome-bucket/kitten.png

   Se for bem-sucedido, o comando retornará uma mensagem como esta:

   2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
   TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

   Você acabou de obter informações sobre o tamanho e a data de criação da imagem.

Torne os objetos acessíveis publicamente

1. Use o comando gsutil iam ch para conceder a todos os usuários permissão para ler as imagens armazenadas no seu bucket:

   gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket

   O comando será bem-sucedido se nenhum erro for retornado.

   Agora qualquer pessoa pode acessar suas imagens.

2. Para remover este acesso, use o comando:

   gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket

   O comando será bem-sucedido se nenhum erro for retornado.

   Você removeu o acesso público às imagens em seu bucket.

Observação: Após remover o acesso público, você ainda poderá acessar uma versão em cache de uma das suas imagens por um período de tempo.

Conceder acesso ao bucket

1. Use o comando gsutil iam ch para conceder a um endereço de e-mail específico permissão para ler e gravar objetos no seu bucket:

   gsutil iam ch user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   O comando será bem-sucedido se nenhum erro for retornado.

   Agora, outra pessoa pode inserir dados e ver seu bucket.

2. Para remover essa permissão, use o comando:

   gsutil iam ch -d user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   O comando será bem-sucedido se nenhum erro for retornado.

   Você removeu o acesso do usuário a esse bucket.

Excluir um objeto

1. Use o comando gsutil rm para excluir uma de suas imagens:

   gsutil rm gs://my-awesome-bucket/kitten.png

   Se funcionar, o comando retornará:

   Removing gs://my-awesome-bucket/kitten.png...

   Essa cópia da imagem não está mais armazenada no Cloud Storage. No entanto, a cópia feita na pasta just-a-folder/ ainda existe.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

1. Abra uma janela de terminal, se já não estiver aberta.

2. Use o rm command da gsutil com a sinalização -r para excluir o bucket e tudo o que estiver dentro dele:

   gsutil rm -r gs://my-awesome-bucket

   Se for bem-sucedido, o comando retornará uma mensagem como esta:

   Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
   Removing gs://my-awesome-bucket/...

   Seu bucket e o conteúdo dele foram excluídos.

A seguir

• Siga o guia de início rápido do Cloud Storage usando o Console do Google Cloud.
• Consulte os guias disponíveis para concluir tarefas no Cloud Storage.
• Conheça os principais termos usados no Cloud Storage.
• Saiba mais sobre a estrutura de preços do Cloud Storage.
• Consulte as páginas de referência para comandos da gsutil, como fazer bucket (mb), copiar (cp), lista (ls ), gerenciamento de acesso à identidade (iam) e remover (rm).