Cómo realizar una instalación de gcloud CLI y administrar Google Cloud

Como usuario de Google Cloud Platform (GCP), puedes administrar tus recursos y aplicaciones a través de la consola web. Pero ¿qué pasa si planeas automatizar tareas o administrar Google Cloud desde la línea de comandos? ¡No te preocupes! La herramienta de interfaz de línea de comandos (CLI) de gcloud es lo que necesitas.

En este tutorial, aprenderás cómo instalar la CLI de gcloud en tu máquina y comenzar con algunos comandos básicos para administrar recursos de GCP.

¡Mantente atento y mejora tu gestión de recursos de GCP!

Prerrequisitos

Este tutorial será una demostración práctica. Para seguir adelante, asegúrate de tener lo siguiente:

A Google Cloud account with active billing – A free trial will suffice if you do not have one yet.

A Windows 10 machine with an internet connection. This tutorial uses the 21H2 version.

Docker instalado en tu máquina.

Descarga e instalación de la CLI de gcloud

Si eres un usuario más inclinado a la CLI, puedes instalar la CLI de gcloud usando el Instalador del SDK de Google Cloud. Este instalador multiplataforma instala la CLI de gcloud junto con otras herramientas del SDK de Google Cloud.

1. Abre tu navegador web favorito y descarga el instalador de Google Cloud.

Alternativamente, abre PowerShell como administrador y ejecuta el siguiente comando para descargar la última versión estable del instalador de la CLI de Google Cloud. Este comando no muestra ninguna salida, pero inicia automáticamente el asistente de configuración de la CLI de Google Cloud.

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

& $env:Temp\GoogleCloudSDKInstaller.exe

2. Una vez descargado, abre el instalador, que abrirá el asistente de configuración de la CLI de Google Cloud (paso tres). Si no puedes abrir el instalador, ejecútalo como administrador.

3. En el asistente de configuración de la CLI de Google Cloud, marca la primera casilla, como se muestra a continuación, y haz clic en Siguiente. Esta opción te permite activar el modo lector de pantalla.

Al habilitar esta opción, puedes usar un lector de pantalla para mejorar tu experiencia durante la instalación, como mostrar una barra de progreso.

Turning on the screen reader mode

4. Ahora, lee los términos de la licencia y haz clic en Acepto para aceptar el acuerdo de licencia.

Accepting the license agreement

5. Una vez aceptado, selecciona el tipo de instalación (Usuario único) y haz clic en Siguiente.

Selecting the install type

6. A continuación, elige la ubicación para la instalación y haz clic en Siguiente.

Selecting the installation location

7. Marca todas las casillas y haz clic en Instalar para instalar todas las dependencias necesarias, incluyendo Python v3 y las Herramientas de Cloud para PowerShell.

Selecting components to install

Como puedes ver a continuación, el instalador descarga e instala todas las dependencias necesarias y el núcleo de la CLI. Este proceso puede tardar unos minutos en completarse.

Viewing installation progress

8. Una vez instalado, haz clic en Siguiente para continuar.

Confirming gcloud CLI has been installed

9. Por último, marca todas las casillas de verificación a continuación y haz clic en Terminar para completar la instalación.

Completing the gcloud CLI installation

A command prompt window opens automatically after the installation, as shown below. This prompt is where you will later configure the gcloud CLI.

Viewing the command prompt window for diagnostics

Configuración de la CLI de gcloud

Después de instalar la CLI de gcloud, aún necesitas configurarla para asegurarte de que funcione correctamente inicializando el SDK y configurando tus credenciales.

1. Escribe Y y presiona Enter en la ventana del símbolo del sistema.

Al aceptar este aviso, se abre una nueva pestaña en tu navegador web predeterminado, pidiéndote que inicies sesión en tu cuenta de Google (paso dos).

Confirming logging into Google Cloud

2. Inicia sesión en tu cuenta de Google para continuar.

Logging in to Google

3. Haz clic en Permitir para otorgar los permisos necesarios al SDK de Google Cloud.

Granting the Google Cloud SDK the required permissions

Verás una página similar a la siguiente en tu navegador web. Esta página confirma que has iniciado sesión correctamente en tu cuenta de GCP y te has autenticado para usar la CLI de gcloud.

Verifying authentication is successful

4. Ahora, escribe 3 en la ventana del símbolo del sistema y presiona Enter para crear un nuevo proyecto. Este proyecto se utilizará para alojar tus recursos de GCP.

Creating a new project

5. Ingresa un ID de proyecto (único en tu cuenta de GCP) para tu proyecto y presiona Enter. Este tutorial utiliza el ID de proyecto llamado gcp-gcloud-cli-demo.

Tenga en cuenta que el ID del proyecto debe tener entre seis y 30 caracteres y puede contener letras minúsculas, dígitos y guiones.

