Instalar gsutil

En esta página se describe la instalación y la configuración de gsutil, una herramienta que te permite acceder a Cloud Storage desde la línea de comandos mediante HTTPS.

Al instalar gsutil, obtendrá acceso inmediato a los datos públicos, lo que le permitirá leer y escribir según los permisos que tenga. Para interactuar con los datos protegidos que se han compartido contigo, debes autenticarte en el servicio Cloud Storage. Si habilitas la facturación, podrás crear y gestionar tus propios contenedores.

Requisitos del sistema

  • La herramienta gsutil se ejecuta en Linux/Unix, Mac OS y Windows (XP o versiones posteriores).

  • Las versiones 5.35 o posteriores de gsutil requieren Python 3.9 a 3.13, que puedes obtener mediante tu gestor de versiones de Python o instalando una versión adecuada.

A continuación, se explica cómo gestionar las versiones de Python:

Linux

Requisitos previos: instala un gestor de versiones de Python (pyenv) e instala una versión de Python adecuada.

  1. Establece la versión global de Python:
    • Para definir Python 3.13 como la versión global, sigue estos pasos: 
      pyenv global 3.13
    • También puedes definir la versión de Python localmente para una carpeta de proyecto específica: 
      pyenv local 3.13
  2. Confirma que se está usando la versión correcta de Python: 
    python --version

    Deberías ver lo siguiente:

    Python 3.13
macOS

Método 1: Usar Homebrew (brew)

Requisitos previos: instala Homebrew e instala una versión de Python adecuada a través de Homebrew.

  1. Establece una versión específica de Python como predeterminada:
    • Añada la versión que quiera a su archivo $PATH. Por ejemplo, para usar Python 3.13: 
      export PATH="/usr/local/opt/python@3.13/bin:$PATH"
    • Para que este cambio sea permanente, añade la ruta al archivo de configuración de tu shell (~/.bash_profile, ~/.zshrc o ~/.bashrc).
  2. Confirma que se está usando la versión correcta de Python: 
    python --version

    Deberías ver lo siguiente:

    Python 3.13

Método 2: Usar pyenv

Requisitos previos: instala el gestor de versiones de Python (pyenv) e instala una versión de Python adecuada a través de pyenv.

  1. Establece la versión global de Python:
    • Para definir la versión de Python de forma global (para todas las terminales), sigue estos pasos: 
      pyenv global 3.13
    • También puedes definir la versión de Python localmente para una carpeta de proyecto específica: 
      pyenv local 3.13
  2. Confirma que se está usando la versión correcta de Python: 
    python --version

    Deberías ver lo siguiente:

    Python 3.13
Windows

Requisitos previos: instala el gestor de versiones de Python (pyenv-win) e instala una versión de Python adecuada a través de pyenv.

  1. Establece la versión global de Python:
    • Para definir Python 3.13 como la versión global, sigue estos pasos: 
      pyenv global 3.13
    • También puedes definir la versión de Python localmente para una carpeta de proyecto específica: 
      pyenv local 3.13
  2. Confirma que se está usando la versión correcta de Python: 
    python --version

    Deberías ver lo siguiente:

    Python 3.13
  • Si tienes previsto usar objetos compuestos, debes instalar crcmod compilado. En Windows, esta opción solo está disponible para Python de 32 bits. Para obtener más información sobre crcmod, instala gsutil y consulta el tema de ayuda con el comando gsutil help crc32c.

Instalar gsutil

El método de instalación y actualización oficialmente admitido para gsutil es como parte de Google Cloud CLI.

Antes de empezar

Google Cloud CLI y gsutil tienen dependencias de la versión de Python que pueden causar problemas de compatibilidad. La CLI de Google Cloud requiere Python 3.9 a 3.14, mientras que gsutil requiere Python 3.9 a 3.13.

Para instalar gsutil, te recomendamos que lo instales como parte de la CLI de Google Cloud. Si decides instalar gsutil directamente, usa Python 3.9 a 3.13 para evitar problemas de compatibilidad.

Instalar gsutil como parte de Google Cloud CLI

Sigue las instrucciones correspondientes a tu sistema operativo para instalar gsutil como parte de Google Cloud CLI:

