Comandos habituales de gcloud compute

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

Antes de empezar

  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    1. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

Describir proyectos

Ejecuta el siguiente comando para consultar información sobre tu proyecto de Compute Engine, como los metadatos del proyecto, las claves SSH y las 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 de gcloud compute project-info describe.

Trabajar con máquinas virtuales

En los siguientes ejemplos se muestran tareas habituales al trabajar con instancias de máquina virtual (VM). Para obtener más información sobre las instancias de máquina virtual (VM), consulta el artículo sobre instancias de máquina virtual.

Crear VMs

Ejecuta el siguiente comando para crear una VM:

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

Haz los cambios siguientes:

  • VM_NAME: el nombre de la nueva VM.
  • IMAGE o IMAGE_FAMILY: Especifique una de las siguientes opciones:
    • IMAGE: versión obligatoria de una imagen pública. Por ejemplo, --image debian-10-buster-v20200309.
    • IMAGE_FAMILY: una familia de imágenes. De este modo, se crea la VM a partir de la imagen de SO más reciente que no esté obsoleta. Por ejemplo, si especificas --image-family debian-10, Compute Engine crea una VM a partir de la última versión de la imagen del SO de la familia de imágenes Debian 10.
  • IMAGE_PROJECT: el proyecto que contiene la imagen.

Para obtener más información sobre cómo crear VMs, consulta el artículo Crear e iniciar una instancia de VM y la documentación de referencia de gcloud compute instances create.

Listar VMs

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

gcloud compute instances list

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

Listar las VMs con GPUs

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

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

Listar las VMs con SSD locales

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

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

Describir VMs

Ejecuta el siguiente comando para mostrar todos los datos asociados a una máquina virtual:

gcloud compute instances describe VM_NAME

Sustituye VM_NAME por el nombre de la VM.

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

Iniciar VMs

Ejecuta el siguiente comando para iniciar una máquina virtual detenida:

gcloud compute instances start VM_NAME

Sustituye VM_NAME por el nombre de la VM.

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

Detener VMs

Ejecuta el siguiente comando para detener una máquina virtual:

gcloud compute instances stop VM_NAME

Sustituye VM_NAME por el nombre de la VM.

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

Añadir etiquetas a las VMs

Ejecuta el siguiente comando para añadir etiquetas a las VMs:

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

Haz los cambios siguientes:

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

Para obtener más información sobre cómo etiquetar VMs, consulta el artículo Etiquetar recursos y la documentación de referencia de gcloud compute instances add-labels.

Conectarse a máquinas virtuales

Usar SSH para conectarse a instancias

Ejecuta el siguiente comando para conectarte a una máquina virtual mediante SSH:

gcloud compute ssh VM_NAME

Sustituye VM_NAME por el nombre de la VM.

Para obtener más información sobre cómo conectarse a máquinas virtuales mediante SSH, consulta el artículo Conectarse a máquinas virtuales Linux y la documentación de referencia sobre gcloud compute ssh.

Usar SCP para transferir archivos a instancias

Ejecuta el siguiente comando para copiar archivos en una VM:

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

Ejecuta el siguiente comando para copiar archivos de una VM:

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

Haz los cambios siguientes:

  • LOCAL_FILE_PATH: la ruta al archivo en tu estación de trabajo.
  • VM_NAME: el nombre de tu VM.
  • REMOTE_DIRECTORY: la ruta al directorio de tu máquina virtual.

Para obtener más información sobre cómo transferir archivos a y desde VMs mediante SCP, consulta la sección Transferir archivos mediante la CLI de Google Cloud y la documentación de referencia de gcloud compute scp.

Trabajar con discos

En el siguiente ejemplo se muestra una tarea habitual al trabajar con discos. Para obtener más información sobre los discos, consulta las opciones de almacenamiento.

Mostrar discos

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

gcloud compute disks list

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

Trabajar con capturas

En los siguientes ejemplos se muestran tareas habituales al trabajar con copias de seguridad. Para obtener más información sobre las capturas, consulta el artículo sobre capturas de Persistent Disk.

Mostrar capturas

Ejecuta el siguiente comando para mostrar todas las copias de seguridad de un proyecto:

