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 Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, clique em Criar projeto para começar a criar um novo projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

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

    Acessar o seletor de projetos

  5. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  6. Instale o SDK do Cloud.

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

  7. 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.

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.

    Se funcionar, o comando retornará:

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

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

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

Imagem de um gatinho.

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

  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.

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

    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.

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:jane@gmail.com: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:jane@gmail.com: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.

Limpeza

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, 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