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:
-
Sua imagem está em um bucket MGC:
Faça o upload da imagem.qcow2
para um bucket MGC. -
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" ou "windows" | "linux" |
license | Tipo de licença | "unlicensed" ou "licensed" | "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 Windows, use license: "licensed"
- 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.