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:
Explore os comandos
gcloud storage
seguindo o início rápido Descubra o armazenamento de objetos com a ferramenta gcloud.Leia a referência
gcloud storage
.Reveja o Shim para executar o
gcloud storage
, que documenta a funcionalidade que não está disponível nos comandosgcloud storage
.
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 comCtrl-C
.
O que se segue?
- Instale o gsutil.
- Consulte a discussão da comunidade nas perguntas do Stack Overflow sobre o gsutil.