Gestionar el ciclo de vida de una instancia de VM

En este documento se explica cómo comprobar el estado del sistema de una instancia de máquina virtual (VM) a lo largo de su ciclo de vida en Google Distributed Cloud (GDC) aislado.

Una instancia de VM puede pasar por muchos estados a lo largo de su ciclo de vida. Cuando creas una VM, Distributed Cloud aprovisiona recursos para iniciarla. A continuación, la VM pasa al estado de inicio, donde se prepara para el primer arranque. Durante el inicio y después de este, se considera que la VM está en ejecución. Durante su ciclo de vida, una VM en ejecución se puede detener y reiniciar, o suspender y reanudar, varias veces.

Este documento está dirigido a desarrolladores de grupos de administradores de plataformas u operadores de aplicaciones que revisan el estado del sistema de instancias de VM en un entorno de Distributed Cloud. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Definiciones de estados de máquinas virtuales

Estado Definición
Pending El sistema acepta la máquina virtual y está esperando a que se asigne.
Provisioning Se están aprovisionando y preparando los recursos asociados a la máquina virtual, como VirtualMachineDisk.
Starting La máquina virtual se está preparando para ejecutarse.
Running La VM se está ejecutando.
Stopping La máquina virtual se está deteniendo.
Stopped La VM se ha detenido y no se espera que se inicie.
Paused La VM se pausa y se congela, y se conserva su estado. No se puede acceder a la VM.
Terminating La VM y sus recursos asociados se están eliminando.
ErrorConfiguration La VM tiene un error de configuración. Los estados de configuración no válidos pueden deberse a lo siguiente:
MachineTypeNotFound: no se encuentra el tipo de VM al que hace referencia la VM o se está eliminando.
MachineDiskMisconfig: el disco de la VM no está configurado correctamente.
InterfaceCreationFailed: no se ha podido crear la interfaz de red.
CrashLoopBackOff La VM está en un bucle de fallos y está esperando a que se vuelva a intentar.
PendingIPAllocation La VM está esperando a que el sistema le asigne una dirección IP.
Unknown No se ha podido obtener el estado de la máquina virtual, normalmente debido a un error de comunicación con el host en el que se está ejecutando.
ErrorUnschedulable Se ha producido un error al programar la máquina virtual, por ejemplo, debido a solicitudes de recursos o restricciones de programación que no se pueden satisfacer o no se admiten.
DiskError La máquina virtual tiene un error con uno o varios de los discos asociados.
WaitingForDisk La VM está esperando a que uno o varios de los VirtualMachineDisk conectados estén listos.
CrashLoopBackoff La VM ha fallado de forma constante por algún motivo.

Antes de empezar

Para usar los comandos de la interfaz de línea de comandos (CLI) de gdcloud, asegúrate de haber descargado, instalado y configurado la CLI de gdcloud. Todos los comandos de Distributed Cloud usan la CLI gdcloud o kubectl y requieren un entorno de sistema operativo (SO).

Obtener la ruta del archivo kubeconfig

Para ejecutar comandos en el servidor de la API Management, asegúrate de que tienes los siguientes recursos:

  1. Inicia sesión y genera el archivo kubeconfig para el servidor de la API Management si no tienes uno.

  2. Usa la ruta al archivo kubeconfig del servidor de la API Management para sustituir MANAGEMENT_API_SERVER en estas instrucciones.

Solicitar roles de gestión de identidades y accesos

Ponte en contacto con el administrador de proyectos de gestión de identidades y accesos para solicitar los siguientes roles en tu proyecto:

  • Administrador de proyectos de máquinas virtuales (project-vm-admin): crea, modifica, muestra y elimina máquinas virtuales en el espacio de nombres del proyecto.

  • Lector de proyectos (project-viewer): permite ver todos los recursos de los espacios de nombres del proyecto.

Todos los roles de VM deben vincularse al espacio de nombres del proyecto en el que reside la VM. Sigue los pasos para verificar tu acceso.

Comprobar el estado de la máquina virtual

Cada VM informa de su estado como parte de sus propiedades. Comprueba el estado de una VM por cualquiera de los siguientes motivos:

  • Si hay problemas con la máquina virtual.
  • Para confirmar que la VM se está ejecutando después de que se haya iniciado.
  • Para verificar que la VM está en el estado Paused o Stopped.

Mostrar las VMs para comprobar su estado

En el siguiente procedimiento se muestra cómo ver una lista de las máquinas virtuales, su estado y más información sobre su estado.

  1. Muestra todas las VMs y el estado de cada una:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      get virtualmachines.virtualmachine.gdc.goog
    

    Sustituye las variables de los ejemplos de código por tus propios valores según la siguiente tabla.

    VariableDefinición
    MANAGEMENT_API_SERVER El archivo kubeconfig del servidor de la API Management.
    PROJECT El proyecto de GDC en el que reside la VM.

    Ejemplo:

    NAME          STATUS                    AGE
    vm-1          Running                    1d
    vm-2          Stopped                    8d
    vm-3          ErrorConfiguration         1d
    
  2. Obtener más información sobre el estado de una VM concreta:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      get virtualmachines.virtualmachine.gdc.goog VM_NAME \
      -o jsonpath='{"State:"}{.status.state}{"\n"}{"Reason:"}{.status.reason}{"\n"}{"Message:"}{.status.message}{"\n"}'
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER con el archivo kubeconfig del servidor de la API Management que has obtenido con el comando gdcloud auth login.
    • VM_NAME por el nombre de la nueva máquina virtual.
    • PROJECT con el proyecto de GDC en el que reside la VM.

    Ejemplo de salida que muestra los valores Reason y Message:

    State: ErrorConfiguration
    Reason: MachineDiskNotFound
    Message: VirtualMachineDisk disk-1 in namespace project-1 does not exist.
    

    También puede que los campos Reason y Message estén vacíos. Esto indica que el sistema no ha podido registrar nada sobre ellos.

    Ejemplo de resultado con Reason y Message vacíos:

    State: Running
    Reason:
    Message:
    

Detener o reiniciar una VM

Durante el ciclo de vida de la VM, puede que tengas que detenerla y reiniciarla, o eliminarla para responder a un cambio de estado o, en general, para gestionarla. Consulta estas páginas para detener, restablecer o eliminar una VM: