Herramienta gsutil

gsutil es una aplicación de Python que te permite acceder a Cloud Storage desde la línea de comandos. Puedes usar gsutil para realizar una amplia gama de tareas de gestión de segmentos y objetos, como las siguientes:

  • crear y eliminar depósitos,
  • subir, descargar y eliminar objetos,
  • consultar depósitos y objetos,
  • desplazar y copiar objetos y cambiarles el nombre,
  • Editar las LCAs de objetos y segmentos.

gsutil realiza todas las operaciones, incluidas las subidas y descargas, mediante HTTPS y Seguridad en la capa de transporte (TLS).

¿Deberías usar gsutil?

Por lo general, debes usar comandos gcloud storage en lugar de comandos gsutil:

  • La herramienta gsutil es una CLI antigua de Cloud Storage que se mantiene de forma mínima.

  • La herramienta gsutil no admite el uso de las funciones más recientes de Cloud Storage, como la eliminación lógica y las carpetas gestionadas.

  • Los comandos gcloud storage requieren menos optimización manual para conseguir las velocidades de subida y descarga más rápidas.

Migrar a la CLI de gcloud

Si eres usuario de gsutil y quieres migrar a la CLI de gcloud, primero debes comprobar si estás usando una versión independiente de gsutil ejecutando el siguiente comando:

gsutil version -l

  • Si el resultado del comando incluye using cloud sdk: False, significa que estás usando una versión independiente de gsutil. Para migrar a gcloud CLI, empieza por instalar gcloud CLI.

  • Si el resultado del comando incluye using cloud sdk: True, significa que ya tienes instalada la CLI de gcloud.

Una vez instalada la CLI de gcloud, puedes usar los comandos de gcloud storage igual que los de gsutil. Los siguientes recursos pueden ayudarte a empezar:

Sintaxis para acceder a los recursos

gsutil usa el prefijo gs:// para indicar un recurso de Cloud Storage:

gs://BUCKET_NAME/OBJECT_NAME

Además de especificar recursos exactos, gsutil admite el uso de comodines en los comandos.

Ayuda integrada

gsutil incluye una ayuda completa sobre cada comando, así como varios temas, que puede consultar con el comando gsutil help.

Para obtener información sobre un comando o un tema concretos, usa gsutil help seguido del nombre del comando o del tema. Por ejemplo, gsutil help cp y gsutil help options son una página de ayuda de un comando y una página de ayuda de un tema, respectivamente.

Para obtener información sobre tu instalación de gsutil, usa el comando gsutil version:

gsutil version -l

Estadísticas de uso

Durante el proceso de instalación, puedes habilitar el seguimiento de las estadísticas de uso, lo que ayuda a mejorar la herramienta gsutil. Si más adelante decides inhabilitar estas estadísticas de uso, consulta Estadísticas de uso.

Acerca de gsutil

gsutil es un proyecto de código abierto. Para descargar la versión para desarrolladores de gsutil o ayudar a desarrollar gsutil, visita el proyecto gsutil en GitHub.

Limitaciones

  • Cuando se usa gsutil con Windows, los comandos que usan la marca global -m no se pueden cancelar con Ctrl-C.

Siguientes pasos