Importação da Imagem Customizada na Magalu Cloud

Objetivo

Este guia demonstra como importar uma imagem customizada para a Magalu Cloud (MGC), permitindo que você utilize suas próprias configurações e softwares em suas instâncias. O processo envolve o upload da imagem para o Object Storage, registro no catálogo do tenant e acompanhamento do status da importação.

Pré-requisitos

• Acesso à sua conta na Magalu Cloud.
• Permissões de acesso ao Object Storage para realizar uploads e gerar URLs pré-assinadas.
• Arquivo de imagem no formato QCOW2.
• Conhecimento básico da CLI MGC.

Como fazer

1. Fazer upload da imagem para o Object Storage

Faça o upload do arquivo .qcow2 para um bucket na Magalu Cloud e gere uma URL pré-assinada com validade mínima de 12 horas:

mgc object-storage objects upload --src minha-imagem.qcow2 --dst s3://meu-bucket/minha-imagem.qcow2

2. Gerar a URL pré-assinada

Gere a URL pré-assinada com expiração de 24 horas:

mgc object-storage objects presign --bucket meu-bucket --key minha-imagem.qcow2 --expiry 86400

3. Registrar a imagem no catálogo

Com a URL pré-assinada em mãos, registre a imagem no catálogo do tenant:

mgc vm images custom create \
  --name "minha-imagem-ubuntu" \
  --url "https://meu-bucket.magalu.cloud/minha-imagem.qcow2?..." \
  --platform linux \
  --architecture x86/64 \
  --license unlicensed \
  --version "1.0" \
  --description "Ubuntu 22.04 customizado com NGINX" \
  --requirements.disk 25 \
  --requirements.ram 2 \
  --requirements.vcpu 1

4. Acompanhar o status da importação

mgc vm images custom get --name "minha-imagem-ubuntu"

O comando retornará o status da imagem:

Status	Descrição
importing	A imagem está sendo processada pela plataforma.
active	A imagem está disponível e pronta para uso.
deleting	A imagem está sendo removida.
deleted	A imagem foi removida do catálogo.

Detalhes técnicos

• Formato da Imagem: QCOW2 é o único formato de imagem suportado.
• Validade da URL Pré-Assinada: A validade deve ser de no mínimo 12 horas para evitar interrupções durante o processo de importação.

Parâmetros do comando mgc vm images custom create

Parâmetro	Descrição
--name	Nome da imagem (ex.: minha-imagem-ubuntu).
--url	URL pré-assinada para acessar a imagem no Object Storage.
--platform	Plataforma do sistema operacional (ex.: linux).
--architecture	Arquitetura da imagem (ex.: x86/64).
--license	Tipo de licença (ex.: unlicensed).
--version	Versão da imagem.
--description	Descrição da imagem.
--requirements.disk	Espaço em disco necessário para a instância (em GB).
--requirements.ram	Memória RAM necessária para a instância (em GB).
--requirements.vcpu	Número de vCPUs necessárias para a instância.

Perguntas frequentes

Posso usar outros formatos de imagem além do QCOW2?

Não, atualmente apenas imagens no formato QCOW2 são suportadas para importação na Magalu Cloud.

Qual o tempo máximo de validade da URL pré-assinada?

A URL pré-assinada deve ter uma validade mínima de 12 horas. Recomendamos utilizar um período maior, como 24 horas, para garantir que a importação seja concluída sem problemas.

Como posso verificar se a imagem foi importada corretamente?

Utilize o comando mgc vm images custom get --name "nome-da-imagem" para verificar o status da importação. Se o status for active, a imagem está pronta para ser utilizada na criação de instâncias.

Próximos passos

• Crie uma instância utilizando a imagem customizada que você importou.
• Explore outras opções de personalização de imagens disponíveis na Magalu Cloud.
• Consulte a documentação oficial da CLI MGC para obter mais informações sobre os comandos e parâmetros disponíveis.