Comandos comunes de computación de gcloud

Este documento enumera algunos de los comandos gcloud compute más utilizados.

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

Describiendo proyectos

Ejecute el siguiente comando para consultar información sobre su proyecto de Compute Engine, como metadatos del proyecto, claves ssh y métricas de cuota:

 gcloud compute project-info describe

Para obtener más información sobre cómo describir tu proyecto, consulta la documentación de referencia gcloud compute project-info describe .

Trabajar con máquinas virtuales

Los siguientes ejemplos muestran tareas comunes cuando se trabaja con instancias de máquinas virtuales (VM). Para obtener más información sobre las instancias de máquinas virtuales (VM), consulte Instancias de máquinas virtuales .

Crear máquinas virtuales

Ejecute el siguiente comando para crear una VM:

gcloud compute instances create VM_NAME \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    --image-project IMAGE_PROJECT

Reemplace lo siguiente:

  • VM_NAME : el nombre de la nueva VM.
  • IMAGE o IMAGE_FAMILY : Especifique uno de los siguientes:
    • IMAGE : versión requerida de una imagen pública. Por ejemplo, --image debian-10-buster-v20200309 .
    • IMAGE_FAMILY : una familia de imágenes . Esto crea la máquina virtual a partir de la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica --image-family debian-10 , Compute Engine crea una VM a partir de la última versión de la imagen del sistema operativo en la familia de imágenes de Debian 10.
  • IMAGE_PROJECT : el proyecto que contiene la imagen.

Para obtener más información sobre la creación de VM, consulta Crear e iniciar una instancia de VM y la documentación de referencia gcloud compute instances create .

Listado de máquinas virtuales

Ejecute el siguiente comando para mostrar todas las máquinas virtuales en un proyecto:

gcloud compute instances list

Para obtener más información sobre cómo enumerar máquinas virtuales, consulta la documentación de referencia gcloud compute instances list .

Listado de máquinas virtuales con GPU

Ejecute el siguiente comando para mostrar todas las máquinas virtuales con GPU en un proyecto:

gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Listado de máquinas virtuales con SSD locales

Ejecute el siguiente comando para mostrar todas las máquinas virtuales con SSD locales en un proyecto:

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Describiendo máquinas virtuales

Ejecute el siguiente comando para mostrar todos los datos asociados con una VM:

gcloud compute instances describe VM_NAME

Reemplace VM_NAME con el nombre de la VM.

Para obtener más información sobre cómo describir las VM, consulta la documentación de referencia gcloud compute instances describe .

Iniciar máquinas virtuales

Ejecute el siguiente comando para iniciar una VM detenida:

gcloud compute instances start VM_NAME

Reemplace VM_NAME con el nombre de la VM.

Para obtener más información sobre cómo iniciar máquinas virtuales, consulta Iniciar y detener una instancia y la documentación de referencia gcloud compute instances start .

Detener máquinas virtuales

Ejecute el siguiente comando para detener una VM:

gcloud compute instances stop VM_NAME

Reemplace VM_NAME con el nombre de la VM.

Para obtener más información sobre cómo detener VM, consulta Iniciar y detener una instancia y la documentación de referencia gcloud compute instances stop .

Agregar etiquetas a las máquinas virtuales

Ejecute el siguiente comando para agregar etiquetas a las máquinas virtuales:

gcloud compute instances add-labels VM_NAME \
    --labels=KEY=VALUE

Reemplace lo siguiente:

  • VM_NAME : el nombre de la VM.
  • KEY = VALUE : el par clave-valor de la etiqueta.

Para obtener más información sobre el etiquetado de máquinas virtuales, consulta Etiquetado de recursos y la documentación de referencia gcloud compute instances add-labels .

Conexión a máquinas virtuales

Usar SSH para conectarse a instancias

Ejecute el siguiente comando para conectarse a una máquina virtual mediante SSH: 

gcloud compute ssh VM_NAME

Reemplace VM_NAME con el nombre de la VM.

Para obtener más información sobre cómo conectarse a máquinas virtuales mediante SSH, consulte Conexión a máquinas virtuales Linux y la documentación de referencia gcloud compute ssh .

Usar SCP para transferir archivos a instancias

Ejecute el siguiente comando para copiar archivos a una VM: 

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

Ejecute el siguiente comando para copiar archivos desde una VM: 

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

Reemplace lo siguiente:

  • LOCAL_FILE_PATH : la ruta al archivo en su estación de trabajo.
  • VM_NAME : el nombre de su VM.
  • REMOTE_DIRECTORY : la ruta al directorio de su VM.

Para obtener más información sobre la transferencia de archivos hacia y desde máquinas virtuales mediante SCP, consulte Transferencia de archivos mediante la CLI de Google Cloud y la documentación de referencia de gcloud compute scp .

Trabajar con discos

El siguiente ejemplo muestra una tarea común cuando se trabaja con discos. Para obtener más información sobre los discos, consulte Opciones de almacenamiento .

Listado de discos

Ejecute el siguiente comando para mostrar todos los discos de un proyecto: 

gcloud compute disks list

Para obtener más información sobre cómo enumerar discos, consulta la documentación de referencia sobre la gcloud compute disks list .

Trabajar con instantáneas

Los siguientes ejemplos muestran tareas comunes al trabajar con instantáneas. Para obtener más información sobre las instantáneas, consulte Instantáneas de disco persistentes .

Instantáneas de listado

Ejecute el siguiente comando para mostrar todas las instantáneas de un proyecto: 

gcloud compute snapshots list

Para obtener más información sobre cómo describir instantáneas, consulta la documentación de referencia gcloud compute snapshots list .

Describir instantáneas

Ejecute el siguiente comando para mostrar todos los datos asociados con una instantánea: 

gcloud compute snapshots describe SNAPSHOT_NAME

Reemplace SNAPSHOT_NAME con el nombre de la instantánea.

Para obtener más información sobre cómo describir instantáneas, consulta la documentación de referencia gcloud compute snapshots describe .

Eliminar instantáneas

Ejecute el siguiente comando para eliminar una instantánea: 

gcloud compute snapshots delete SNAPSHOT_NAME

Reemplace SNAPSHOT_NAME con el nombre de la instantánea.

Para obtener más información sobre cómo eliminar instantáneas, consulta la documentación de referencia sobre eliminación de gcloud compute snapshots delete una instantánea .

Trabajar con reglas de firewall

Los siguientes ejemplos muestran tareas comunes cuando se trabaja con reglas de firewall. Para obtener más información sobre las reglas de firewall, consulte Descripción general de las reglas de firewall de VPC .

Describir reglas de firewall

Ejecute el siguiente comando para mostrar todos los datos asociados con una regla de firewall: 

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

Reemplace FIREWALL_RULE_NAME con el nombre de la regla de firewall.

Para obtener más información sobre cómo describir las reglas de firewall, consulta la documentación de referencia gcloud compute firewall-rules describe .

Crear reglas de firewall

Ejecute el siguiente comando para crear una regla de firewall: 

gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]

Especifique --allow o --action y --rules y reemplace lo siguiente:

  • FIREWALL_RULE_NAME : el nombre de la regla de firewall.
  • ACTION : la acción en el partido. O allow o deny .
  • PROTOCOL : PORT : el protocolo y el puerto cuyo tráfico se verá afectado por la regla del firewall.

Para obtener más información sobre cómo crear reglas de firewall, consulta Creación de reglas de firewall y la documentación de referencia gcloud compute firewall-rules create .

Trabajar con grupos de instancias administradas (MIG)

Los siguientes ejemplos muestran tareas comunes al trabajar con MIG. Para obtener más información sobre los MIG, consulte Grupos de instancias administrados (MIG) .

Crear grupos de instancias administrados

Ejecute el siguiente comando para crear un MIG: 

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE

Reemplace lo siguiente:

  • INSTANCE_GROUP_NAME : el nombre de este grupo de instancias
  • SIZE : el tamaño del grupo de instancias
  • INSTANCE_TEMPLATE : el nombre de la plantilla de instancia que se utilizará para este grupo

Para obtener más información sobre la creación de MIG, consulta Escenarios básicos para crear un MIG y la documentación de referencia gcloud compute instance-groups managed create .

Configurar el escalado automático

Ejecute el siguiente comando para configurar el escalado automático en un MIG, según la utilización de la CPU: 

gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \
    --max-num-replicas=MAX_NUM_REPLICAS \
    --target-cpu-utilization=TARGET_CPU_UTILIZATION

Reemplace lo siguiente:

  • INSTANCE_GROUP_NAME : el nombre de un MIG
  • MAX_NUM_REPLICAS : el número máximo de réplicas que el escalador automático puede crear
  • TARGET_CPU_UTILIZATION : el nivel de CPU que debe mantener el escalador automático, entre 0.0 y 1.0

Para obtener más información sobre cómo configurar el escalado automático, consulta Grupos de instancias de escalado automático y la documentación de referencia gcloud compute instance-groups managed set-autoscaling .

Trabajar con metadatos

El siguiente ejemplo muestra una tarea común cuando se trabaja con metadatos. Para obtener más información sobre metadatos, consulte Almacenamiento y recuperación de metadatos .

Agregar metadatos a nivel de proyecto

Ejecute el siguiente comando para agregar metadatos a su proyecto: 

gcloud compute project-info add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Reemplace lo siguiente:

  • VM_NAME : el nombre de la VM
  • KEY = VALUE : el par clave-valor de metadatos

Para obtener más información sobre cómo agregar metadatos a las máquinas virtuales, consulta Configuración de metadatos personalizados para todo el proyecto y la documentación de referencia gcloud compute project-info add-metadata .

Agregar metadatos a nivel de instancia

Ejecute el siguiente comando para agregar metadatos a una VM: 

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Reemplace lo siguiente:

  • VM_NAME : el nombre de la VM
  • KEY = VALUE : el par clave-valor de metadatos

Para obtener más información sobre cómo agregar metadatos a las máquinas virtuales, consulta Configuración de metadatos de instancia y la documentación de referencia gcloud compute instances add-metadata .

Obtener páginas de ayuda

Los siguientes comandos muestran cómo acceder a diferentes tipos de ayuda, desde ayuda general sobre el comando gcloud compute hasta ayuda específica sobre un grupo de recursos ( instances ) o un comando ( create ). La ayuda integral para todos los recursos y comandos sigue este patrón: 

gcloud compute --help
gcloud compute instances --help
gcloud compute instances create --help

Se puede obtener ayuda rápida utilizando el indicador -h en lugar del indicador --help . También puede revisar toda la ayuda completa en Referencia de la CLI de Google Cloud .

Para obtener ayuda completa con comandos específicos para configurar la CLI de gcloud, ejecuta: 

gcloud topic TOPIC

Reemplace TOPIC con el tema con el que desea ayuda. Para obtener una lista de temas sobre los que puedes obtener ayuda, consulta la documentación de referencia gcloud topic .

¿Qué sigue?