Neste documento, explicamos como verificar o status do sistema de uma instância de máquina virtual (VM) durante o ciclo de vida dela no Google Distributed Cloud (GDC) com isolamento físico.
Uma instância de VM pode passar por vários estados ao longo do ciclo de vida. Quando você cria uma VM, o Distributed Cloud provisiona recursos para iniciar a VM. Em seguida, a VM passa para o estado de início, em que é preparada para a primeira inicialização. Durante e após a inicialização, uma VM é considerada em execução. Durante todo o ciclo de vida, uma VM em execução pode ser interrompida e reiniciada ou suspensa e retomada repetidamente.
Este documento é destinado a desenvolvedores em grupos de administradores de plataforma ou operadores de aplicativos que analisam o status do sistema de instâncias de VM em um ambiente do Distributed Cloud. Para mais informações, consulte Públicos-alvo da documentação do GDC com isolamento físico.
Definições de status da VM
| Estado | Definição |
|---|---|
Pending |
A VM foi aceita pelo sistema e está aguardando alocação. |
Provisioning
|
Os recursos associados à VM, como
VirtualMachineDisk, estão sendo provisionados e preparados. |
Starting |
A VM está sendo preparada para execução. |
Running |
A VM está em execução. |
Stopping |
A VM está em processo de interrupção. |
Stopped |
A VM está parada e não deve ser iniciada. |
Paused
|
A VM é pausada e fica em um estado congelado, que é preservado. Não é possível acessar a VM. |
Terminating
|
A VM e os recursos associados estão passando pelo processo de exclusão. |
ErrorConfiguration
|
A VM tem um erro de configuração. Os estados de configuração inválidos podem ser causados pelo seguinte: |
MachineTypeNotFound: o tipo de VM a que a VM se refere não foi encontrado ou está sendo excluído. |
|
MachineDiskMisconfig: o disco da VM está configurado incorretamente. |
|
InterfaceCreationFailed: falha na criação da interface de rede. |
|
CrashLoopBackOff |
A VM está em um loop de falha e aguardando uma nova tentativa. |
PendingIPAllocation |
A VM está aguardando o sistema atribuir um endereço IP a ela. |
Unknown
|
Não foi possível acessar o estado da VM, geralmente devido a um erro na comunicação com o host em que ela está sendo executada. |
ErrorUnschedulable
|
Ocorreu um erro ao programar a VM, por exemplo, devido a solicitações de recursos ou restrições de programação que não podem ser atendidas ou aceitas. |
DiskError |
A VM tem um erro com um ou mais discos anexados. |
WaitingForDisk |
A VM está aguardando que um ou mais VirtualMachineDisk anexados fiquem prontos. |
CrashLoopBackoff |
A VM está falhando de forma consistente por algum motivo. |
Antes de começar
Para usar os comandos da interface de linha de comando (CLI) gdcloud, faça o download, instale
e configure a CLI gdcloud.
Todos os comandos do Distributed Cloud usam a CLI gdcloud ou
kubectl e exigem um ambiente de sistema operacional (SO).
Acessar o caminho do arquivo kubeconfig
Para executar comandos no servidor de API Management, verifique se você tem os seguintes recursos:
Faça login e gere o arquivo kubeconfig para o servidor da API Management, se você não tiver um.
Use o caminho para o arquivo kubeconfig do servidor de API Management para substituir
MANAGEMENT_API_SERVERnestas instruções.
Solicitar papéis do IAM
Entre em contato com o administrador do projeto do IAM para solicitar os seguintes papéis no projeto:
Administrador do projeto de máquina virtual (
project-vm-admin): criar, modificar, listar e excluir VMs no namespace do projeto.Leitor do projeto (
project-viewer): visualizar todos os recursos nos namespaces do projeto.
Todos os papéis de VM precisam ser vinculados ao namespace do projeto em que a VM reside. Siga as etapas para verificar seu acesso.
Verificar o status da VM
Cada VM informa seu status como parte das propriedades da VM. Verifique o status de uma VM por qualquer um dos seguintes motivos:
- Se houver problemas com a VM.
- Para confirmar se a VM está em execução depois de iniciada.
- Para verificar se a VM está no estado
PausedouStopped.
Listar VMs para verificar o status
O procedimento a seguir mostra como listar VMs, visualizar o status delas e receber mais informações de status.
Liste todas as VMs e confira o status de cada uma:
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ get virtualmachines.virtualmachine.gdc.googSubstitua as variáveis nos exemplos de código pelos seus próprios valores de acordo com a tabela a seguir.
Variável Definição MANAGEMENT_API_SERVERO arquivo kubeconfig do servidor de API Management. PROJECTO projeto do GDC em que a VM reside. Exemplo de saída:
NAME STATUS AGE vm-1 Running 1d vm-2 Stopped 8d vm-3 ErrorConfiguration 1dReceba mais detalhes sobre o status de uma VM específica:
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"}'Substitua:
MANAGEMENT_API_SERVERcom o arquivo kubeconfig do servidor de API Management que você obteve do comandogdcloud auth login.VM_NAMEpelo nome da nova VM.PROJECTpelo projeto do GDC em que a VM reside.
Exemplo de saída mostrando os valores
ReasoneMessage:State: ErrorConfiguration Reason: MachineDiskNotFound Message: VirtualMachineDisk disk-1 in namespace project-1 does not exist.Também é possível que os campos
ReasoneMessagefiquem vazios. Isso indica que não havia nada para o sistema informar sobre eles.Exemplo de saída com
ReasoneMessagevazios:State: Running Reason: Message:
Interromper ou reiniciar uma VM
Durante o ciclo de vida da VM, talvez seja necessário interromper e reiniciar uma VM ou excluir uma VM para responder a uma mudança de status ou gerenciar a VM de modo geral. Consulte estas páginas para interromper, redefinir ou excluir uma VM: