Importando uma imagem customizada usando a IU

Quando você tiver uma imagem disponível no IBM Cloud Object Storage, será possível importá-la para a infraestrutura do IBM Cloud VPC usando o console do IBM Cloud.

1. Certifique-se de que a sua imagem customizada compatível esteja disponível no IBM Cloud Object Storage. Para fazer upload de uma imagem para o IBM Cloud Object Storage, na página Objetos de seu depósito, clique em Upload. É possível usar o plug-in de transferência em alta velocidade do Aspera para fazer upload de imagens maiores que 200 MB. Para obter mais informações, consulte Criando uma imagem personalizada do Linux, Criando uma imagem customizada do Windows, Traga sua própria licença e Fazendo upload de dados para o IBM Cloud Object Storage.
2. No IBM Cloud console, acesse o ícone Menu > Infraestrutura do VPC> Cálculo> Imagens.
3. Na guia Imagens customizadas, clique em Criar.
4. Preencha os campos descritos na Tabela 1 e clique em “Criar imagem personalizada ”.

Importando uma imagem customizada usando a CLI

Certifique-se de que a sua imagem customizada compatível esteja disponível no IBM Cloud Object Storage. Para obter mais informações, consulte Criação de uma imagem personalizada do Linux, Criação de uma imagem personalizada do Windows, Criação de uma imagem personalizada do sistema operacional genérico, Traga sua própria licença e Carregamento de dados para IBM Cloud Object Storage. Para incluir expressões de uso permitido, consulte Adição de expressões de uso permitido a imagens personalizadas.

Quando uma imagem estiver disponível em IBM Cloud Object Storage, você poderá importá-la para a infraestrutura de IBM Cloud VPC usando a interface de linha de comando (CLI).

Para importar uma imagem customizada usando a CLI, use o comando ibmcloud is image-create. Especifique o nome da imagem personalizada usando a variável IMAGE_NAME. O nome não pode ser usado por outra imagem na região e nomes que começam com ibm- são reservados para imagens fornecidas pelo sistema. Você deve especificar a origem; por exemplo, especifique a opção --file com o local do arquivo de imagem. Especifique a opção --os-name com o nome do sistema operacional da imagem.

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME]

O exemplo a seguir cria uma imagem customizada com o nome my-ubuntu-16-amd64. O local de origem da imagem é cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 O sistema operacional é ubuntu-16-amd64..

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64

Para obter mais informações, consulte “ibmcloud is image-create” na página de referência da CLI do VPC.

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --deprecate-at 2023-03-01T06:11:28+05:30 --obsolete-at 2023-12-31T06:11:28+05:30

Importando uma imagem customizada usando a API

Certifique-se de que a sua imagem customizada compatível esteja disponível no IBM Cloud Object Storage. Para obter mais informações, consulte Criação de uma imagem personalizada do Linux, Criação de uma imagem personalizada do Windows, Criação de uma imagem personalizada de um sistema operacional genérico, Traga sua própria licença e Carregamento de dados para IBM Cloud Object Storage. Para incluir uma expressão de uso permitido, consulte Adição de expressões de uso permitido a imagens personalizadas.

Quando você tiver uma imagem disponível no IBM Cloud Object Storage, poderá importá-la para a infraestrutura do IBM Cloud VPC usando a interface de programação de aplicativos (API).

Para importar uma imagem customizada usando a API, use Criar uma imagem..

O name não pode ser usado por outra imagem na região e os nomes que começam com ibm- são reservados para imagens fornecidas pelo sistema. Especifique a subpropriedade file.href com o local da imagem.. Especifique a subpropriedade operating_system.name com o nome do sistema operacional de imagem..

As imagens personalizadas genéricas do sistema operacional são um recurso beta e estão disponíveis para fins de avaliação e teste. Os sistemas operacionais genéricos têm family de Generic Certifique-se de selecionar aquele com o valor allow_user_image_creation de true e o user_data_format necessário para que seu sistema operacional inicialize e inicialize corretamente. Para obter mais informações, consulte Considerações sobre o formato de dados do usuário

O exemplo a seguir importa uma imagem customizada com o nome my-image, local de origem de cos://us-south/my-bucket/my-image.qcow2 e o sistema operacional para a imagem é debian-9-amd64.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      }
    }'

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      },
      "deprecation_at": "2023-03-01T06:11:28+05:30",
      "obsolescence_at": "2023-12-31T06:11:28+05:30"
    }'

Importação de uma imagem personalizada usando o Terraform

Para usar o Terraform, baixe o Terraform CLI e configure o plug-in do provedor IBM Cloud. Para obter mais informações, consulte Introdução ao Terraform.

Certifique-se de que a sua imagem customizada compatível esteja disponível no IBM Cloud Object Storage. Para obter mais informações, consulte Criação de uma imagem personalizada do Linux, Criação de uma imagem personalizada do Windows, Criação de uma imagem personalizada do sistema operacional genérico, Traga sua própria licença e Carregamento de dados para IBM Cloud Object Storage. Para incluir expressões de uso permitido, consulte Adição de expressões de uso permitido a imagens personalizadas.

Quando você tiver uma imagem disponível no IBM Cloud Object Storage, poderá importá-la para a infraestrutura do IBM Cloud VPC usando o Terraform.

Para importar uma imagem personalizada usando o Terraform, use o comando de recurso do Terraform ibm_is_image.

Especifique o nome da imagem personalizada a ser criada usando o valor name. O nome não pode ser usado por outra imagem na região e nomes que começam com ibm- são reservados para imagens fornecidas pelo sistema. Você também deve especificar a origem; por exemplo, especifique o valor href com o local do arquivo de imagem. Especifique o valor operating_system com o nome do sistema operacional para a imagem.

resource "ibm_is_image" "example" {
  name               = "my-image"
  href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
  operating_system   = "ubuntu-16-04-amd64"
}

Planejar mudanças de status do ciclo de vida da imagem customizada usando o Terraform

Ao importar uma imagem customizada usando o Terraform, também é possível planejar as mudanças de status do ciclo de vida de uma imagem customizada IBM Cloud VPC ao mesmo tempo usando o comando de recurso do Terraform ibm_is_image.

O atributo name não pode ser usado por outra imagem na região e nomes que começam com ibm- são reservados para imagens fornecidas pelo sistema.

Para planejar os atributos deprecation_at ou obsolescence_at, especifique uma data no formato de data e hora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY é o ano com quatro dígitos
• MM é o mês de dois dígitos
• DD é o dia de dois dígitos
• T separa as informações de data e hora
• hh é as horas de dois dígitos
• mm são os minutos com dois dígitos
• +hh:mm ou -hh:mm é o fuso horário da Hora Universal Coordenada

Assim, a data de 30 de setembro de 2023 às 20h no fuso horário do North American Central Standard (CST) seria 2023-09-30T20:00:00-06:00

Ao planejar a data e hora, não é possível usar sua data e hora atuais. Por exemplo, se for 8h em 12 de junho, a data e hora planejadas deverão ser posteriores às 8h em 12 de junho Se você definir as datas e horas deprecation_at e obsolescence_at, a data obsolescence_at deverá ser posterior à data e à hora deprecation_at

O exemplo a seguir importa uma imagem customizada com o nome example-image, local de origem de cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd e o sistema operacional para a imagem é ubuntu-16-04-amd64. A imagem está planejada para ser descontinuada no 2023-11-28T15:10:00.000Z A imagem está planejada para ser obsoleta no 2023-11-28T15:10:00.000Z

• Planejar uma mudança de status para deprecated.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecated_at      = "2023-11-28T15:10:00.000Z"
  }
  

• Planejar uma mudança de status para obsolete.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    obsolescence_at    = "2023-11-28T15:10:00.000Z"
  }
  

Validando uma imagem customizada importada usando a IU

Depois de importar uma imagem personalizada, você pode visualizar a soma de verificação gerada para a imagem no momento da importação em IBM Cloud VPC.

Se você gerar uma soma de verificação localmente para a sua imagem antes de importá-la, poderá comparar as duas somas de verificação para se certificar de que são idênticas. As somas de verificação correspondentes indicam que a imagem está inalterada.

1. No IBM Cloud console, acesse o ícone Menu > Infraestrutura do VPC> Cálculo> Imagens.
2. Na guia “Imagens personalizadas”, na lista de imagens personalizadas, clique no nome da imagem personalizada que você deseja validar.
3. No painel lateral de detalhes da imagem, localize o campo “Checksum” ( SHA256 ). Você vê conteúdos semelhantes a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

Apenas para imagens personalizadas z/OS Wazi aaS: Não é possível validar a soma de verificação das imagens personalizadas importadas que são implantadas a partir de Wazi Image Builder.

