Como usar a funcionalidade Bring Your Own Image
Saiba como implementar imagens graças à funcionalidade Bring Your Own Image
Última atualização: 25/11/2022
Objetivo
Graças à tecnologia Bring Your Own Image, é-lhe agora possível implementar imagens cloudready diretamente nos seus servidores dedicados. Assim, pode utilizar o produto bare metal como recurso para as suas implementações.
O que significa cloudready?
Numa frase, ser agnóstico da infraestrutura na qual a imagem começa.
Para além dos requisitos e limitações citados abaixo, é necessário assegurar que a imagem (recuperada, gerada) responde à boa definição das expetativas técnicas de uma imagem cloudready. A imagem deve ser capaz de bootar corretamente qualquer que seja a tipologia de servidor em que começa, deve também embarcar o serviço Cloud Init no caso de utilização de um Config Drive. Por último, as configurações do sistema devem permitir que o SO se inicie plenamente, em especial as relativas à rede.
Saiba como configurar BringYourOwnImage a partir da APIv6 OVHcloud
Requisitos
- Dispor de um servidor dedicado da OVHcloud.
- Ter acesso à Área de Cliente OVHcloud para a secção "Implementação através da Área de Cliente" deste manual.
- Ter acesso às API OVHcloud para a parte "Implementação através da API" deste manual.
- Ter gerado os credenciais para utilizar a APIv6 para a parte "Implementação através da API" deste manual.
- O tamanho da sua imagem deve ser inferior à quantidade da memória RAM do seu servidor menos 3GiB.
Uma nova instalação por BringYourOwnImage apagará a integralidade dos dados presentes no servidor.
Instruções
Limitações técnicas
Atualmente, ainda existem algumas limitações técnicas relacionadas com a utilização de produtos físicos, como os servidores dedicados. Tenha em conta os imperativos listados abaixo aquando da sua preparação de implementação. Esta lista não é exaustiva.
- O tipo de boot: uefi ou legacy
- O tipo de partição: MBR ou GPT
- O formato de imagem: qcow2 ou raw
Se o seu servidor dispõe de um boot uefi, certifique-se de que adiciona uma partição EFI ao template da sua imagem.
Métodos de implantação
- Implementação através da Área de Cliente\: permitir-lhe-á implementar rápida e facilmente a sua imagem diretamente a partir da sua Área de Cliente OVHcloud.
- Implementação através da API\: pode utilizar as API OVHcloud para as integrar nos seus próprios scripts para automatizar a implementação.
Implementar a sua imagem a partir da Área de Cliente OVHcloud
Na sua Área de Cliente OVHcloud, na secção Bare Metal Cloud, e depois Servidores Dedicados, selecione o seu servidor.
Na secção Informações gerais, clique no botão ... em frente Informações gerais. Finalmente, clique em Instalar.
Na nova janela, selecione Instalar a partir de uma imagem personalizada e, a seguir, clique em Instalar.
Será reencaminhado para a página de configuração. Certifique-se de que o URL da sua imagem está no formato apropriado. Preencha os campos restantes nesta página. Quando confirmar que as informações estão corretas, clique em Instalar o sistema.
Encontre os detalhes das opções na secção "Tabelas de opções" deste manual.
No que diz respeito à ativação do ConfigDrive, consulte a documentação nesta página.
Implementar a sua imagem a partir das API
Aceda a https://api.ovh.com/ e aceda à secção /dedicated/server. O campo Filter permite-lhe pesquisar "BringYourOwnImage".
Dispõe de três chamadas API associadas à funcionalidade BringYourOwnImage.
Para criar e implementar a sua imagem, utilize a seguinte chamada e complete os campos necessários:
| Campo | Descrição |
|---|---|
| serviceName | O nome do seu servidor. |
| URL | O URL onde pode recuperar a sua imagem. |
| checkSum | O checksum da sua imagem. |
| checkSumType | O checksum da imagem a implementar (md5, sha1, sha256, sha512). |
| description | O nome da sua imagem. |
| diskGroupId | O ID do disco que deve ser utilizado. |
| hostname | O hostname do seu servidor. |
| httpHeader | Apenas se necessário para descarregar a imagem. |
| sshKey | A sua chave SSH pública. |
| type | O tipo/formato da sua imagem (qcow2, raw, ova). |
| userData | O seu script de pós-instalação. |
| userMetadados | Metadados utilizados por Nova no momento do boot. |
Depois de preencher os campos, lance a implementação clicando em Execute.
Verificar a implementação
Pode seguir a implementação da sua imagem através da chamada API abaixo ou através do KVM / IPMI.
Neste exemplo, a implementação está em curso de arranque.
A implementação pode durar cerca de dez minutos. Terminada a operação, o estado da sua implementação passará para "done" e o seu servidor será reiniciado no disco.
Exemplos de retorno
Veja alguns exemplos:
| Mensagem | Significado |
|---|---|
| Can't write qcow2 on disk. | Não é possível escrever a imagem qcow2 no disco. |
| Could not download, qcow2 image is too big to download in memory. | Não há espaço de RAM suficiente para descarregar a imagem. |
Could not download image located: http://path/of/your/image. |
Não é possível descarregar a imagem localizada: http://caminho/de/sua/imagem. |
| Bad format image, expected: qcow2, raw. | O formato da imagem está incorreto. |
| Bad checkSumType, expected: sha1, sha256, md5. | O tipo de checksum está incorreto. |
| Bad $checkSumType for downloaded file, got: 1234 while expting 5678. | O checksum está incorreto. |
| Can not move backup GPT data structures to the end of disk. | O formato disco está incorreto. |
| Could not create configdrive on disk. | Não é possível criar a partição configurável no disco. |
Eliminar a implementação
Pode optar por eliminar a sua implementação graças à seguinte chamada:
Isto eliminará o estado da implementação e colocará o seu servidor em modo rescue.
Quer saber mais?
Fale com a nossa comunidade de utilizadores em https://community.ovh.com/en/.
Esta documentação foi-lhe útil?
Não hesite em propor-nos sugestões de melhoria para fazer evoluir este manual.
Imagens, conteúdo, estrutura... Não hesite em dizer-nos porquê para evoluirmos em conjunto!
Os seus pedidos de assistência não serão tratados através deste formulário. Para isso, utilize o formulário "Criar um ticket" .
Obrigado. A sua mensagem foi recebida com sucesso.