Providing a Project ID

En este punto, la CLI de gcloud se ha instalado correctamente en su máquina y está lista para ser utilizada, como se muestra a continuación. Ahora puede utilizar esta herramienta para administrar sus recursos de GCP desde la línea de comandos.

Confirming gcloud CLI is ready

6. A continuación, ejecute el siguiente comando para obtener ayuda utilizando la CLI de gcloud.

gcloud --help

Si todo va bien, obtendrá la misma salida que se muestra a continuación.

Getting help in using the gcloud CLI tool

Instalación de la CLI de gcloud a través de los archivos versionados

Si prefiere instalar una versión específica de la CLI de gcloud, puede utilizar archivos versionados. Este método ayuda a instalar una versión anterior de la CLI o si desea utilizar la CLI de gcloud con un script en su canalización de CI/CD.

Los archivos versionados son como una versión portátil de la CLI de gcloud. Puede descargar estos archivos y extraerlos en cualquier ubicación de su máquina. Como estos archivos son autónomos, no requieren dependencias adicionales.

A list of versioned archives of the gcloud CLI is available for Linux, macOS, and Windows.

Para instalar la CLI de gcloud utilizando un archivo versionado, siga los siguientes pasos:

1. Navegue hasta la página oficial de archivos versionados de la CLI de gcloud.

2. Descargue un archivo de versión compatible del CLI de gcloud. Puede elegir cualquier otro archivo basado en su sistema operativo y arquitectura. Pero la elección de este tutorial es el archivo para Windows de 64 bits (x86_64) con Python incluido.

Downloading a compatible version archive of the gcloud CLI installer

3. Una vez que se complete la descarga, extraiga el archivo zip a cualquier ubicación en su máquina.

Abra una ventana del símbolo del sistema, navegue hasta donde extrajo el archivo y ejecute el siguiente comando para instalar el CLI de gcloud.

.\install.bat

Escriba Y y presione Enter para ayudar a Google a mejorar esta herramienta, o escriba N y presione Enter para omitir este aviso.

Opting in/out of Google data collecting.

5. Ahora, ingrese Y y presione Enter para hacer que el CLI de gcloud esté disponible en todas las ventanas del símbolo del sistema. O ingrese N y presione Enter para usar esta herramienta solo en la ventana actual del símbolo del sistema.

Independientemente de su elección, puede ser necesario reiniciar su shell.

Updating the %PATH% environment variable.

Finalmente, ejecute el siguiente comando para inicializar (gcloud init) el SDK y configurar sus credenciales.

Repita los pasos tres a cinco de la sección “Configuración del CLI de gcloud” para completar la configuración de sus credenciales.

.\bin\gcloud init

En este punto, ha instalado correctamente el CLI de gcloud en su máquina.

Initializing the SDK and configuring your credentials

Instalación del CLI de gcloud usando Docker

Docker es una plataforma de contenerización que puede empaquetar e implementar aplicaciones. Docker es una herramienta excelente para desarrolladores que desean probar nuevas tecnologías sin afectar su entorno de desarrollo local.

Google proporciona una imagen de Docker que contiene la CLI de gcloud, actualizada semanalmente con la última versión de la CLI de gcloud.

Para instalar la CLI de gcloud usando Docker:

1. Ejecuta el siguiente comando docker pull en PowerShell para descargar e instalar la última versión de la imagen de Docker de la CLI de gcloud.

docker pull gcr.io/google.com/cloudsdktool/google-cloud-cli:latest
Pulling the latest version of the gcloud CLI Docker image

Alternativamente, verifica la lista de imágenes de Docker de la CLI de gcloud disponibles, y ejecuta los siguientes comandos para descargar la imagen correspondiente desde GCR. En este ejemplo, el siguiente comando instala la versión 370.0.0 de la CLI de gcloud.

docker pull gcr.io/google.com/cloudsdktool/google-cloud-cli:370.0.0
Installing a specific gcloud CLI version

2. Luego, ejecuta el siguiente comando docker run para verificar la instalación de la CLI de gcloud. Este comando ejecuta un contenedor utilizando la imagen de Docker de la CLI de gcloud e imprime la versión de la CLI de gcloud dentro del contenedor.

Quizás instalaste una versión específica de gcloud CLI. En ese caso, ejecuta el mismo comando a continuación pero asegúrate de cambiar la etiqueta latest a la versión real de gcloud CLI que instalaste (es decir, 370.0.0).

docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:latest gcloud version

Como puedes ver a continuación, se imprime la última versión del SDK y CLI de gcloud. Pero ten en cuenta que tu versión puede ser diferente debido a las actualizaciones de imagen.

Verifying the installation

