Como gerenciar os discos e os recursos computacionais da VM

Um disco de VM é um volume ZFS em um pool de armazenamento mais um registro da sua conexão com a VM: slot, tamanho de setor, limites de E/S e um rótulo opcional. Há cinco slots. O slot determina a ordem dos dispositivos para o guest, por isso ele é especificado explicitamente ou o vStack Center seleciona o primeiro disponível.

As operações com discos se dividem em dois grupos. Algumas exigem o controlador de armazenamento e, portanto, não são imediatas: criar, expandir e excluir um volume. Outras alteram apenas registros e limites: entram em vigor imediatamente se a VM estiver parada e são enviadas ao nó se ela estiver em execução.

Os recursos computacionais são mais simples. A quantidade de vCPUs, o tamanho da RAM, o nome, a descrição e a mídia de inicialização são editados em um único formulário no cartão da VM. A prioridade e a classe de vCPU afetam a forma como o escalonador do nó divide o tempo de CPU entre as VMs. O ballooning altera a quantidade de memória que o guest devolve ao hipervisor, sem reinicialização.

As alterações de vCPU e RAM são salvas na configuração de referência e enviadas ao agente, mas o guest só vê os novos valores após uma reinicialização. A edição desses valores não reinicia a VM por si só.

Os discos aparecem na seção Disks do cartão da VM: uma tabela com as colunas Name, Slot, Disk size (GB), Sector size, IOps limit e MBps limit, além do botão Add disk. O nome, a descrição, CPU (Cores) e RAM são editados no formulário na parte superior do cartão e salvos com Save changes.

Como adicionar um disco

Acesso: o Cluster master pode acessar qualquer VM; um usuário comum pode acessar as VMs dos seus VDCs (data centers virtuais).

1. Defina o tamanho. O intervalo vai de 1 GB a 2 TB, e o tamanho deve ser múltiplo dos tamanhos de setor lógico e físico.

2. Na seção Disks do cartão da VM, clique em Add disk e preencha o formulário. Se nenhum slot for especificado explicitamente, o vStack Center selecionará o primeiro disponível:

   Campo	Valor
   Disk size	De 1 GB a 2 TB
   Slot	1–5; se omitido, um slot disponível é selecionado automaticamente
   Sector size	Tamanhos lógico e físico: 512 ou 4096 bytes; os padrões são lógico 512 e físico 4096; o tamanho lógico não pode exceder o físico
   MBps limit	Limite de taxa de transferência
   IOps limit	Limite de operações por segundo
   Name (rótulo)	Até 127 caracteres

3. Aguarde até que o disco apareça na tabela Disks. O tamanho, o slot, o tamanho de setor e os limites também são exibidos ali.

Falhas e soluções:

Falha	Motivo	Solução
-3408 Minimal size of new disk is 1GB	O tamanho é menor que 1 GB	Aumente o tamanho
-3409 New disk size exceeds 2TB	O tamanho excede 2 TB	Divida os dados entre vários discos
-3410, -3411	O tamanho não é múltiplo do tamanho de setor lógico ou físico	Arredonde o tamanho para um múltiplo do tamanho de setor
-3412	O setor lógico é maior que o setor físico	Altere os parâmetros de setor
-3430, -3444 no available slots	Todos os cinco slots estão ocupados	Libere um slot ou use outro disco
-3445 Slot N occupied already	O slot selecionado está ocupado	Deixe o slot em branco para que o vStack Center selecione um disponível
-3442, -3443 slot out of range	O slot está fora do intervalo 1–5	Especifique um slot dentro do intervalo
-3423 VM v3 should be upgraded first	A versão da configuração da VM é 3	Atualize a versão da configuração da VM
-3447 vDC storage quota depleted	O disco não cabe na cota do VDC	Aumente a cota ou reduza o tamanho do disco
-3448 VM is locked	Outra operação está em andamento	Aguarde a conclusão

Como expandir um disco

Um disco só pode ser expandido. A redução não é suportada: o novo tamanho deve ser maior que o tamanho atual, em incrementos de 1 MB. Defina o novo tamanho do disco desejado na seção Disks do cartão da VM.

Falhas típicas: -7126 significa que o novo tamanho não é maior que o atual, -7127 significa que o tamanho não é múltiplo de 1 MB, -7147 significa que a cota de armazenamento do VDC está esgotada, -7124 significa que a VM não tem esse disco, e -7128 significa que a VM está bloqueada por outra operação.

Expandir um volume não expande o sistema de arquivos dentro do guest. Use as ferramentas do sistema operacional guest para fazer isso depois que o disco for expandido.

Como excluir um disco

A exclusão de um disco exige que a VM esteja parada: o erro -4424, "vm id==N must be stopped in order to remove disk", significa exatamente isso. Pare a VM e exclua o disco na seção Disks do cartão dela.

