Instala Google Cloud CLI

En esta guía de inicio rápido, se describe el método recomendado para instalar y, luego, inicializar Google Cloud CLI. Después de la inicialización, ejecuta algunos comandos principales de la gcloud CLI para ver información sobre tu instalación y verificar que se haya realizado correctamente.

Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:

Guiarme

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

Instala la versión 577.0.0 de la gcloud CLI

Linux
  1. Confirma que tienes una versión compatible de Python. Google Cloud CLI requiere Python 3.10 a 3.14. El paquete x86_64 de Linux incluye un intérprete de Python empaquetado que se preferirá 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 verificación SHA256
    Linux de 64 bits

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 88.5 MB 1c478abfe0fbe256b8ecaba2faeff154e44c308064b1c69d9ec15b879a4944bd
    Linux de 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61.3 MB ef8ded3afd45c89bc3900e32579bddfa406b44f7837d993adac417f00b41aa8f
    Linux de 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61.4 MB 52164ff332756c784df60ffcca7f6fd89c5465431b2019cbcd117631b76898c2

    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 anterior y reemplaza google-cloud-cli-linux-x86_64.tar.gz por el nombre del paquete *.tar.gz que se aplica 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 reemplazar una instalación existente, borra el directorio google-cloud-sdk existente y extrae el archivo en la misma ubicación.
  4. Ejecuta la secuencia de comandos de instalación desde la raíz de la carpeta a la que extrajiste: 
    ./google-cloud-sdk/install.sh
     La secuencia de comandos te solicita que realices las siguientes acciones de configuración. Para aceptar, responde Y cuando se te solicite.
    • Agrega gcloud CLI a tu PATH.
    • Habilita la finalización de comandos.
    • Habilita el envío de estadísticas de uso anónimas para ayudar a mejorar gcloud CLI.
    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 actualizaste tu PATH en el paso anterior, abre una terminal nueva para que los cambios tengan efecto.
Debian/Ubuntu

Contenido del paquete

La gcloud CLI 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 implementar una aplicación con los comandos gcloud. Si quieres estos componentes, debes instalarlos por separado.

Antes de comenzar

Antes de instalar gcloud CLI, asegúrate de que tu sistema operativo cumpla con los siguientes requisitos:

  • Una versión de Ubuntu que aún no alcanzó final del ciclo de vida o una versión estable de Debian a la que no se alcanzó final del ciclo de vida
  • Recientemente, actualizó sus paquetes. Para hacerlo ahora, ejecuta el siguiente comando: 
    sudo apt-get update
  • Tiene instalados ca-certificates, gnupg y curl. Para instalar estos paquetes, ejecuta el siguiente comando: 
    sudo apt-get install ca-certificates gnupg curl

Instalación

  1. Importa la clave pública Google Cloud .

    • Para las distribuciones más recientes (Debian 9 y versiones posteriores 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
    • Para las distribuciones más antiguas, 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 la 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 actualizaciones más recientes debido a una clave vencida, obtén el último archivo de claves apt-get.gpg.

  2. Agrega el URI de distribución de gcloud CLI como una fuente de paquetes.
    • Para las distribuciones más recientes (Debian 9 y versiones posteriores o Ubuntu 18.04 y 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

    • Para las distribuciones más antiguas que no admiten la opción de firmado, 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. Instala y actualiza la gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Para obtener más opciones de apt-get, como la inhabilitación de mensajes o las pruebas de validación, consulta las páginas del manual de apt-get.

    Sugerencia de Docker: Si instalas la gcloud CLI dentro de una imagen de Docker, mejor 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 más antiguas que no admiten el comando gpg --dearmor, haz lo siguiente:
    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 - && apt-get update -y && apt-get install google-cloud-cli -y
  4. Opcional: Instala cualquiera de los siguientes componentes adicionales:
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-tools
    • google-cloud-cli-tests
    • kubectl

    Por ejemplo, el componente google-cloud-cli-app-engine-java se puede instalar de la siguiente manera:

    sudo apt-get install google-cloud-cli-app-engine-java

Cambia a una versión inferior de la gcloud CLI

Para volver a una versión específica de gcloud CLI, en la que VERSION tiene el formato 123.0.0, ejecuta el siguiente comando:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Las diez versiones más recientes siempre están disponibles en el repositorio. Para las versiones anteriores a la 371.0.0, el nombre del paquete es google-cloud-sdk.

Red Hat/Fedora/CentOS

Contenido del paquete

La gcloud CLI está disponible en formato de paquete para instalarla en sistemas Red Hat Enterprise Linux 7, 8, 9 y 10; Fedora 41 y 42; y CentOS 7 y 8. Este paquete solo contiene los comandos gcloud, gcloud alpha, gcloud beta, gsutil y bq. No incluye kubectl ni las extensiones de App Engine necesarias para implementar una aplicación mediante comandos de gcloud, los que se pueden instalar por separado como se describe más adelante en esta sección.

Instalación

  1. Actualiza el DNF con la información del repositorio de gcloud CLI.

    • El siguiente comando de muestra es para instalaciones compatibles con Red Hat Enterprise Linux 7, 8 o 9, pero asegúrate de actualizar la configuración según sea necesario para tu configuración:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • Para las instalaciones compatibles con RHEL 10, usa el siguiente comando con el gpgkey actualizado:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM

    • Para las instalaciones de ARM64 (aarch64), usa https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (compatible con RHEL 7, 8 o 9) o https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (compatible con RHEL 10) como el valor de baseurl.

  2. Instala libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Instala la gcloud CLI:
    sudo dnf install google-cloud-cli