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

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 uma página de ajuda de comandos e uma página de ajuda de tópicos, respetivamente.

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 monitorizar as 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 o artigo 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?