Importação de Imagens Customizadas

Visão Geral

A funcionalidade de importação de imagens customizadas permite que você adicione suas próprias imagens de máquinas virtuais à plataforma MGC.
Com essa feature, você pode importar imagens personalizadas que atendam às suas necessidades específicas de infraestrutura.

Especificações Técnicas

Requisitos da Imagem

• Formato: Apenas imagens no formato QCOW2
• Tamanho máximo: 500 GB
• Hospedagem: A imagem deve estar armazenada em um bucket MGC
• Acesso: URL pré-assinada com validade superior a 12 horas

Pré-requisitos

Antes de iniciar o processo de importação, certifique-se de que:

1. Sua imagem está em um bucket MGC:
   Faça o upload da imagem .qcow2 para um bucket MGC.

2. Gere uma URL pré-assinada

   • Crie uma URL pré-assinada para a imagem
   • Importante: Configure a URL com prazo de expiração maior que 12 horas
   • Esta URL será utilizada durante o processo de importação

⚠️ Atenção: Configuração de Rede é Essencial para o Acesso

Para que sua máquina virtual seja acessível após a criação, é mandatório que a imagem customizada esteja configurada para obter endereço de rede automaticamente via DHCP.

Imagens que possuem configurações de rede estáticas ou que não conseguem se comunicar com o servidor DHCP da plataforma serão instanciadas, mas ficarão permanentemente inacessíveis.

Antes de importar, valide e garanta que, independente do sistema operacional, a interface de rede principal da imagem esteja habilitada para receber as configurações de rede fornecidas pela nossa infraestrutura.

Parâmetros de Configuração

Campos Obrigatórios

Campo	Descrição	Formato	Exemplo
name	Nome da imagem customizada	String (1-255 caracteres)	"minha-imagem-nginx"
url	URL HTTPS do arquivo .qcow2	String (URL válida HTTPS)	"https://bucket.mgc.com/imagem.qcow2"
platform	Sistema operacional	"linux"	"linux"
license	Tipo de licença	"unlicensed"	"unlicensed"
architecture	Arquitetura da imagem	"x86/64"	"x86/64"
requirements.vcpu	vCPUs mínimas necessárias	Inteiro > 0	4
requirements.ram	RAM mínima em GB	Inteiro > 0	8
requirements.disk	Espaço em disco mínimo em GB	Inteiro > 0	100

Campos Opcionais

Campo	Descrição	Formato	Padrão
description	Descrição da imagem	String (1-200 caracteres)	-
version	Versão da imagem	String	-
uefi	Utiliza UEFI para boot	Boolean	false

Status da Imagem

Durante o ciclo de vida da imagem, ela passará pelos seguintes status:

Status	Descrição
importing	A imagem está sendo importada
active	A imagem está ativa e pronta para uso
deleting	A imagem está em processo de deleção
deleted	A imagem foi deletada

Como Usar

Via CLI (Command Line Interface)

mgc vm images custom create \
  --name "minha-imagem-nginx" \
  --url "https://meu-bucket.magalu.cloud/minha-imagem.qcow2" \
  --platform linux \
  --architecture x86/64 \
  --license unlicensed \
  --version 1.0 \
  --description "Imagem customizada com NGINX e PostgreSQL" \
  --uefi \
  --requirements.disk 100 \
  --requirements.ram 8 \
  --requirements.vcpu 4

Exemplo Prático

Vamos criar uma imagem customizada com as seguintes características:

• Sistema operacional Linux
• 4 vCPUs mínimas
• 8 GB de RAM mínima
• 100 GB de disco mínimo
• Suporte a UEFI

mgc vm images custom create \
  --name "ubuntu-customizada" \
  --url "https://meu-bucket.mgc.com/ubuntu-custom.qcow2" \
  --platform linux \
  --architecture x86/64 \
  --license unlicensed \
  --description "Ubuntu 22.04 com configurações personalizadas" \
  --uefi \
  --requirements.vcpu 4 \
  --requirements.ram 8 \
  --requirements.disk 100

Boas Práticas e Considerações

Nomenclatura

• Use nomes descritivos e únicos para suas imagens
• O nome da imagem deve ser único dentro do seu tenant
• Evite caracteres especiais no nome da imagem

Requisitos de Sistema

• Certifique-se de que os requisitos mínimos (vCPU, RAM, disco) sejam compatíveis com os tipos de máquina disponíveis na plataforma
• Defina requisitos realistas para otimizar o desempenho

Licenciamento

• Para imagens Linux ou outras, use license: "unlicensed"

Limitações Atuais

• Apenas arquitetura x86/64 é suportada
• Formato de imagem limitado a QCOW2
• Tamanho máximo de 500 GB por imagem

Suporte

Para mais informações sobre como preparar suas imagens ou resolver problemas durante a importação, consulte nossa documentação técnica ou entre em contato com o suporte técnico MGC.

Esta documentação está sujeita a atualizações conforme novas funcionalidades são adicionadas à plataforma.