Documentación del SDK de Google Cloud

El SDK de Google Cloud es un conjunto de herramientas que puedes usar para administrar aplicaciones y recursos alojados en Google Cloud Platform. Esto incluye las herramientas de línea de comandos de gcloud, gsutil y bq. La herramienta de línea de comandos de gcloud se descarga junto con el SDK de Cloud. Puedes encontrar una guía completa de la CLI de gcloud en la descripción general de la herramienta de línea de comandos de gcloud.

Además, la referencia de la CLI de gcloud documenta toda la funcionalidad de la CLI de gcloud. Para obtener una introducción más rápida, consulta la hoja de referencia de la herramienta de línea de comandos de gcloud.

Instala la última versión del SDK de Cloud (301.0.0)

Linux

  1. El SDK de Cloud requiere Python. Las versiones compatibles son las de 3.5 a 3.7, y 2.7.9 o posteriores.

    python2 --version
  2. Descarga una de estas opciones:

    3. Plataforma Paquete Tamaño Suma de verificación SHA256
    Linux de 64 bits

    (x86_64)

    		 google-cloud-sdk-301.0.0-linux-x86_64.tar.gz 78.3 MB 4773911e9f8fb7fe3b915e1f24ebe957436474253688820a9f2990d7399bd3b8
    Linux de 32 bits

    (x86)

    		 google-cloud-sdk-301.0.0-linux-x86.tar.gz 76.5 MB 9dd34f130459c9dd3f8a0c5d74439245d58c27e7f3d5dda11ae7e6f3ea59209a

  3. Extrae el contenido del archivo a cualquier ubicación en tu sistema de archivos. Si deseas reemplazar una instalación existente, quita el directorio google-cloud-sdk existente y extrae el archivo en la misma ubicación.
  4. Opcional. Usa la secuencia de comandos de instalación para agregar las herramientas del SDK de Cloud a tu ruta. También podrás habilitar la finalización de comandos para tu shell y la recopilación de estadísticas de uso. Ejecuta la secuencia de comandos con este comando: 
    ./google-cloud-sdk/install.sh
    Esto también puede hacerse de forma no interactiva (por ejemplo, usar una secuencia de comandos) y proporcionar preferencias como marcas. Estos se describen en los siguientes vínculos: 
    ./google-cloud-sdk/install.sh --help
    Abre una terminal nueva para que los cambios tengan efecto.
  5. Ejecuta gcloud init para inicializar el SDK:
    6. ./google-cloud-sdk/bin/gcloud init
  6. Opcional Instala los componentes adicionales mediante el administrador de componentes.
Debian/Ubuntu

El SDK de Cloud está disponible en formato de paquete para instalarlo en sistemas Debian y Ubuntu. Este paquete solo contiene los comandos gcloud, gcloud alpha, gcloud beta, gsutil y bq. No incluye kubectl o las extensiones de App Engine necesarias para implementar una aplicación con los comandos gcloud. Si quieres estos componentes, debes instalarlos por separado como se describe más adelante en esta sección.

Puedes instalar el SDK de Cloud a partir de un paquete de Debian o de Ubuntu para todas las versiones de Ubuntu oficiales que aún están vigentes y las versiones estables de Debian a partir de Wheezy.

Nota: Si usas una instancia en Google Compute Engine, el SDK de Cloud se instala de manera predeterminada. De todas maneras, puedes instalar el SDK de Cloud de forma manual con las siguientes instrucciones.

  1. Agrega el URI de distribución del SDK de Cloud como una fuente de paquete:
    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
    Nota: Asegúrate de que tengas instalado apt-transport-https:
    sudo apt-get install apt-transport-https ca-certificates gnupg
  2. Importa la clave pública de Google Cloud:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  3. Instala y actualiza el SDK de Cloud:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Nota: Para obtener más opciones de apt-get, como inhabilitar los mensajes o las ejecuciones de prueba, consulta las páginas del manual de apt-get.
  4. De manera opcional, instala cualquiera de estos componentes adicionales:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

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

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. Ejecuta gcloud init para comenzar:
    gcloud init
Red Hat/Fedora/CentOS

El SDK de Cloud está disponible en un formato de paquete para su instalación en sistemas con Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 32 y CentOS 7. 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.