Linux
  1. Confirma que tienes una versión compatible de Python. Google Cloud CLI requiere Python 3.9 a 3.14. El paquete de Linux x86_64 incluye un intérprete de Python empaquetado que se usará de forma predeterminada. Para obtener información sobre cómo elegir y configurar tu intérprete de Python, consulta la documentación de gcloud topic startup.
  2. Descarga una de las siguientes opciones:
    Plataforma Nombre del paquete Tamaño Suma de comprobación SHA256
    Linux de 64 bits

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 203,3 MB c95e0277ba3792b83709aa43d8f95486de92b0a913d2393dbfca48f28b0bab39
    Linux de 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 58,1 MB a911104ae2b09392bfee61c79c128d5ad23e35bbfb792aadfe2a80024cece201
    Linux de 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 58,1 MB e4ad30317c09cdc36dfc0c366034403e06d671ef5de2e6372bc01d7284b1a6a1

    Para descargar el archivo de Linux, ejecuta el siguiente comando: 

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

    Consulta la tabla de arriba y sustituye google-cloud-cli-linux-x86_64.tar.gz por el nombre del paquete *.tar.gz que corresponda a tu configuración.

  3. Para extraer el contenido del archivo en tu sistema de archivos, ejecuta el siguiente comando: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Para sustituir una instalación, elimina el directorio google-cloud-sdk y, a continuación, extrae el archivo en la misma ubicación.
  4. Ejecuta la secuencia de comandos de instalación desde la raíz de la carpeta que has extraído: 
    ./google-cloud-sdk/install.sh
     El script te pedirá que realices las siguientes acciones de configuración. Para aceptar, responde Y cuando se te solicite. También puedes realizar la instalación de forma no interactiva proporcionando marcas. Para ver las marcas disponibles, ejecuta el siguiente comando: 
    ./google-cloud-sdk/install.sh --help
  5. Opcional: Si has actualizado tu PATH en el paso anterior, abre una nueva terminal para que los cambios surtan efecto.
  6. Ejecuta gcloud init para inicializar, autorizar y configurar gcloud CLI.
  7. Opcional: Instala componentes adicionales con el gestor de componentes.
Debian/Ubuntu

Contenido del paquete

La CLI de gcloud está disponible en formato de paquete para instalarla en sistemas Debian y Ubuntu. Este paquete solo contiene las herramientas de línea de comandos gcloud, gcloud alpha, gcloud beta, gsutil y bq. No incluye kubectl ni las extensiones de App Engine necesarias para desplegar una aplicación mediante comandos de gcloud. Si quieres usar estos componentes, debes instalarlos por separado.

Antes de empezar

Antes de instalar la CLI de gcloud, comprueba que tu sistema operativo cumpla los siguientes requisitos:

  • Se trata de una versión de Ubuntu que no ha alcanzado el fin de su ciclo de vida o de una versión estable de Debian que no ha alcanzado el fin de su ciclo de vida.
  • Ha actualizado recientemente sus paquetes. Para hacerlo ahora, ejecuta el siguiente comando: 
    sudo apt-get update
  • Tiene instaladas las aplicaciones apt-transport-https, ca-certificates, gnupg y curl. Para instalar estos paquetes, ejecuta el siguiente comando: 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl

Instalación

  1. Importa la Google Cloud clave pública.

    • En las distribuciones más recientes (Debian 9 o Ubuntu 18.04 y versiones posteriores), ejecuta el siguiente comando:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • En distribuciones anteriores, ejecuta el siguiente comando: 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    • Si el comando apt-key de tu distribución no admite el argumento --keyring, ejecuta el siguiente comando:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • Si no puedes obtener las últimas actualizaciones debido a que una clave ha caducado, obtén el archivo de clave apt-get.gpg más reciente.

  2. Añade el URI de distribución de gcloud CLI como origen del paquete.
    • En distribuciones más recientes (Debian 9 o Ubuntu 18.04, o versiones posteriores), ejecuta el siguiente comando: 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    • En las distribuciones anteriores que no admiten la opción signed-by, ejecuta el siguiente comando:

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. Actualiza e instala gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Para ver más opciones de apt-get, como inhabilitar las peticiones o hacer pruebas, consulta las páginas del manual de apt-get.

    Consejo sobre Docker: Si vas a instalar la CLI de gcloud en una imagen de Docker, usa un solo paso RUN:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    En el caso de las imágenes base antiguas que no admiten el comando gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - &&