Antes de Iniciar

Antes de importar uma imagem de inicialização, verifique se você atende aos seguintes pré-requisitos:

• Envie seu arquivo de imagem de inicialização para um bucket do IBM Cloud Object Storage. Os formatos de arquivo compatíveis são .ova, .ova.gz, .tar, .tar.gz e .tgz. Para obter mais informações, consulte “Crie alguns buckets para armazenar seus dados ”.

• Gere credenciais do Código de Autenticação de Mensagem Baseado em Hash (HMAC) para sua instância do COS. Para mais informações, consulte Usar credenciais HMAC.

• Crie ou utilize um espaço de trabalho existente do Power Virtual Server.

Importação de uma imagem de inicialização usando a interface do usuário do Power Virtual Server

Para importar uma imagem de inicialização usando a interface do usuário do Power Virtual Server, siga estas etapas:

1. Faça login no catálogo IBM Cloud usando suas credenciais do IBM.

2. Na caixa de pesquisa, digite Power Virtual Server e clique no Power Virtual Server bloco.

3. Clique em “Espaços de trabalho” no painel de navegação. É exibida a página “Espaços de trabalho”, com uma lista dos espaços de trabalho existentes.

4. Selecione o espaço de trabalho para o qual você deseja importar a imagem de inicialização. A página “Instâncias de servidor virtual” do espaço de trabalho selecionado é exibida.

5. Clique em “Imagens de inicialização ” no painel de navegação e clique em “Importar imagem ”. O painel “Importar imagem de inicialização” é exibido.

6. No painel “Importar imagem de inicialização”, siga as etapas a seguir na seção “Origem ”:

   1. Selecione o sistema operacional da imagem na lista suspensa “Sistema operacional da imagem ”.

      Se você selecionar um sistema operacional de imagem do tipo “ SAP HANA ” ou “ SAP NetWeaver ”, deverá marcar a caixa de seleção de autocertificação.

   2. Na lista suspensa “Região”, selecione a região que contém seu bucket COS.

   3. Digite o nome do arquivo da imagem no campo “Nome do arquivo da imagem ”. O nome do arquivo de imagem não deve conter espaços.

      As extensões de arquivo compatíveis são: .ova, .ova.gz, .tar, .tar.gz e .tgz. Você pode compactar arquivos de imagem usando o site gzip. Por exemplo: Aix_7200-03-02-1846_cldrdy_112018.ova.gz.

   4. Digite o nome do seu bucket no campo " Nome do bucket ". Se o seu arquivo de imagem estiver armazenado em uma subpasta do bucket, especifique o caminho completo usando o formato bucketName/optional/folders.

      Para identificar o nome do seu bucket, acesse o menu de navegação > Lista de recursos > Armazenamento e clique no nome da sua instância do Cloud Object Storage. Seus buckets estão listados na guia “Buckets ”.

   5. Copie o valor “ access_key_id ” das suas credenciais do serviço COS e cole-o no campo “Chave de acesso HMAC ”.

      Para localizar as credenciais do seu serviço, acesse o menu de navegação > Lista de recursos > Armazenamento, clique no nome da sua instância do Cloud Object Storage e, em seguida, acesse Credenciais do serviço > Exibir credenciais.

   6. Copie o valor “ secret_access_key ” das suas credenciais do serviço COS e cole-o no campo “Chave secreta de acesso HMAC ”.

   7. Defina a opção “Validar importação com arquivo de checksum” como “Ativado” para verificar se o arquivo importado corresponde ao arquivo de checksum. É necessário armazenar o arquivo de checksum e o arquivo de imagem de inicialização no mesmo bucket do COS.

      É possível gerar o arquivo de checksum ao exportar o arquivo de imagem de inicialização para o bucket do IBM Cloud Object Storage. O nome do arquivo de checksum é baseado no nome do arquivo da imagem de inicialização e utiliza a extensão .sha256.

      Se você criar sua própria imagem de inicialização, poderá criar um arquivo de checksum e armazená-lo junto com a imagem de inicialização no mesmo bucket. Você pode gerar o arquivo de checksum executando o comando shasum -a 256 <filename> ou sha256sum <filename>.

      Para obter mais informações sobre como gerar um arquivo de checksum, consulte “Usando a interface de usuário do Power Virtual Server para capturar e exportar um VM ”.

      A validação do arquivo de importação em relação ao arquivo de soma de verificação pode aumentar o tempo de importação.

7. Clique em Avançar.

8. Insira as seguintes informações na seção “Destino ”:

   1. No campo “Nome da imagem personalizada”, digite um nome para a imagem de inicialização importada.

   2. Opcional: No campo “Tags do usuário ”, insira tags para organizar ou categorizar esta imagem de inicialização.

      As tags de usuário ficam visíveis para todos os usuários da conta. Não inclua dados confidenciais nos nomes das tags.

   3. No campo “Nível”, selecione uma das seguintes opções de tipo de armazenamento:

      • Nível 0 (25 IOPs / GiB )
      • Nível 1 (10 IOPs/ GiB )
      • Nível 3 (3 IOPs / GiB )
      • IOPs fixas (5.000 IOPs)

      Um VSI não pode utilizar os tipos de armazenamento de Nível 1 e Nível 3 simultaneamente. Para obter mais informações, consulte Camadas de armazenamento.

   4. No campo “Pool de armazenamento ”, selecione uma opção de pool de armazenamento.

      Power Virtual Server coloca um ou mais volumes de armazenamento de imagens personalizados no pool de armazenamento com base na opção selecionada: Seleção automática, Afinidade ou Antiafinidade. O volume de inicialização de qualquer VSI que você implantar usando esta imagem é criado no mesmo pool de armazenamento. Para obter mais informações sobre volumes de armazenamento, consulte “Adicionando e gerenciando volumes de armazenamento ”.

      Estão disponíveis as seguintes opções de pool de armazenamento:

      • Seleção automática: cria automaticamente o volume de armazenamento em um pool de armazenamento com capacidade suficiente.

      • Afinidade: identifica o pool de armazenamento para os volumes de inicialização, com base em um VSI existente ou em um volume de armazenamento da sua conta. O Power Virtual Server armazena os volumes de armazenamento da imagem personalizada no mesmo pool de armazenamento em que o objeto de afinidade está localizado. Se o objeto de afinidade for um VSI, o Power Virtual Server determina o pool de armazenamento com base no volume de inicialização do VSI.

      • Anti-afinidade: identifica um ou mais pools de armazenamento que você deseja excluir. O recurso “ Power Virtual Server ” não leva em consideração os pools de armazenamento excluídos ao alocar volumes de inicialização. Os conjuntos a serem excluídos são identificados com base nos VSIs existentes ou nos volumes de armazenamento da sua conta. Ao selecionar essa opção, o Power Virtual Server exclui os pools de armazenamento nos quais existem objetos de anti-afinidade ao criar os volumes de armazenamento de imagens personalizadas. Se você utilizar VSIs como objetos anti-afinidade, o Power Virtual Server exclui os pools de armazenamento com base no volume de inicialização de cada VSI.

9. Clique em “Importar imagem ”.

   Imagens de inicialização grandes podem demorar mais para serem importadas. Talvez haja um atraso antes de receber uma mensagem de confirmação.

A nova imagem de inicialização está listada na página Imagens de inicialização.

Importação de uma imagem de inicialização usando a CLI do Power Virtual Server

Para importar uma imagem de inicialização, execute o ibmcloud pi image import comando. Para verificar se a importação foi concluída, execute o ibmcloud pi image list comando.

Se você estiver usando uma imagem do tipo “traga sua própria licença” (BYOL) do SAP HANA ou SAP NetWeaver, adicione a opção --import-details ao ibmcloud pi image import comando para identificar a imagem como certificada pelo SAP.

Importação de uma imagem de inicialização usando a API do Power Virtual Server

Para importar uma imagem de inicialização do IBM Cloud Object Storage usando a API, utilize o método “Criar uma tarefa de importação de imagem do COS” com as propriedades necessárias no corpo da solicitação: imageName, imageFilename e bucketName. Para buckets privados, é necessário especificar accessKey e secretKey, que são a chave de acesso HMAC e a chave secreta da sua instância do COS. Para mais informações, consulte Usar credenciais HMAC.

curl -X POST \
  https://us-east.power-iaas.cloud.ibm.com/pcloud/v1/cloud-instances/$CLOUD_INSTANCE_ID/cos-images \
  -H "Authorization: Bearer $TOKEN" \
  -H "CRN: $CRN" \
  -H "Content-Type: application/json" \
  -d '{
    "imageName": "my-image-name",
    "imageFilename": "my-os-image-file.ova.gz",
    "bucketName": "my-cos-bucket-name",
    "region": "us-east",
    "accessKey": "my-cos-access-key",
    "secretKey": "my-cos-secret-key",
    "storageType": "tier3"
  }'

Se você estiver usando uma imagem do tipo “traga sua própria licença” (BYOL) do SAP HANA ou SAP NetWeaver, inclua o objeto importDetails no corpo da solicitação para identificar a imagem como certificada pelo SAP:

"importDetails": {
   "licenseType": "byol",
   "product": "Hana",
   "vendor": "SAP"
}

Visualizando os resultados da importação da imagem de inicialização

Depois de iniciar a importação de uma imagem de inicialização, a coluna “Status” na página “Imagens de inicialização” mostra o andamento da importação. Para visualizar os detalhes, clique em “Visualizar detalhes ” para abrir a caixa de diálogo “Status da tarefa em andamento”. A caixa de diálogo exibe as seguintes informações:

• ID da tarefa
• Tipo da operação
• Recurso de entrada
• Horário de criação
• Etapas concluídas

Para visualizar os detalhes da tarefa de importação da imagem de inicialização por meio da CLI, utilize o ibmcloud pi image import-show comando.

Para visualizar os detalhes da tarefa de importação da imagem de inicialização por meio da API, utilize o método “Obter detalhes da última tarefa de importação da imagem cos ”.

Baixando uma imagem de inicialização de Cloud Object Storage

Para baixar a imagem de inicialização após importá-la, siga estas etapas:

1. No painel do IBM Cloud, acesse a “Lista de recursos ” e clique na sua Cloud Object Storage instância.

2. No bucket onde você armazenou sua imagem de inicialização, clique no arquivo da imagem de inicialização.

3. Clique em “Baixar objetos ”.

Para obter mais informações sobre o comando da CLI Cloud Object Storage, consulte “Baixar um objeto ”.

Informações relacionadas

Para obter informações sobre como exportar imagens de inicialização personalizadas, consulte “Exportando uma imagem de inicialização ”.

Para obter informações sobre como capturar e exportar instâncias de servidor virtual, consulte “Captura e exportação de uma instância de servidor virtual ”.