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:
Inicia sesión y genera el archivo kubeconfig para el servidor de la API Management si no tienes uno.
Usa la ruta al archivo kubeconfig del servidor de la API Management para sustituir
MANAGEMENT_API_SERVERen 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
PausedoStopped.
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.
Muestra todas las VMs y el estado de cada una:
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ get virtualmachines.virtualmachine.gdc.googSustituye las variables de los ejemplos de código por tus propios valores según la siguiente tabla.
Variable Definición MANAGEMENT_API_SERVEREl archivo kubeconfig del servidor de la API Management. PROJECTEl proyecto de GDC en el que reside la VM. Ejemplo:
NAME STATUS AGE vm-1 Running 1d vm-2 Stopped 8d vm-3 ErrorConfiguration 1dObtener 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_SERVERcon el archivo kubeconfig del servidor de la API Management que has obtenido con el comandogdcloud auth login.VM_NAMEpor el nombre de la nueva máquina virtual.PROJECTcon el proyecto de GDC en el que reside la VM.
Ejemplo de salida que muestra los valores
ReasonyMessage:State: ErrorConfiguration Reason: MachineDiskNotFound Message: VirtualMachineDisk disk-1 in namespace project-1 does not exist.También puede que los campos
ReasonyMessageestén vacíos. Esto indica que el sistema no ha podido registrar nada sobre ellos.Ejemplo de resultado con
ReasonyMessagevací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: