Skip to main content

Preparação da Imagem para Importação

Objetivo

Este guia detalha os requisitos e etapas para preparar uma imagem de sistema operacional Linux compatível com a Magalu Cloud (MGC). Ao seguir estas instruções, você garante que suas imagens sejam importadas ou utilizadas corretamente na plataforma.

Atenção: O recurso não suporta outros formatos além do QCOW2. Certifique-se de converter sua imagem antes de prosseguir.

Atenção: Não pule a etapa de sanitização. Imagens que contenham authorized_keys pré-existentes podem impedir o acesso via chave SSH injetada pelo cloud-init, tornando a VM inacessível.

Pré-requisitos

  • Imagem do sistema operacional Linux (apenas arquitetura x86/64).
  • Ferramentas para conversão de formatos de imagem (ex.: qemu-img).
  • Acesso à linha de comando para executar os comandos de sanitização e configuração.

Como fazer

Para preparar sua imagem, siga as etapas abaixo:

1. Converter o formato da imagem

Se a sua imagem não estiver no formato QCOW2, utilize o qemu-img para convertê-la:

# Exemplo: converter de VMDK para QCOW2
qemu-img convert -f vmdk -O qcow2 minha-imagem.vmdk minha-imagem.qcow2

# Exemplo: converter de VHD para QCOW2
qemu-img convert -f vpc -O qcow2 minha-imagem.vhd minha-imagem.qcow2

# Exemplo: converter de RAW para QCOW2
qemu-img convert -f raw -O qcow2 minha-imagem.raw minha-imagem.qcow2

2. Instalar e configurar o cloud-init

Certifique-se de que o cloud-init esteja instalado e habilitado na sua imagem. Ele é responsável por configurar automaticamente o hostname, a rede e injetar a chave SSH pública no primeiro boot. Remova arquivos de configuração específicos de outros providers em /etc/cloud/cloud.cfg.d/.

3. Configurar o redimensionamento automático

Configure o redimensionamento automático de partição e sistema de arquivos para que o disco lógico se expanda ao tamanho do volume provisionado na Magalu Cloud.

4. Instalar e habilitar o servidor SSH

O openssh-server deve estar instalado e configurado para iniciar automaticamente com o sistema operacional. Não inclua chaves SSH fixas ou arquivos authorized_keys.

5. Configurar a rede

  • Configure a interface de rede principal para receber IP via DHCP.
  • Remova endereços MAC fixos de arquivos de configuração de rede (ex.: ifcfg-eth0). A Magalu Cloud atribui o MAC dinamicamente.
  • Desabilite o firewall interno da imagem e utilize apenas os Security Groups da Magalu Cloud.

6. Sanitizar a imagem

Execute os comandos de sanitização para remover dados e configurações temporários, garantindo que cada nova VM inicializada a partir dela parta de um estado limpo:

# Limpeza de pacotes desnecessários
sudo apt-get clean
sudo apt-get autoremove -y

# Reset do cloud-init (remove logs, machine-id e seeds de configuração anterior)
sudo cloud-init clean --logs --machine-id --seed

# Limpeza de arquivos temporários
sudo rm -rf /tmp/*

# Remoção de chaves SSH do host (serão geradas novamente no primeiro boot)
sudo rm -f /etc/ssh/ssh_host_*

# Remoção de chaves autorizadas de usuários
sudo rm -f /root/.ssh/authorized_keys
sudo rm -f /home/ubuntu/.ssh/authorized_keys

# Limpeza de histórico de comandos
unset HISTFILE
sudo rm -f /root/.bash_history
sudo rm -f /home/ubuntu/.bash_history

ℹ️ Info: A sanitização consiste em remover dados e configurações temporários da imagem antes de capturá-la, garantindo que cada nova VM inicializada a partir dela parta de um estado limpo e não carregue informações do ambiente onde foi preparada. Os mesmos princípios se aplicam a outras distribuições Linux.

Detalhes técnicos

ParâmetroValor
Formato da imagemQCOW2 (QEMU Copy-On-Write)
Tamanho máximo25 GB
Arquitetura suportadax86/64
Sistema operacionalApenas Linux
cloud-initDatasources compatíveis com a Magalu Cloud devem ser configurados

Perguntas frequentes

Quais formatos de imagem são suportados?

Atualmente, apenas o formato QCOW2 é suportado. Você deve converter sua imagem para este formato antes de importá-la para a Magalu Cloud.

Por que devo sanitizar a imagem?

A sanitização remove dados e configurações temporários da imagem, garantindo um ambiente limpo e seguro para suas VMs. Imagens não sanitizadas podem conter informações sensíveis ou causar conflitos de configuração.

O que acontece se eu incluir chaves SSH fixas na imagem?

Se a sua imagem contiver chaves SSH pré-existentes, elas podem impedir o acesso via chave SSH injetada pelo cloud-init, tornando a VM inacessível.

Próximos passos

  • Consulte a documentação oficial da Magalu Cloud para obter informações detalhadas sobre como importar imagens customizadas.
  • Teste sua imagem importada em uma instância de teste antes de usá-la em produção.
  • Explore os recursos de segurança da Magalu Cloud, como Security Groups, para proteger suas VMs.