A continuación, puedes confirmar la versión específica instalada de gcloud CLI.

Verifying the specific gcloud CLI version installation

3. Ejecuta el comando a continuación para inicializar el SDK y configurar tus credenciales.

Tus credenciales se guardarán en el contenedor gcloud-config, que puedes usar en sesiones futuras.

docker run -ti --name gcloud-config gcr.io/google.com/cloudsdktool/google-cloud-cli gcloud auth login

4. Por último, sigue los pasos de la sección “Configuración del gcloud CLI” para configurar tus credenciales.

Gestión de componentes de gcloud

Ahora que tienes instalado gcloud CLI en tu máquina, explora algunos ejemplos de cómo utilizar esta herramienta y gestionar tu Google Cloud.

Una de las características esenciales de gcloud CLI es la capacidad de gestionar componentes del SDK de Cloud. Estos componentes son herramientas y bibliotecas individuales que componen el SDK de Cloud.

1. Ejecuta el siguiente comando de gcloud en la ventana de la línea de comandos para listar todos los componentes disponibles y sus números de versión.

gcloud components list

Elige un ID del componente que desees instalar.

Listing all available components

2. A continuación, ejecuta el siguiente comando para descargar e instalar un nuevo componente. La opción de este tutorial es el Emulador de Cloud Bigtable con el ID del componente bigtable.

gcloud components install bigtable

Ingresa Y y presiona Enter para continuar.

Installing the Cloud Bigtable Emulator component

3. Una vez instalado, ejecuta el siguiente comando para actualizar todos los componentes instalados a su última versión.

gcloud components update
Updating all installed components to their latest version

4. Ahora, ejecuta el siguiente comando para eliminar un componente innecesario. En este ejemplo, el siguiente comando elimina el componente Google Cloud CRC32C Hash Tool (gcloud-crc32c).

gcloud components remove gcloud-crc32c
Removing an unneeded component

Creación de una instancia de máquina virtual con gcloud CLI

Ya sea que desees crear un entorno de prueba simple para evitar dañar tu computadora o configurar tu propio servidor, una máquina virtual (VM) hará el trabajo. Afortunadamente, una de las tareas más importantes que puedes realizar con gcloud CLI es crear una nueva instancia de VM.

Para crear una VM con gcloud CLI:

1. Ejecuta el siguiente comando para listar todas las imágenes de cómputo públicas disponibles.

gcloud compute images list

Observa la familia de imágenes y el proyecto de la imagen que deseas usar.

Listing all public images available

2. A continuación, ejecuta el siguiente comando para listar todos los tipos de máquinas disponibles en tu región y el número de CPUs y memoria para cada tipo.

gcloud compute machine-types list

Toma nota del nombre del tipo de máquina que deseas usar.

Listing all machine types

3. Ahora, ejecuta el siguiente comando para crear una nueva instancia de VM (instancia de cómputo) llamada gcloud-cli-demo-vm con los detalles que anotaste en los pasos uno y dos.

Image Family –image-family=centos-7
Image Project –image-project=centos-cloud
Machine Type –machine-type=t2d-standard-4
gcloud compute instances create gcloud-cli-demo-vm --image-family=centos-7 --image-project=centos-cloud --machine-type=t2d-standard-4

La creación de la instancia de VM lleva unos minutos en completarse. Una vez creada, puedes ver el estado de la instancia (en ejecución), como se muestra a continuación.

Creating a VM instance

4. Ahora, ejecuta el siguiente comando de gcloud compute para describir la instancia de VM (gcloud-cli-demo-vm) con más detalle.

gcloud compute instances describe gcloud-cli-demo-vm

Finalmente, ejecuta el siguiente comando para eliminar la instancia de VM (gcloud-cli-demo-vm).

gcloud compute instances delete gcloud-cli-demo-vm

Ingresa Y y presiona Enter para confirmar la eliminación de la instancia de VM especificada.

Deleting a VM instance

Conclusión

Administrar los recursos de Google Cloud puede ser un desafío, especialmente cuando tienes demasiados. Lo bueno es que, en este tutorial, aprendiste lo poderoso que es gcloud CLI para gestionar tus recursos. Aprendiste cómo instalar y configurar gcloud CLI y cómo utilizarlo para gestionar componentes y crear instancias de VM en Google Cloud.

Este tutorial solo cubrió la punta del iceberg. gcloud CLI cuenta con muchas más funciones. Con este nuevo conocimiento, ¿por qué no subir la apuesta y explorar algunas de estas funciones por tu cuenta? ¿Quizás usar gcloud CLI para gestionar buckets de almacenamiento, establecer roles de IAM para usuarios e incluso implementar aplicaciones? ¡El cielo es el límite!

Source:
https://adamtheautomator.com/gcloud-cli-install/