Gerenciar o ciclo de vida da instância de VM

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:

  1. Faça login e gere o arquivo kubeconfig para o servidor da API Management, se você não tiver um.

  2. Use o caminho para o arquivo kubeconfig do servidor de API Management para substituir MANAGEMENT_API_SERVER nestas 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 Paused ou Stopped.

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.

  1. Liste todas as VMs e confira o status de cada uma:

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

    Substitua as variáveis nos exemplos de código pelos seus próprios valores de acordo com a tabela a seguir.

    VariávelDefinição
    MANAGEMENT_API_SERVER O arquivo kubeconfig do servidor de API Management.
    PROJECT O 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         1d
    
  2. Receba 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_SERVER com o arquivo kubeconfig do servidor de API Management que você obteve do comando gdcloud auth login.
    • VM_NAME pelo nome da nova VM.
    • PROJECT pelo projeto do GDC em que a VM reside.

    Exemplo de saída mostrando os valores Reason e Message:

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

    Também é possível que os campos Reason e Message fiquem vazios. Isso indica que não havia nada para o sistema informar sobre eles.

    Exemplo de saída com Reason e Message vazios:

    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: