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 todo 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 durante o 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 em geral. Consulte estas páginas para interromper, redefinir ou excluir uma VM: