Importação/Exportação de Imagens

Você pode compartilhar imagens personalizadas entre tenancies e regiões usando a importação/exportação de imagens.

Importante

Para importar ou exportar imagens personalizadas de buckets do serviço Object Storage, usuários federados e usuários que fazem autenticação com controladores de instância vinculados a um grupo dinâmico precisam criar uma solicitação pré-autenticada. Para obter mais informações, consulte o problema conhecido Erro de bucketName inválido ao importar ou exportar uma imagem personalizada.

Não é possível exportar imagens de plataforma, imagens do Marketplace e imagens personalizadas criadas com base nas imagens do Marketplace.

Sistemas Operacionais Baseados em Linux

Os seguintes sistemas operacionais suportam a importação/exportação de imagens:

  • Oracle Linux 6.x
  • Oracle Linux 7.x
  • Oracle Linux 8.x
  • Oracle Linux 9.x
  • Oracle Linux Cloud Developer 8.x
  • CentOS 7
  • CentOS Stream 8
  • Ubuntu 18.04
  • Ubuntu 20.04
  • Ubuntu 22.04

Sistemas Operacionais Baseados no Windows

As seguintes versões do Windows suportam importação/exportação de imagens:

  • Windows Server 2012 Standard, Datacenter
  • Windows Server 2012 R2 Standard, Datacenter
  • Windows Server 2016 Standard, Datacenter
  • Windows Server 2019 Standard, Datacenter
  • Windows Server 2022 Standard, Datacenter
Importante

Ao exportar imagens baseadas no Windows, você é responsável por cumprir os Termos do Produto Microsoft e todas as condições de uso do produto, bem como verificar sua conformidade com a Microsoft.

Para obter informações sobre os requisitos de licenciamento para imagens do Windows, consulte Microsoft Licensing on Oracle Cloud Infrastructure.

Verificar seu Sistema Operacional Windows

Ao importar imagens personalizadas do Windows, certifique-se de que a versão selecionada corresponda à imagem do Windows que você importou. Falha ao fornecer a versão correta e as informações da SKU podem ser uma violação de seu Contrato de Licenciamento da Microsoft.

Problema de Tempo do Sistema Windows em Instâncias Personalizadas do Windows

Se você alterar a definição padrão do fuso horário nas instâncias do Windows VM, quando a instância for reinicializada ou sincronizada com o relógio de hardware, o horário do sistema será revertido para o horário do fuso horário padrão. Entretanto, a configuração de fuso horário permanecerá definida como o novo fuso horário; portanto, o relógio do sistema ficará incorreto. Você pode corrigir esse problema definindo a chave de registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation com o valor 1.

As imagens da plataforma Windows já têm a chave de registro RealTimeIsUniversal definida por padrão, mas você deverá defini-la para qualquer imagem do Windows personalizada que importar.

Para corrigir esse problema em imagens personalizadas do Windows:

  1. Abra o Editor do Registro do Windows e navegue até a chave de registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation.
  2. Crie uma nova chave DWORD chamada RealTimeIsUniversal e defina o valor como 1.
  3. Reinicialize a instância.
  4. Redefina o horário e o fuso horário manualmente.

Cenários BYOI (Bring Your Own Image)

Você também pode usar a importação/exportação de imagem para compartilhar imagens personalizadas de cenários BYOI (Bring Your Own Image) entre tenancies e regiões; portanto, não é necessário recriar a imagem manualmente em cada região. Você deve passar pelas etapas obrigatórias para criar manualmente a imagem em uma das regiões, mas depois de ter feito isso, poderá exportar a imagem, tornando-a disponível para importação em tenancies e regiões adicionais. Exporte a imagem no formato .oci, que é um formato de arquivo que contém um arquivo de imagem do QCOW2 e metadados específicos do Oracle Cloud Infrastructure.

Melhores práticas para replicação de uma imagem entre regiões

Você pode replicar uma imagem de uma região para outra usando a Console ou API. Em um nível superior:

  1. Exportar a imagem para um bucket do Object Storage na mesma região da imagem.
  2. Copie a imagem para um bucket do Object Storage na região de destino.
  3. Obtenha o caminho do URL para o objeto de imagem.
  4. Na região de destino, importe a imagem. Use o caminho do URL como o URL do Object Storage.

Melhores práticas para compartilhar uma imagem entre tenancies

Você pode replicar uma imagem de uma tenancy para outra tenancy usando a Console ou a API. Em um nível superior:

  1. Exportar a imagem para um bucket do Object Storage na mesma região da imagem.
  2. Trabalhando com Solicitações Pré-Autenticadas com acesso somente para leitura da imagem na região de destino.

  3. Na tenancy de destino, importe a imagem. Use o URL da solicitação pré-autenticada como o URL do Object Storage.

URLs de Serviço do Object Storage

Quando você importa ou exporta imagens personalizadas usando a Console, pode ser necessário especificar o URL do Object Storage apontando para o local de onde deseja importar a imagem ou para o qual deseja exportar a imagem. Os URLs do Object Storage são estruturados da seguinte forma:

https://<host_name>/n/<namespace_name>/b/<bucket_name>/o/<object_name>

Por exemplo:

https://objectstorage.us-phoenix-1.oraclecloud.com/n/MyNamespace/b/MyBucket/o/MyCustomImage.qcow2

Solicitações Pré-autenticadas

Ao usar a importação/exportação entre tenancies, você precisa usar uma solicitação pré-autenticada do Object Storage. Consulte Trabalhando com Solicitações Pré-Autenticadas para conhecer as etapas para criar uma solicitação pré-autenticada. Ao passar por essas etapas, depois de clicar em Criar Solicitação Pré-autenticada, a caixa de diálogo Detalhes da Solicitação Pré-autenticada será aberta. É necessário fazer uma cópia do URL da solicitação pré-autenticada exibido aqui, porque essa é a única vez em que este URL é exibido. Este é o URL do Object Storage que você especifica para importação/exportação.

Observação

Solicitações pré-autenticadas para um bucket

Com a exportação de imagens, se você criar a solicitação pré-autenticada para um bucket, precisará anexar o nome do objeto ao URL gerado. Por exemplo:

/o/MyCustomImage.qcow2

Exportando uma Imagem

Você pode usar a Console ou API para exportar imagens, e as imagens exportadas são armazenadas no serviço Oracle Cloud Infrastructure Object Storage. Para executar uma exportação de imagem, você precisa de acesso de gravação ao bucket do Object Storage da imagem. Para obter mais informações, consulte Visão Geral do Object Storage e Permitir que os usuários gravem objetos em buckets do Object Storage.

Para exportar uma imagem usando a Console

  1. Abra o menu de navegação e clique em Compute. Em Compute, clique em Imagens Personalizadas.
  2. Clique na imagem personalizada em que você está interessado.
  3. Clique em Exportar.
  4. Especifique a localização do serviço Object Storage para a qual exportar a imagem:

    • Exportar para um bucket do serviço Object Storage: Selecione um bucket. Em seguida, digite um nome para a imagem exportada. Evite digitar informações confidenciais.
    • Exportar para um URL do Object Storage: Digite o URL do Object Storage.
  5. Na lista Formato de imagem, selecione o formato para o qual você deseja exportar a imagem. Os seguintes formatos estão disponíveis:

    • Arquivo do Oracle Cloud Infrastructure com uma imagem do QCOW2 e metadados do OCI (.oci). Use esse formato para exportar uma imagem personalizada que você deseja importar para outras tenancies ou regiões.
    • Cópia do QEMU na Gravação (.qcow2)
    • Imagem de Disco Virtual (. vdi) para Oracle VM VirtualBox
    • Disco Rígido Virtual (. vhd) para Hyper-V
    • Disco de Máquina Virtual (.vmdk)
  6. Clique em Exportar imagem.

Depois de clicar em Exportar imagem, o estado da imagem muda para Exportando. As imagens são uma cópia do volume de inicialização e dos metadados da instância de VM ou BM quando a imagem é criada, capturando o estado atual da instância. A exportação de uma imagem personalizada copia os dados para o local do serviço Object Storage especificado. Você ainda pode iniciar instâncias enquanto a imagem estiver sendo exportada, mas não poderá excluir a imagem até a exportação ser concluída. Para rastrear o andamento da operação e solucionar erros que ocorrem durante a criação da instância, use a solicitação de serviço associada.

Quando a exportação estiver concluída, o estado da imagem mudará para Disponível. Se o estado da imagem mudar para Disponível, mas você não vir a imagem exportada no local do serviço Object Storage, isso significará que a exportação falhou e você precisará passar pelas etapas novamente para exportar a imagem.

Importando uma imagem

Você pode usar a Console ou API para importar imagens exportadas do Object Storage. Para importar uma imagem, você precisa de acesso de leitura ao objeto do Object Storage que contém a imagem. Para obter mais informações, consulte Permitir que os usuários façam download de objetos de buckets do Object Storage.

