Comandos de gcloud compute comunes

En este documento, se enumeran algunos de los comandos de gcloud compute más utilizados.

Antes de comenzar

  • Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

      gcloud init
    2. Configura una región y una zona predeterminadas.

Describe proyectos

Ejecuta el siguiente comando para consultar información sobre tu proyecto de Compute Engine, como metadatos del proyecto, claves SSH y métricas de cuotas:

 gcloud compute project-info describe

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

Trabaja con VM

En los siguientes ejemplos, se muestran tareas comunes cuando se trabaja con instancias de máquina virtual (VM). Para obtener más información sobre las instancias de máquina virtual (VM), consulta Instancias de máquina virtual.

Crea VM

Ejecuta el siguiente comando para crear una VM:

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

Reemplaza lo siguiente:

  • VM_NAME: El nombre de la VM nueva
  • IMAGE o IMAGE_FAMILY: Especifica una de las siguientes opciones:
    • IMAGE: Es la versión requerida de una imagen pública. Por ejemplo, --image debian-10-buster-v20200309
    • IMAGE_FAMILY: Es una familia de imágenes. Esto crea la VM a partir de la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas --image-family debian-10, Compute Engine crea una VM a partir de la última versión de la imagen de SO en la familia de imágenes Debian 10.
  • IMAGE_PROJECT: El proyecto que contiene la imagen.

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

Enumera las VM

Ejecuta el siguiente comando para mostrar todas las VM en un proyecto:

gcloud compute instances list

Para obtener más información sobre la enumeración de VMs, consulta la documentación de referencia gcloud compute instances list.

Enumera las VMs con GPU

Ejecuta el siguiente comando para mostrar todas las VMs con GPU en un proyecto:

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

Enumera las VMs con SSD locales

Ejecuta el siguiente comando para mostrar todas las VMs con SSD locales de un proyecto:

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

Describe las VM

Ejecuta el siguiente comando para mostrar todos los datos asociados a una VM:

gcloud compute instances describe VM_NAME

Reemplaza VM_NAME por el nombre de la VM.

Para obtener más información sobre la descripción de VMs, consulta la documentación de referencia gcloud compute instances describe.

Inicia las VM

Ejecuta el siguiente comando para iniciar una VM detenida:

gcloud compute instances start VM_NAME

Reemplaza VM_NAME por el nombre de la VM.

Para obtener más información sobre el inicio de VMs, consulta Inicia y detén una instancia y la documentación de referencia de gcloud compute instances start.

Detén las VM

Ejecuta el siguiente comando para detener una VM:

gcloud compute instances stop VM_NAME

Reemplaza VM_NAME por el nombre de la VM.

Para obtener más información sobre la detención de VMs, consulta Inicia y detén una instancia, y la documentación de referencia de gcloud compute instances stop.

Agrega etiquetas a las VM

Ejecuta el siguiente comando para agregar etiquetas a las VM:

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

Reemplaza 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 VM, consulta Etiqueta recursos y la documentación de referencia de gcloud compute instances add-labels.

Conéctate a las VM

Usa SSH para conectarte a instancias

Ejecuta el siguiente comando para conectarse a una VM mediante SSH:

gcloud compute ssh VM_NAME

Reemplaza VM_NAME por el nombre de la VM.

Para obtener más información sobre la conexión a las VM mediante SSH, consulta Conéctate a VM de Linux y la documentación de referencia de gcloud compute ssh.

Usa SCP para transferir archivos a instancias

Ejecuta el siguiente comando para copiar archivos a una VM:

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

Ejecuta el siguiente comando para copiar archivos desde una VM:

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

Reemplaza lo siguiente:

  • LOCAL_FILE_PATH: la ruta de acceso al archivo en tu estación de trabajo.
  • VM_NAME: El nombre de tu VM.
  • REMOTE_DIRECTORY: la ruta de acceso al directorio en tu instancia

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

Trabaja con discos

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

Enumera discos

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

gcloud compute disks list

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

Trabaja con instantáneas

En los siguientes ejemplos, se muestran tareas comunes cuando se trabaja con instantáneas. Para obtener más información sobre las instantáneas, consulta la página Instantáneas de disco persistente.

Enumera instantáneas

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

gcloud compute snapshots list

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

Describe instantáneas

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

gcloud compute snapshots describe SNAPSHOT_NAME

Reemplaza SNAPSHOT_NAME por el nombre de la instantánea.

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

Borrando instantáneas…

Ejecuta el siguiente comando para borrar una instantánea:

gcloud compute snapshots delete SNAPSHOT_NAME

Reemplaza SNAPSHOT_NAME por el nombre de la instantánea.

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

Trabaja con reglas de firewall

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

Describe reglas de firewall

Ejecuta el siguiente comando para mostrar todos los datos asociados a una regla de firewall:

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

Reemplaza FIREWALL_RULE_NAME por el nombre de la regla de firewall.

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

Crea reglas de firewall

Ejecuta 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]

Especifica --allow o --action y --rules, y reemplaza lo siguiente:

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

Si deseas obtener más información para crear reglas de firewall, consulta Crea reglas de firewall y la documentación de referencia de gcloud compute firewall-rules create.

Trabaja con grupos de instancias administrados (MIG)

En los siguientes ejemplos, se muestran tareas comunes cuando se trabaja con MIG. Para obtener más información sobre los MIG, consulta Grupos de instancias administrados (MIG).

Crea grupos de instancias administrados

Ejecuta el siguiente comando para crear un MIG:

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

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: El nombre de este grupo de instancias
  • SIZE es el tamaño del grupo de instancias.
  • INSTANCE_TEMPLATE: El nombre de la plantilla de instancias que se usará en este grupo

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

Configura el ajuste de escala automático

Ejecuta el siguiente comando para configurar el ajuste de escala automático en un MIG, según el uso de CPU:

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

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre de un MIG.
  • MAX_NUM_REPLICAS: La cantidad máxima de réplicas que puede crear el escalador automático
  • TARGET_CPU_UTILIZATION: El nivel de CPU que debe mantener el escalador automático, entre 0.0 y 1.0

Si deseas obtener más información sobre la configuración del ajuste de escala automático, consulta Ajuste de escala automático para grupos de instancias y la documentación de referencia gcloud compute instance-groups managed set-autoscaling.

Trabaja con metadatos

En el siguiente ejemplo, se muestra una tarea común cuando se trabaja con metadatos. Para obtener más información sobre los metadatos, consulta Almacena y recupera metadatos.

Agrega metadatos a nivel de proyecto

Ejecuta el siguiente comando para agregar metadatos a tu proyecto:

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

Reemplaza 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 VMs, consulta Configura metadatos personalizados para todo el proyecto y la documentación de referencia de gcloud compute project-info add-metadata.

Agrega metadatos a nivel de instancia

Ejecuta el siguiente comando para agregar metadatos a una VM:

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

Reemplaza 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 VMs, consulta Configura metadatos de instancia y la documentación de referencia de gcloud compute instances add-metadata.

Obtén páginas de ayuda

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

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

Puedes obtener ayuda con rapidez mediante la marca -h en lugar de --help. También puedes consultar la ayuda completa en la referencia de Google Cloud CLI.

Si deseas consultar la ayuda completa sobre los comandos específicos para configurar la CLI de gcloud, ejecuta el siguiente comando:

gcloud topic TOPIC

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

Próximos pasos