Gerenciar VMs do Arc no Azure Stack HCI

  • Artigo

Aplica-se a: Azure Stack HCI, versão 23H2

Este artigo descreve como gerenciar VMs (máquinas virtuais) arc em execução no Azure Stack HCI, versão 23H2. Os procedimentos para habilitar o gerenciamento de convidados, iniciar, parar, reiniciar ou excluir uma VM do Arc são detalhados.

Pré-requisitos

Antes de iniciar, cumpra os seguintes pré-requisitos:

  1. Verifique se você tem acesso a um cluster do Azure Stack HCI implantado e registrado. Durante a implantação, uma Ponte de Recursos do Arc e um local personalizado também são criados.

    Vá para o grupo de recursos no Azure. Você pode ver o local personalizado e a Ponte de Recursos do Azure Arc criada para o cluster do Azure Stack HCI. Anote a assinatura, o grupo de recursos e o local personalizado conforme você os usa posteriormente neste cenário.

  2. Verifique se você tem uma ou mais VMs arc em execução neste cluster do Azure Stack HCI. Para obter mais informações, consulte Create VMs do Arc no Azure Stack HCI.

Habilitar o gerenciamento de convidados

Depois de criar uma VM, você deseja habilitar o gerenciamento de convidados nessa VM.

Há dois agentes que são importantes para entender no contexto do gerenciamento de convidados: um agente convidado de VM e um agente do Azure Connected Machine. Cada VM arc criada por meio de portal do Azure ou CLI do Azure é provisionada com um agente convidado (também chamado mocguestagentde ) nela.

Quando você habilita o gerenciamento de convidados em uma VM Arc, o agente convidado instala o agente do Azure Connected Machine. O agente do Azure Connected Machine permite que você gerencie extensões de VM do Azure Arc em sua VM do Azure Stack HCI.

Com base em se um agente convidado está em execução em sua VM Arc, as etapas para habilitar o gerenciamento de convidados são diferentes.

Importante

Verifique se o cluster do Azure Stack HCI está executando o 2311 ou posterior para executar esse procedimento.

Verificar se o agente convidado está em execução

  1. Para verificar se o agente convidado está em execução na VM arc, conecte-se ao servidor Azure Stack HCI.

  2. Execute o comando a seguir:

    az stack-hci-vm show --name "<VM name>" --resource-group "<Resource group name>"

    Aqui está um snippet da saída de exemplo que indica que o agente convidado está em execução. Procure statuses abaixo de vmAgent na saída.

    "instanceView": {
  "vmAgent": {
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "displayStatus": "Connected",
        "level": "Info",
        "message": "Successfully established connection with mocguestagent",
        "time": "2024-01-13T00:57:39Z"
      },
      {
        "code": "ProvisioningState/succeeded",
        "displayStatus": "Connected",
        "level": "Info",
        "message": "New mocguestagent version detected 'v0.13.0-3-gd13b4794",
        "time": "2024-01-13T00:57:39Z"
      }
    ],
    "vmConfigAgentVersion": "v0.13.0-3-gd13b4794"
  }
}

    O agente convidado está em execução:

    • Quando statuses indicar code como ProvisioningState/succeeded e como displayStatusConnected.
    • Se executasse uma versão mais antiga, o statuses indicaria code como OK e o displayStatus como Active

Se seus status não corresponderem à saída acima, siga as etapas em Habilitar o gerenciamento de convidados quando o agente convidado não estiver em execução.

Habilitar o gerenciamento de convidados em uma VM com o agente convidado em execução

Para habilitar o gerenciamento de convidados em uma VM arc que tenha o agente convidado em execução, execute o seguinte comando:

az stack-hci-vm update --name "myhci-vm" --enable-agent true --resource-group "myhci-rg"

O gerenciamento de convidado é habilitado definindo como enable-agent parametertrue. O gerenciamento de convidados deve levar alguns minutos para ser habilitado.

Siga as etapas para verificar se o gerenciamento de convidado está habilitado no portal do Azure.

Habilitar o gerenciamento de convidados em uma VM quando o agente convidado não estiver em execução

Há dois cenários em que o agente convidado não está em execução : quando os status estão se conectando e quando os status estão em branco. Cada um desses cenários e as etapas correspondentes são descritos nas seções a seguir.

Status exibido como conexão

Seu status é mostrado como se conectando. Aqui está um snippet de saída de exemplo que indica o status necessário.

"instanceView": {
      "vmAgent": {
        "statuses": [
          {
            "code": "ProvisioningState/InProgress",
            "displayStatus": "Connecting",
            "level": "Info",
            "message": "Waiting for connection with mocguestagent",
            "time": "2024-01-19T01:41:15Z"
          }
        ]
      }
    },

O agente convidado não está em execução quando:

  • O agente convidado não está em execução quando indica como e como ConnectingdisplayStatus .ProvisioningState/InProgresscodestatuses
  • Se executasse uma versão mais antiga, o indicaria como , como displayStatusActivee message como Successfully started HyperV listener.OKcodestatuses

Siga estas etapas:

  1. Conecte-se à VM usando as etapas específicas do sistema operacional. Execute o PowerShell como administrador.

  2. Execute um dos seguintes comandos para habilitar o agente convidado em sua VM com base no tipo de sistema operacional:

    Linux:

    sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /mociso && bash /mociso/install.sh && umount /mociso && rm -df /mociso && eject LABEL=mocguestagentprov'

    Windows:

    $d=Get-Volume -FileSystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install.ps1';powershell $p

    Aqui está uma saída de exemplo para uma VM linux que mostra que o agente convidado foi instalado com êxito.

    Captura de tela mostrando que o agente convidado está habilitado com êxito na VM.

  3. Conecte-se a um dos servidores do Azure Stack HCI. Execute o comando a seguir para habilitar o gerenciamento de convidados.

    az stack-hci-vm update --name "myhci-vm" --enable-agent true --resource-group "myhci-rg"

Siga as etapas para verificar se o gerenciamento de convidado está habilitado no portal do Azure.

Status exibido como nulo

Seu status é mostrado como nulo. Isso indica que o iso necessário para o agente convidado está ausente. Aqui está um snippet de saída de exemplo que indica o status nulo.

"instanceView": {
      "vmAgent": {
        "statuses": []
      }
    },

Siga estas etapas:

  1. Conecte-se ao servidor Azure Stack HCI.

  2. Execute o comando a seguir:

    az stack-hci-vm update --name "<VM Name>" --resource-group "<Resource group name>" --enable-vm-config-agent true

    O enable-vm-config-agent parâmetro monta o iso necessário para o agente convidado.

  3. Aguarde alguns minutos e execute novamente o az stack-hci-vm show comando. Quando o status for exibido como connecting, siga as etapas em Status exibidas como conexão.

Verifique se o gerenciamento de convidados está habilitado no portal do Azure

  1. Acesse o portal do Azure.

  2. Navegue até Suas máquinas virtuais de cluster > do Azure Stack HCI e selecione a VM na qual você habilitou o gerenciamento de convidados.

  3. Na página Visão geral , na guia Propriedades no painel direito, vá para Configuração. O gerenciamento de convidado deve ser mostrado como Habilitado (Conectado).

    Captura de tela mostrando como Create uma VM usando a imagem de VM do Windows.

Exibir propriedades da VM

Siga estas etapas no portal do Azure do sistema Azure Stack HCI para exibir as propriedades da VM.

  1. Vá para o recurso de cluster do Azure Stack HCI e vá para Máquinas virtuais.

  2. No painel direito, na lista de máquinas virtuais, selecione o nome da VM cujas propriedades você deseja exibir.

    Captura de tela da VM selecionada na lista de VMs.

  3. Na página Visão geral , vá para o painel direito e vá para a guia Propriedades . Você pode exibir as propriedades da VM.

    Captura de tela das propriedades da VM do Arc selecionada.

