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.

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

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.

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