Skip to main content

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

CampoDescriçãoFormatoExemplo
nameNome da imagem customizadaString (1-255 caracteres)"minha-imagem-nginx"
urlURL HTTPS do arquivo .qcow2String (URL válida HTTPS)"https://bucket.mgc.com/imagem.qcow2"
platformSistema operacional"linux" ou "windows""linux"
licenseTipo de licença"unlicensed" ou "licensed""unlicensed"
architectureArquitetura da imagem"x86/64""x86/64"
requirements.vcpuvCPUs mínimas necessáriasInteiro > 04
requirements.ramRAM mínima em GBInteiro > 08
requirements.diskEspaço em disco mínimo em GBInteiro > 0100

Campos Opcionais

CampoDescriçãoFormatoPadrão
descriptionDescrição da imagemString (1-200 caracteres)-
versionVersão da imagemString-
uefiUtiliza UEFI para bootBooleanfalse

Status da Imagem

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

StatusDescrição
importingA imagem está sendo importada
activeA imagem está ativa e pronta para uso
deletingA imagem está em processo de deleção
deletedA 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.