Iniciar uma VM

Siga estas etapas no portal do Azure do sistema Azure Stack HCI para iniciar uma VM.

  1. Vá para o recurso de cluster do Azure Stack HCI e vá para Máquinas virtuais.

  2. No painel direito, na lista de máquinas virtuais, selecione uma VM que não está em execução e você deseja iniciar.

  3. Na página Visão geral da VM, na barra de comandos superior no painel direito, selecione Iniciar e, em seguida, selecione Sim.

  4. Verifique se a VM foi iniciada.

    Captura de tela da seleção + iniciar VM.

Parar uma VM

Siga estas etapas no portal do Azure do sistema Azure Stack HCI para interromper uma VM.

  1. Vá para o recurso de cluster do Azure Stack HCI e vá para Máquinas virtuais.

  2. No painel direito, na lista de máquinas virtuais, selecione uma VM em execução e você deseja parar.

  3. Na página Visão geral da VM, na barra de comandos superior no painel direito, selecione Parar e, em seguida, selecione Sim.

  4. Verifique se a VM foi interrompida.

    Captura de tela de selecionar + parar VM.

Reiniciar uma VM

Siga estas etapas no portal do Azure do sistema Azure Stack HCI para reiniciar uma VM.

  1. Vá para o recurso de cluster do Azure Stack HCI e vá para Máquinas virtuais.

  2. No painel direito, na lista de máquinas virtuais, selecione uma VM interrompida e você deseja reiniciar.

  3. Na página Visão geral da VM, na barra de comandos superior no painel direito, selecione Reiniciar e, em seguida, selecione Sim.

  4. Verifique se a VM foi reiniciada.

    Captura de tela de selecionar + reiniciar VM.

Excluir uma VM

Siga estas etapas no portal do Azure do sistema Azure Stack HCI para remover uma VM.

  1. Acesse o recurso de cluster do Azure Stack HCI e vá para Máquinas virtuais.

  2. No painel direito, na lista de máquinas virtuais, selecione uma VM que você deseja remover do sistema.

  3. Na página Visão geral da VM, na barra de comandos superior no painel direito, selecione Excluir e, em seguida, selecione Sim.

    Agora você será solicitado a confirmar a exclusão. Selecione Sim. Verifique se a VM foi removida.

    Observe que, quando uma VM é excluída, todos os recursos associados à VM não são excluídos. Por exemplo, os discos de dados ou os adaptadores de rede associados à VM não são excluídos. Você precisa localizar e excluir esses recursos separadamente.

    Captura de tela do aviso ao excluir a VM.

  4. Agora você pode ir para o grupo de recursos em que essa VM foi implantada. Você pode ver que a VM foi removida da lista de recursos no grupo de recursos. Talvez seja necessário selecionar a opção Mostrar tipos ocultos para exibir os recursos associados a essa VM que não foram excluídos.

    Captura de tela dos recursos de tipos ocultos associados a uma máquina virtual.

Localize os recursos associados, como interfaces de rede e discos de dados, e exclua-os.

Alterar núcleos e memória

Siga estas etapas no portal do Azure do sistema Azure Stack HCI para alterar núcleos e memória.

  1. Acesse o recurso de cluster do Azure Stack HCI e vá para Máquinas virtuais.

  2. Na lista de VMs no painel direito, selecione e vá para a VM cujos núcleos e memória você deseja modificar.

  3. Em Configurações, selecione Tamanho. Edite a contagem de processadores virtuais ou memória (MB) para alterar os núcleos e o tamanho da memória da VM. Somente o tamanho da memória pode ser alterado. O tipo de memória não pode ser alterado depois que uma VM é criada.

    Captura de tela da página Tamanho de uma VM.

Próximas etapas