4. Compare o valor de Soma de Verificação (SHA256) à saída que é gerada quando você calcula uma soma de verificação para a imagem localmente.

   • Exemplo de comando do Linux: sha256sum ubuntu_image.qcow2
   • Exemplo de comando do Mac: shasum -a 256 ubuntu_image.qcow2
   • Você receberá uma saída semelhante a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. Crie uma instância de servidor virtual ou um servidor bare metal usando essa imagem Para obter mais informações, consulte Criar uma instância do servidor virtual ou Criando Bare Metal Servers no VPC.

Validando uma imagem customizada importada usando a CLI

Depois de importar uma imagem personalizada, você pode visualizar a soma de verificação gerada para a imagem no momento da importação em IBM Cloud VPC.

Se você gerar uma soma de verificação localmente para a sua imagem antes de importá-la, poderá comparar as duas somas de verificação para se certificar de que são idênticas. As somas de verificação correspondentes indicam que a imagem está inalterada.

Para validar uma imagem customizada importada usando a CLI, use o comando ibmcloud is image.

Primeiro, visualize os detalhes da imagem customizada importada que você deseja validar Especifique o nome ou ID da imagem customizada a ser criada usando a variável IMAGE.

ibmcloud is image IMAGE

Para obter mais informações, consulte “ibmcloud is image” na página de referência da CLI do VPC.

O exemplo a seguir visualiza os detalhes de uma imagem customizada com o ID de r006-1d1e92e9-6550-4d06-8483-d674310045fd

ibmcloud is image r006-1d1e92e9-6550-4d06-8483-d674310045fd

Getting image r006-1d1e92e9-6550-4d06-8483-d674310045fd under account Rios IMSLess as user gbgrout@ibm.com...
ID                             r006-589548bd-9241-4ad7-a610-1df6ba020793
Name                           my-image-from-volume-cli-1
CRN                            crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-589548bd-9241-4ad7-a610-1df6ba020793
Status                         available
Operating system               Name             Architecture   Vendor   Version                 Dedicated host only
                               centos-7-amd64   amd64          CentOS   7.x - Minimal Install   false
Source volume                  ID                                          Name
                               r006-6438d80f-4433-4445-be2f-0cca05afff3e   transpose-clubhouse-putt-repent
Created                        2023-03-16T01:11:03+05:30
Deprecation Date               2023-03-01T06:11:28+05:30
Obsolescence Date              2023-12-31T06:11:28+05:30
Visibility                     private
Minimum provisioned size(GB)   250
SHA256 Checksum                774d44ac0d55f2bfe869b995565715e5d9970ec23ce7127b2e2776b2618a9f7c
File size(GB)                  2
Encryption                     none
Resource group                 11caaa983d9c4beb82690daab08717e9
Resource type                  image
Catalog Offering Managed       false

Compare o valor da soma de verificação retornado ( SHA256 ) com o resultado gerado ao calcular a soma de verificação da imagem localmente.

• Exemplo de comando do Linux: sha256sum ubuntu_image.qcow2
• Exemplo de comando do Mac: shasum -a 256 ubuntu_image.qcow2
• Você receberá uma saída semelhante a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Depois de validar o Checksum (SHA256), use a imagem para criar um servidor virtual. Consulte Criando uma instância de servidor virtual usando a CLI.

Validando uma imagem customizada importada usando a API

Depois de importar uma imagem personalizada, você pode visualizar a soma de verificação gerada para a imagem no momento da importação em IBM Cloud VPC.

Se você gerar uma soma de verificação localmente para a sua imagem antes de importá-la, poderá comparar as duas somas de verificação para se certificar de que são idênticas. As somas de verificação correspondentes indicam que a imagem está inalterada.

Para validar como imagem customizada usando a API, use Listar todas as imagens.

Para o $image_id, especifique o ID da imagem customizada que deseja validar.

curl -X GET "$vpc_api_endpoint/v1/images/$image_id/?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token"

Compare o valor da soma de verificação retornado ( SHA256 ) com o resultado gerado ao calcular a soma de verificação da imagem localmente.

• Exemplo de comando do Linux: sha256sum ubuntu_image.qcow2
• Exemplo de comando do Mac: shasum -a 256 ubuntu_image.qcow2
• Você receberá uma saída semelhante a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Depois de validar o Checksum (SHA256), use a imagem para criar um servidor virtual. Consulte Criando uma instância de servidor virtual usando a API.