Resize de instância
O resize corresponde à alteração do tipo da instância (machine-type), permitindo ajustar os recursos vCPU, memória RAM e capacidade de disco de acordo com a necessidade da carga de trabalho.
Durante o processo de resize, a instância é desligada temporariamente para que as alterações sejam aplicadas com segurança na camada de infraestrutura e, ao final, é ligada novamente utilizando o novo machine-type selecionado. Esse procedimento provoca indisponibilidade temporária da instância (downtime), cujo tempo total pode variar de acordo com o tamanho da instância, a região e a necessidade de realocação entre hosts físicos.
Sobre os termos resize e retype
Na Magalu Cloud, o redimensionamento de uma instância é chamado de resize no console e de retype na CLI e na API. Apesar da diferença de nomenclatura, resize e retype representam a mesma operação. Ao longo da documentação, os termos podem aparecer de forma intercambiável (assim como "redimensionamento"), sempre com o mesmo significado.
Pré-requisitos e limitações do resize
Antes de realizar o resize de uma instância, considere as seguintes regras e restrições:
-
vCPU e memória RAM podem ser aumentadas ou reduzidas. Já a capacidade de disco não pode ser reduzida, apenas mantida ou aumentada.
- Exemplo permitido:
BV2-2-40→BV1-1-40 - Exemplo não permitido:
BV2-2-40→BV2-2-20
- Exemplo permitido:
-
Não é possível realizar resize de instâncias que estejam com criação de snapshot em andamento.
-
A instância precisa estar disponível para operação, em estado
runningoustopped, e não pode estar executando outra ação no momento (como um resize em andamento). -
Durante o redimensionamento, a instância será desligada temporariamente, mesmo quando o resize for iniciado a partir do estado
running, para garantir a consistência e segurança da operação.
Em alguns cenários, um reboot da instância pode ajudar a recuperar o acesso ou normalizar o estado. Saiba mais na seção Troubleshooting - Reboot como tentativa de recuperação
Expansão de disco e filesystem após o resize:
Ao realizar o resize de uma instância, a capacidade do disco é atualizada na camada de infraestrutura. No entanto, para que o novo espaço fique disponível, é necessário que o filesystem da instância seja expandido.
Em condições normais, essa expansão ocorre automaticamente durante o processo de inicialização da instância após o resize. Porém, em cenários onde o disco está completamente cheio (100% de uso), essa expansão não ocorre automaticamente e pode impactar a inicialização de serviços como o acesso SSH.
Nesses casos, é necessário liberar espaço em disco e realizar a expansão do filesystem manualmente dentro da instância.
Recomenda-se manter uma margem de espaço livre em disco para evitar impactos no processo de inicialização e garantir que operações como o resize ocorram corretamente.
Em caso de dúvidas ou dificuldades, entre em contato com o suporte.
Como realizar o resize da instância
Após validar os pré-requisitos e limitações descritos acima, siga um dos métodos abaixo para realizar o resize da instância:
- 🖥️ Console
- >_ CLI
Na listagem de instâncias da página de Virtual Machines:
-
Clique no menu da instância que deseja alterar o tipo de instância
-
Clique em "Resize da instância"
-
Escolha o novo tipo de instância que deseja
O novo tipo de instância precisa necessariamente ter o disco local com tamanho igual ou maior ao do disco anterior.
Neste modelo é utilizado o nome da instância com a flag --machine-type.name
mgc virtual-machine instances retype --id="id_instance" --machine-type.name cloud-gp1.large
Neste modelo é utilizado o id da instância com a flag --machine-type.id
mgc virtual-machine instances retype --id="id_instance" --machine-type.id="id_type_machine"
Flags
Tabela com explicação sobre as flags utilizadas no comando:
| Name | Type | Description | Required |
|---|---|---|---|
| id | string | O id da instância | Yes |
| machine-type.id | string | O ID do tipo de máquina | No |
| machine-type.name | string | O nome do tipo de máquina | No |
Regras
- A instância deve estar no estado em execução ou parada.
- O novo tipo de máquina deve ser compatível com o tipo de máquina atual.
- O novo tipo de máquina deve estar disponível na mesma região que o tipo de máquina atual.
- Você deve fornecer o ID do tipo de máquina ou o nome do tipo de máquina; se fornecer ambos, o ID do tipo de máquina será usado.