ferramenta gsutil

O gsutil é uma aplicação Python que lhe permite aceder ao Cloud Storage a partir da linha de comandos. Pode usar o gsutil para realizar uma ampla gama de tarefas de gestão de objetos e contentores, incluindo:

  • Criar e eliminar contentores.
  • Carregar, transferir e eliminar objetos.
  • Listar contentores e objetos.
  • Mover, copiar e mudar o nome de objetos.
  • Editar LCAs de objetos e contentores.

O gsutil executa todas as operações, incluindo carregamentos e transferências, através de HTTPS e Transport Layer Security (TLS).

Deve usar o gsutil?

Geralmente, deve usar comandos gcloud storage em vez de comandos gsutil:

  • A ferramenta gsutil é uma CLI do Cloud Storage antiga e com manutenção mínima.

  • A ferramenta gsutil não suporta o trabalho com funcionalidades mais recentes do Cloud Storage, como a eliminação reversível e as pastas geridas.

  • Os comandos gcloud storage requerem menos otimização manual para alcançar as taxas de carregamento e transferência mais rápidas.

Migrar para a CLI gcloud

Se for um utilizador da gsutil que quer migrar para a CLI gcloud, deve primeiro verificar se está a usar uma versão autónoma da gsutil executando o seguinte comando:

gsutil version -l

  • Se o resultado do comando incluir using cloud sdk: False, está a usar uma versão autónoma da ferramenta gsutil. Para migrar para a CLI gcloud, comece por instalar a CLI gcloud.

  • Se o resultado do comando incluir using cloud sdk: True, significa que já tem a CLI gcloud instalada.

Depois de instalar a CLI gcloud, pode usar gcloud storage comandos tal como usa os comandos gsutil. Os seguintes recursos podem ajudar a começar:

Sintaxe para aceder a recursos

O gsutil usa o prefixo gs:// para indicar um recurso no Cloud Storage:

gs://BUCKET_NAME/OBJECT_NAME

Além de especificar recursos exatos, a ferramenta gsutil suporta a utilização de carateres universais nos seus comandos.

Aceder a uma lista de ficheiros

Para operações que envolvam um grande número de ficheiros, pode transmitir uma lista de ficheiros de origem ao gsutil através da flag -I. Isto indica ao gsutil para ler a lista de ficheiros ou URLs de objetos a partir de stdin em vez dos argumentos da linha de comandos.

A entrada tem de ser uma lista de caminhos de ficheiros locais ou URLs de objetos do Cloud Storage, com um caminho por linha. Por exemplo, pode criar um ficheiro denominado example_file_list.txt que contenha os seguintes caminhos:

gs://example-source-bucket/data-01.csv
gs://example-source-bucket/images/logo.png
/local/logs/error_log_20251226.txt

Os comandos de exemplo seguintes leem os caminhos dos ficheiros de example_file_list.txt e copiam-nos para um segmento de destino denominado gs://example-destination-bucket:

cat example_file_list.txt | gsutil -m cp -I gs://example-destination-bucket/

Também pode gerar a lista de caminhos rapidamente e encaminhá-la diretamente para o gsutil. Por exemplo, os seguintes comandos carregam todos os ficheiros JPG encontrados no seu diretório atual e copiam-nos para gs://example-destination-bucket:

find . -name "*.jpg" | gsutil -m cp -I gs://example-destination-bucket

Ajuda integrada

O gsutil contém ajuda integrada detalhada sobre todos os comandos, bem como vários tópicos, que pode listar e ler com o comando gsutil help.

Para obter informações sobre um comando ou um tópico específico, use gsutil help seguido do comando ou do nome do tópico pretendido. Por exemplo, gsutil help cp e gsutil help options são, respetivamente, uma página de ajuda de comandos e uma página de ajuda de tópicos.

Para obter informações sobre a instalação da ferramenta gsutil, use o comando:gsutil version

gsutil version -l

Estatísticas de utilização

Durante o processo de instalação, pode optar por ativar a monitorização das estatísticas de utilização, o que ajuda a melhorar a ferramenta gsutil. Se decidir posteriormente que quer desativar estas estatísticas de utilização, consulte Estatísticas de utilização.

Acerca do gsutil

O gsutil é um projeto de código aberto. Para transferir a versão para programadores do gsutil ou oferecer-se para ajudar a desenvolver o gsutil, visite o projeto gsutil no GitHub.

Limitações

  • Quando usa o gsutil com o Windows, os comandos que usam a flag global -m não podem ser cancelados com Ctrl-C.

O que se segue?