Erros Comuns e Como Mitigá-los
Descrição e sintomas
Esta seção descreve erros comuns que você pode encontrar ao utilizar imagens na Magalu Cloud (MGC), juntamente com suas causas prováveis. Entender esses problemas te ajudará a resolver as falhas rapidamente e garantir o correto funcionamento das suas máquinas virtuais.
Solução
| Erro | Causa Provável | Como Mitigar |
|---|---|---|
| Formato inválido | Imagem não está em QCOW2 | Converter com qemu-img convert antes do upload. |
| Limite de tamanho excedido | Arquivo maior que 25 GB | Reduzir o tamanho do disco virtual e remover dados desnecessários. |
| Upload falha / timeout | Imagem muito grande ou conexão instável | Validar conectividade e tentar novamente. Considere reduzir a imagem. |
| Falha no primeiro boot | Drivers faltando ou cloud-init incorreto | Testar em sandbox, manter SO vanilla e garantir suporte ao cloud-init. |
| SSH: public key permission denied | Arquivo authorized_keys pré-existente na imagem | Remover ~/.ssh/authorized_keys de todos os usuários antes de capturar a imagem. |
| VM inacessível após boot | Rede estática ou MAC fixo configurado | Garantir DHCP e remover MACs fixos dos arquivos de configuração de rede. |
| Erros no cloud-init | Datasources de outros providers configurados | Remover arquivos em /etc/cloud/cloud.cfg.d/ antes de capturar a imagem. |
| Image name already exists | Nome duplicado no tenant | Escolher um nome único. Nomes devem conter apenas letras, números, traços e underscores. |
| VM rejeitada pelo Terraform | machine_type abaixo dos requisitos mínimos da imagem | Escolher um machine_type que atenda às exigências de vCPU, RAM e disco definidas na imagem. |
Perguntas frequentes
Posso usar qualquer formato de imagem?
Não. A Magalu Cloud suporta apenas imagens no formato QCOW2. Se sua imagem estiver em outro formato, você precisará convertê-la usando o comando qemu-img convert antes do upload.
Qual o tamanho máximo permitido para uma imagem?
O tamanho máximo de uma imagem é 25 GB. Se a sua imagem for maior que isso, você precisará reduzir seu tamanho removendo dados desnecessários ou otimizando o disco virtual.
Como posso resolver problemas de conexão SSH após o upload da imagem?
Verifique se o arquivo ~/.ssh/authorized_keys não existe dentro da imagem. Se existir, remova-o antes de capturar a nova imagem para evitar problemas de permissão ao acessar via SSH.
O que devo fazer se minha VM não estiver acessível após o boot?
Certifique-se de que sua rede esteja configurada para usar DHCP e que você removeu quaisquer configurações de MAC fixo dos arquivos de configuração de rede da imagem.