Para importar uma imagem usando a Console

  1. Abra o menu de navegação e clique em Compute. Em Compute, clique em Imagens Personalizadas.
  2. Clique em Importar imagem.
  3. Na lista Criar no compartimento, selecione o compartimento para o qual você deseja importar a imagem.
  4. Digite um Nome para a imagem. Evite digitar informações confidenciais.
  5. Selecione o Sistema operacional:

    • Para imagens do Linux, selecione Linux.
    • Para imagens do Windows, selecione Windows. Selecione a Versão do sistema operacional e, em seguida, certifique-se de que o sistema operacional selecionado esteja de acordo com os contratos de licença da Microsoft.
  6. Especifique o local do serviço Object Storage do qual importar a imagem:

    • Importar de um bucket do Object Storage: Selecione o Bucket que contém a imagem. Na lista Nome do objeto, selecione o arquivo de imagem.
    • Importar de um URL do Object Storage: Digite o URL do Object Storage da imagem. Ao importar entre tenancies, você deve especificar um URL de solicitação pré-autenticado.
  7. Na seção Tipo de imagem, selecione o formato da imagem. Os seguintes formatos estão disponíveis:

    • VMDK: Disco de Máquina Virtual (.vmdk)
    • QCOW2: Cópia do QEMU na Gravação (.qcow2)
    • OCI: Arquivo do Oracle Cloud Infrastructure com uma imagem do QCOW2 e metadados do OCI (.oci). Use esse formato ao importar uma imagem personalizada que foi exportada de outra tenancy ou região.
  8. Selecione o Modo de início:

    • Para imagens personalizadas em que o tipo de imagem é .oci, o modo de inicialização é desativado. O Oracle Cloud Infrastructure seleciona o modo de inicialização apropriado com base no modo de inicialização da imagem de origem.

    • Para imagens personalizadas exportadas do Oracle Cloud Infrastructure em que o tipo de imagem é QCOW2, selecione Modo nativo.

    • Para importar outras imagens personalizadas, selecione Modo Paravirtualizado ou Modo Emulado. Para obter mais informações, consulte BYOI (Bring Your Own Image).

  9. Mostrar opções de tag: Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
  10. Clique em Importar imagem.

Depois de clicar em Importar imagem, você verá a imagem importada na lista imagens personalizadas do compartimento, com o estado Importando. Para rastrear o andamento da operação e solucionar erros que ocorrem durante a criação da instância, use a solicitação de serviço associada.

Quando a importação for concluída com sucesso, o estado mudará para Disponível. Se o estado não for alterado ou nenhuma entrada aparecer na lista imagens personalizadas, a importação falhará. Se a importação falhar, certifique-se de ter acesso de leitura ao objeto do Object Storage e de que o objeto contenha uma imagem suportada.

Gerenciando Tags de uma Imagem

Aplique tags aos seus recursos para ajudar a organizá-los de acordo com as necessidades da sua empresa. Aplique tags no momento da criação de um recurso ou atualize o recurso posteriormente com as tags desejadas. Para obter informações gerais sobre a aplicação de tags, consulte Tags de Recursos.

Para gerenciar tags de uma imagem
  1. Abra o menu de navegação e clique em Compute. Em Compute, clique em Imagens Personalizadas.
  2. Clique na imagem desejada.

  3. Clique na guia Tags para exibir ou editar as tags existentes. Ou clique em Mais Ações e, em seguida, clique em Adicionar Tags para adicionar novas tags.

Usando a API

Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

Use as seguintes operações de API para importação/exportação de imagem personalizada:

Compatibilidade de X5 e X7 para Importação/Exportação de Imagem

Os servidores Oracle X5, X6 e X7 têm hardware de host diferente. Como resultado, o uso de uma imagem X5 ou X6 em uma instância X7 bare metal ou de máquina virtual (VM) pode não funcionar sem modificações adicionais. A Oracle recomenda para hosts X7 que você use as imagens da plataforma para X7. Consulte as Notas da Release da Imagem para obter mais informações sobre quais imagens suportam X7. Essas imagens foram criadas e testadas explicitamente com hardware X7.

Se você tentar usar uma imagem X5 existente em hardware X7, observe o seguinte:

  • Nenhuma versão do Windows é compatível entre si.
  • O Oracle Autonomous Linux 7 e o Oracle Linux 8 são compatíveis entre si.
  • Oracle Linux 6, Oracle Linux 7, Oracle Linux 8, Oracle Linux 9, Ubuntu 18.04, Ubuntu 20.04, Ubuntu 22.04, CentOS 7 e CentOS Stream 8 são compatíveis entre si. Pode ser necessário atualizar o kernel, no entanto, para a versão mais recente para instalar os drivers de dispositivo mais recentes. Para atualizar o kernel, execute um dos seguintes comandos em uma sessão de terminal:
    • Oracle Linux
      yum update
    • CentOS 7, CentOS Stream 8
      yum update
    • Ubuntu 18.04, Ubuntu 20.04, Ubuntu 22.04
      apt-get update
      apt-get dist-upgrade

Se você tentar usar uma imagem X6 em hardware não X6, observe o seguinte:

  • O Oracle Linux 6, todas as versões do CentOS e todas as versões do Windows não têm compatibilidade entre si.
  • O Oracle Autonomous Linux 7 e o Oracle Linux 8 são compatíveis entre si.
  • Oracle Linux 7, Ubuntu 22.04, , Ubuntu 20.04 e Ubuntu 18.04 são compatíveis entre si. Use as imagens da plataforma para X6.

Os principais drivers de dispositivo que são diferentes entre os hosts X5, X6 e X7 são:

  • Drivers de dispositivo de rede
  • Drivers de dispositivo da unidade NVMe
  • Drivers de dispositivo GPU

Atualizações adicionais poderão ser necessárias, dependendo de como você personalizou a imagem.