Nota: Si usas una instancia en Google Compute Engine, el SDK de Cloud se instala de manera predeterminada.

  1. Actualiza YUM con la información del repositorio del SDK de Cloud: 
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-sdk]
name=Google Cloud SDK
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
       https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    Importante: La segunda línea de gpgkey debe tener una sangría como se muestra en el código.

  2. Instala el SDK de Cloud: 
    yum install google-cloud-sdk
    Nota: Para obtener más opciones de yum, como inhabilitar los mensajes o las ejecuciones de prueba, consulta las páginas del manual de yum.
  3. De manera opcional, instala cualquiera de estos componentes adicionales:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

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

    yum install google-cloud-sdk-app-engine-java
  4. Ejecuta gcloud init para comenzar:
    gcloud init
macOS
  1. El SDK de Cloud requiere Python. Las versiones compatibles son las de 3.5 a 3.7, y 2.7.9 o posteriores. Las versiones modernas de macOS incluyen la versión apropiada de Python requerida para el SDK de Cloud. 
    2. python -V
  2. Descarga una de estas opciones:

    3. Plataforma Paquete Tamaño Suma de verificación SHA256
    macOS de 64 bits

    (x86_64)

    		 google-cloud-sdk-301.0.0-darwin-x86_64.tar.gz 78.7 MB d99f4724dd7e0641c291c933bed15a18c71969176a241235d387a32426a837ad
    macOS de 32 bits

    (x86)

    		 google-cloud-sdk-301.0.0-darwin-x86.tar.gz 77.6 MB ac68d797d5dbe7514896bdedaaa883dc1218ff55de2d321ef29ed605f9fef373

  3. Extrae el contenido del archivo a cualquier ubicación en tu sistema de archivos. Si deseas reemplazar una instalación existente, quita el directorio google-cloud-sdk existente y extrae el archivo en la misma ubicación.
  4. Opcional. Usa la secuencia de comandos de instalación para agregar las herramientas del SDK de Cloud a tu ruta. También podrás habilitar la finalización de comandos para tu shell y la recopilación de estadísticas de uso. Ejecuta la secuencia de comandos con este comando: 
    ./google-cloud-sdk/install.sh
    Esto también se puede hacer de forma no interactiva (por ejemplo, con una secuencia de comandos) o si proporcionas preferencias como marcas. Estas se describen a continuación: 
    ./google-cloud-sdk/install.sh --help
    Abre una terminal nueva para que los cambios tengan efecto.
  5. Ejecuta gcloud init para inicializar el SDK:
    6. ./google-cloud-sdk/bin/gcloud init
  6. Opcional Instala los componentes adicionales mediante el administrador de componentes.
Windows

  1. Descarga el instalador del SDK de Cloud.

    También puedes abrir una terminal de PowerShell y ejecutar los siguientes comandos.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

  2. Inicia el instalador y sigue las instrucciones. El instalador está firmado por Google LLC.

    El SDK de Cloud requiere Python. Las versiones compatibles son las de 3.5 a 3.7, y 2.7.9 o posteriores.

    Se instalarán todas las dependencias necesarias, incluida la versión de Python correspondiente. Si bien en la actualidad el SDK de Cloud usa Python 2 de forma predeterminada, puedes desmarcar la opción “Install Bundled Python” (Instalar el paquete de Python) para usar una instalación existente. .

  3. Una vez completada la instalación, acepta las opciones siguientes:

    • Iniciar el SDK de Cloud Shell
    • Ejecutar gcloud init

    El instalador inicia una ventana de la terminal y ejecuta el comando gcloud init.

  4. La instalación predeterminada no incluye las extensiones de App Engine necesarias para implementar una aplicación con los comandos gcloud. Estos componentes se pueden instalar con el administrador de componentes del SDK de Cloud.

Instala las últimas bibliotecas cliente de Google Cloud

Puedes descargar las Bibliotecas cliente de Cloud para los idiomas compatibles.

Opcional: Habilita funciones de accesibilidad

Para ofrecer una experiencia de lector de pantalla más optimizada, la herramienta de línea de comandos de gcloud incluye una propiedad accessibility/screen_reader.

Para habilitarla, ejecuta lo siguiente:

gcloud config set accessibility/screen_reader true

Para obtener más detalles sobre las funciones de accesibilidad que vienen con la herramienta de línea de comandos de gcloud, consulta la guía para habilitar funciones de accesibilidad.

Más información

Guías de inicio rápido

Instala y también inicializa el SDK de Cloud

Guías prácticas

Aprende una tarea

API y referencia

Referencia de la CLI de gcloud

Conceptos

Conoce todas las características del SDK de Cloud

Asistencia

Obtén asistencia si tienes problemas con el SDK de Cloud

Recursos

Precios, cuotas y notas de la versión

Soluciones

Guías de productos cruzados, prácticas recomendadas y ejemplos basados en situaciones