gcloud compute snapshots list

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

Describir capturas

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

gcloud compute snapshots describe SNAPSHOT_NAME

Sustituye SNAPSHOT_NAME por el nombre de la instantánea.

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

Eliminar instantáneas

Ejecuta el siguiente comando para eliminar una instantánea:

gcloud compute snapshots delete SNAPSHOT_NAME

Sustituye SNAPSHOT_NAME por el nombre de la instantánea.

Para obtener más información sobre cómo eliminar instantáneas, consulta el artículo Eliminar una instantánea y la documentación de referencia de gcloud compute snapshots delete.

Trabajar con reglas de cortafuegos

En los siguientes ejemplos se muestran tareas habituales al trabajar con reglas de cortafuegos. Para obtener más información sobre las reglas de cortafuegos, consulta la descripción general de las reglas de cortafuegos de VPC.

Describir reglas de cortafuegos

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

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

Sustituye FIREWALL_RULE_NAME por el nombre de la regla de firewall.

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

Crear reglas de cortafuegos

Ejecuta el siguiente comando para crear una regla de cortafuegos:

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

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

  • FIREWALL_RULE_NAME: el nombre de la regla de cortafuegos.
  • ACTION: la acción que se debe llevar a cabo cuando se encuentre una coincidencia. Puede ser allow o deny.
  • PROTOCOL:PORT: el protocolo y el puerto cuyo tráfico se verá afectado por la regla de cortafuegos.

Para obtener más información sobre cómo crear reglas de cortafuegos, consulta el artículo Crear reglas de cortafuegos y la documentación de referencia de gcloud compute firewall-rules create.

Trabajar con grupos de instancias gestionadas

En los siguientes ejemplos se muestran tareas habituales al trabajar con MIGs. Para obtener más información sobre los grupos de instancias gestionados, consulta Grupos de instancias gestionados.

Crear grupos de instancias gestionadas

Ejecuta el siguiente comando para crear un MIG:

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

Haz los cambios siguientes:

  • INSTANCE_GROUP_NAME: el nombre de este grupo de instancias
  • SIZE: el tamaño del grupo de instancias
  • INSTANCE_TEMPLATE_URL: la URL de la plantilla de instancia que quieres usar para crear VMs en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancia. Especifica uno de los siguientes valores:
    • En el caso de una plantilla de instancia regional, haz lo siguiente: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • En el caso de una plantilla de instancia global, haz lo siguiente: INSTANCE_TEMPLATE_ID

Para obtener más información sobre cómo crear MIGs, consulta los escenarios básicos para crear una MIG y la documentación de referencia de gcloud compute instance-groups managed create.

Configurar el autoescalado

Ejecuta el siguiente comando para configurar el autoescalado en un MIG en función del uso 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

Haz los cambios siguientes:

  • INSTANCE_GROUP_NAME: el nombre de un MIG
  • MAX_NUM_REPLICAS: número máximo 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

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

Trabajar con metadatos

En el siguiente ejemplo se muestra una tarea habitual al trabajar con metadatos. Para obtener más información sobre los metadatos, consulta Almacenar y obtener metadatos.

Añadir metadatos a nivel de proyecto

Ejecuta el siguiente comando para añadir metadatos a tu proyecto:

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

Haz los cambios siguientes:

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

Para obtener más información sobre cómo añadir metadatos a las VMs, consulta Configurar metadatos personalizados en todo el proyecto y la documentación de referencia de gcloud compute project-info add-metadata.

Añadir metadatos a nivel de instancia

Ejecuta el siguiente comando para añadir metadatos a una VM:

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

Haz los cambios siguientes:

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

Para obtener más información sobre cómo añadir metadatos a las VMs, consulta el artículo Definir metadatos de instancia y la documentación de referencia de 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 completa de todos los recursos y comandos sigue este patrón:

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

Para obtener ayuda rápida, puedes usar la marca -h en lugar de la marca --help. También puedes consultar toda la ayuda en la referencia de Google Cloud CLI.

Para obtener ayuda completa sobre los comandos específicos para configurar gcloud CLI, ejecuta lo siguiente:

gcloud topic TOPIC

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

Siguientes pasos