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.

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

Linux
  1. El SDK de Cloud requiere Python. Las versiones compatibles son 3.5 y 2.7.9, o versiones 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-280.0.0-linux-x86_64.tar.gz 56.3 MB 11950f1db216ec7dc3abaf80722fb80518c38e279bd76b6924326fe660c209cf
    Linux de 32 bits

    (x86)

    google-cloud-sdk-280.0.0-linux-x86.tar.gz 54.5 MB dfc2bc5d016e1c20d43c7bcd2f5be3063c31b924971598838978fbe25d6ac341

  4. 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.
  5. 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 la shell y la recopilación de Estadísticas de uso. Ejecuta la secuencia de comandos mediante lo siguiente:
        ./google-cloud-sdk/install.sh
        
    Abre una terminal nueva para que los cambios tengan efecto.
  6. Ejecuta gcloud init para inicializar el SDK:
  7.     ./google-cloud-sdk/bin/gcloud init
        
  8. Opcional. Instala 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 de gcloud. Si deseas usar 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 oficiales de Ubuntu 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 forma 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 tener apt-transport-https instalado:
    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 man 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/CentOS

El SDK de Cloud está disponible en formato de paquete para su instalación en sistemas Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8 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 con los comandos de gcloud, que se pueden instalar por separado.

Nota: Si usas una instancia en Google Compute Engine, el SDK de Cloud se instala de forma 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 man 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 3.5 y 2.7.9, o versiones posteriores. Las versiones modernas de macOS incluyen la versión apropiada de Python requerida para el SDK de Cloud.
  2.     python -V
        
  3. Descarga una de estas opciones:
  4. Plataforma Paquete Tamaño Suma de verificación SHA256
    macOS de 64 bits

    (x86_64)

    google-cloud-sdk-280.0.0-darwin-x86_64.tar.gz 49.0 MB c9554507bc217a503b42bef7dfa72179bae57ad7e4e696af4205c50b373d3576
    macOS de 32 bits

    (x86)

    google-cloud-sdk-280.0.0-darwin-x86.tar.gz 47.9 MB 50c80701e1307ccd8e78fba34d34cec446cf24ee0a7ef30cef260c72676c0980

  5. 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.
  6. 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 la shell y la recopilación de Estadísticas de uso. Ejecuta la secuencia de comandos mediante lo siguiente:
        ./google-cloud-sdk/install.sh
        
    Abre una terminal nueva para que los cambios tengan efecto.
  7. Ejecuta gcloud init para inicializar el SDK:
  8.     ./google-cloud-sdk/bin/gcloud init
        
  9. Opcional. Instala 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 3.5 y 2.7.9, o versiones posteriores.

    Se instalarán todas las dependencias necesarias, incluida la versión de Python correspondiente. Si bien actualmente el SDK de Cloud usa Python 2 de forma predeterminada, puedes desmarcar la opción "Install Bundled Python" (instalar el paquete bundle 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 de 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 lenguajes 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