Skip to main content

Guia de Boas Práticas: Importação de Imagens Customizadas

Introdução

Uma imagem de cloud é um modelo de sistema operacional usado para criar múltiplas instâncias de máquina virtual. Diferente de uma instalação tradicional, ela é uma base limpa e generalizada (padronizada para replicação) que se adapta automaticamente na primeira inicialização através de ferramentas como o cloud-init.

Aqui, reunimos as boas práticas recomendadas pela Magalu Cloud para criação e importação de imagens customizadas. O objetivo é manter suas imagens seguras, enxutas e reutilizáveis, evitando problemas de desempenho, segurança, manutenção ou importação.

Este é um documento complementar aos pré-requisitos obrigatórios para importar imagens descritos na documentação principal.

Boas Práticas de Criação de Imagens​

  • Mantenha a Imagem Enxuta
    • Inclua apenas o sistema operacional e os pacotes essenciais para a sua aplicação.
    • Evite instalar softwares desnecessários, como middlewares ou bancos de dados locais, que podem inflar o tamanho da imagem e introduzir vulnerabilidades.
    • Armazene dados persistentes em volumes adicionais.
    • Limpe arquivos temporários, caches e logs antigos antes de finalizar, para reduzir o tamanho da imagem.
  • Segurança e Conformidade:
    • Nunca inclua credenciais, chaves privadas ou certificados dentro da imagem.
    • Avalie desativar firewalls e antivírus que possam bloquear drivers de virtualização.
  • Automatize a Criação:
    • Utilize ferramentas como o Packer para padronizar a geração de imagens.
      • Com o Packer, você define um template de configuração que descreve como a imagem deve ser construída (SO base, pacotes a instalar, passos de limpeza).
      • Ao executar, o Packer automatiza todo o processo — da instalação até a generalização — e gera um arquivo .qcow2 limpo e pronto para importação.
    • Defina um template de configuração (SO base, pacotes, passos de limpeza)
    • Versione esses templates em repositórios Git e use pipelines CI/CD para gerar novas imagens sempre que houver mudanças ou patches de segurança.

Boas práticas de importação de imagens​

Após criar a imagem, considere as práticas a seguir antes de importá-la, para garantir uma inicialização limpa e sem conflitos para a Magalu Cloud:

  • Generalização:
    • Rode o virt-sysprep para remover dados herdados do provedor anterior (logs, configs de rede, pacotes proprietários).
  • Organização e nomeação
    • Use nomes descritivos e únicos ao registrar a imagem, facilitando a identificação no catálogo (ex.: ubuntu-22.04-lts-v1, debian-13-lts-julho2025,fedora-41-1756315135).
    • Certifique-se de que o nome está conforme as regras descritas na documentação principal de importação de imagens (sem caracteres especiais, único dentro do tenant).
  • Compatibilidade com flavors
    • Certifique-se de que os requisitos mínimos da imagem (vCPU, RAM e disco) sejam compatíveis com os tipos de máquina disponíveis na plataforma.
    • Evite configurar recursos mínimos acima do necessário. Isso otimiza desempenho e reduz custos.

Conclusão​

Seguir as boas práticas acima garante que suas imagens customizadas sejam mais seguras, leves e compatíveis com a Magalu Cloud.

💡 Para o passo a passo de importação e a lista completa de pré-requisitos obrigatórios, consulte a documentação principal de Importação de Imagens Customizadas.