Um disco retido por um snapshot é um caso especial. O vStack Center não exclui o volume; ele o marca como retido e não envia o comando ao controlador de armazenamento. O espaço é liberado quando o snapshot é excluído. Outras falhas: -4433 significa que o pool da VM não aceita dados, -4430 significa que a VM está bloqueada, e -4423 significa que a versão da configuração da VM não suporta a operação.

Como definir o rótulo e os limites de um disco

O rótulo é um nome de disco definido pelo usuário, exibido na coluna Name da seção Disks. Um valor vazio remove o rótulo. É necessário um papel no VDC com role_id ≤ 2 ou o papel VM Developer (7). Um rótulo com mais de 127 caracteres é rejeitado com o erro -4047.

Os limites de E/S são definidos nos campos MBps limit e IOps limit do disco desejado. Defina pelo menos um deles; caso contrário, a operação é rejeitada com o erro -7318.

Para uma VM parada, o limite entra em vigor imediatamente. Para uma VM em execução, o comando é enviado ao nó, e é possível um sucesso parcial: "Ratelimit has been set (DB), but agent didn't apply it". Isso significa que o valor foi salvo na configuração, mas o hipervisor não o aceitou. O limite entra em vigor na próxima inicialização da VM. Outras falhas: -7324 significa que a VM não tem esse disco, -7323 significa versão de configuração 3, e -7328 significa que a VM está bloqueada.

Como alterar vCPU, RAM, nome e mídia de inicialização

Todas essas configurações são editadas no formulário na parte superior do cartão da VM: Name, Description, CPU (Cores), RAM (em GB) e a lista de mídias de inicialização, em que none significa que nenhuma mídia está conectada. Aplique as alterações com Save changes, que fica disponível quando o formulário tem edições. Acesso: o Cluster master tem acesso total; um usuário comum precisa de um papel com role_id ≤ 2 ou VM Developer (7) no VDC da VM.

Campo	Limite
CPU (Cores)	De 1 até o máximo definido no cluster
RAM	Mínimo de 512 MB; o máximo é definido no cluster
Name	Novo nome da VM
Description	Descrição; um valor vazio a remove
Mídia de inicialização	Um valor da lista de mídias do cluster; none significa nenhuma mídia

Detalhes que você deve conhecer com antecedência:

• Editar o formulário não bloqueia a VM. Duas edições consecutivas não bloqueiam uma à outra, mas também não são enfileiradas. Não salve o formulário de dois lugares ao mesmo tempo.
• O erro -3233, "ram param value is out of range", significa que o tamanho da memória está fora do intervalo permitido.
• -3223 significa que a quantidade de vCPUs está fora do intervalo do cluster, -3244 significa que a mídia de inicialização selecionada não existe, e -3219 significa que a VM está bloqueada por outra operação.

Como alterar a memória de uma VM em execução

O ballooning devolve parte da memória do guest ao hipervisor sem reinicialização: você especifica um tamanho de destino, e o valor zero remove o limite. Funciona apenas para VMs com o ballooning habilitado na configuração.

O erro -15412 significa que o ballooning não está habilitado para a VM. Nesse caso, a memória só pode ser alterada pelo formulário no cartão e com uma reinicialização. O erro -15015 significa que a VM está bloqueada por outra operação.

Como alterar a prioridade e a classe de vCPU

Nenhuma das duas configurações bloqueia a VM, e ambas funcionam em dois modos: para uma VM desligada, atualizam a configuração diretamente; para uma VM em execução, enviam o valor ao nó.

A prioridade de CPU define o peso da VM para o escalonador do nó; o intervalo permitido é 1–20. Para uma VM desligada, o vStack Center informa explicitamente que a alteração foi aplicada diretamente porque a VM não está em execução.

A classe de vCPU aparece na coluna vCPU class da lista de VMs. Apenas o papel Cluster master pode alterá-la: os privilégios Set VM vCPU Class (1603) e Set VM Reserved vCPU Class (1606) são atribuídos somente a esse papel; os demais papéis recebem -403. O primeiro privilégio permite valores de 1 a 5, e o segundo permite 0. Uma tentativa de ficar abaixo do mínimo permitido é rejeitada com o erro -5110.

Se a VM parar enquanto o comando está sendo enviado, a alteração é considerada aplicada: o vStack Center trata essa resposta do agente como sucesso — a classe de vCPU foi alterada enquanto a VM não estava em execução.

Veja também

• Como conectar uma VM a uma rede — interfaces de rede e seus limites
• Como criar snapshots de VM e reverter para eles — o que retém um disco e por que ele não pode ser excluído

Métodos da API

As operações da API desta página são vms-add-disk, vms-disk-resize, vm-remove-disk, vm-disk-set-label, vm-ratelimit-disk, vm-set, vm-boot_media-list, vms-balloon, vms-cpu-priority e vms-vcpu-class — consulte a referência da API.