Importación de una imagen personalizada utilizando la interfaz de usuario

Cuando tenga una imagen disponible en IBM Cloud Object Storage, puede importarla a la infraestructura de IBM Cloud VPC utilizando la consola de IBM Cloud.

1. Asegúrese de que la imagen personalizada compatible esté disponible en IBM Cloud Object Storage. Para cargar una imagen en IBM Cloud Object Storage, en la página Objetos del grupo, pulse Cargar. Puede utilizar el plugin de transferencia de alta velocidad de Aspera para cargar imágenes de más de 200 MB. Para obtener más información, consulte Creación de una imagen personalizada de Linux, Creación de una imagen personalizada de Windows, Traer su propia licencia y Carga de datos en IBM Cloud Object Storage.
2. En la consola deIBM Cloud, vaya al icono de menú > Infraestructura de VPC > Cálculo > Imágenes.
3. En la pestaña Imágenes personalizadas, pulse Crear.
4. Rellena los campos que se describen en la Tabla 1 y haz clic en Crear imagen personalizada.

Importación de una imagen personalizada utilizando la CLI

Asegúrese de que la imagen personalizada compatible esté disponible en IBM Cloud Object Storage. Para obtener más información, consulte Creación de una imagen personalizada de Linux, Creación de una imagen personalizada de Windows, Creación de una imagen personalizada de un sistema operativo genérico, Traiga su propia licencia y Carga de datos en IBM Cloud Object Storage. Para incluir expresiones de uso permitido, consulte Agregar expresiones de uso permitido a imágenes personalizadas.

Cuando una imagen está disponible en IBM Cloud Object Storage, puede importarla a la infraestructura IBM Cloud VPC utilizando la interfaz de comando (CLI).

Para importar una imagen personalizada utilizando la CLI, utilice el mandato ibmcloud is image-create. Especifique el nombre de la imagen personalizada utilizando la variable IMAGE_NAME. El nombre no puede ser utilizado por otra imagen de la región y los nombres que empiezan por ibm- están reservados para las imágenes proporcionadas por el sistema. Debe especificar la fuente; por ejemplo, especifique la opción --file con la ubicación del archivo de imagen. Especifique la opción --os-name con el nombre del sistema operativo para la imagen.

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

El ejemplo siguiente crea una imagen personalizada con el nombre my-ubuntu-16-amd64. La ubicación de origen de imagen es cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2. El sistema operativo es 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 obtener más información, consulta ibmcloud is image-create en la página de referencia de la CLI de 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

Importación de una imagen personalizada utilizando la API

Asegúrese de que la imagen personalizada compatible esté disponible en IBM Cloud Object Storage. Para obtener más información, consulte Creación de una imagen personalizada de Linux, Creación de una imagen personalizada de Windows, Creación de una imagen personalizada de un sistema operativo genérico, Traiga su propia licencia y Carga de datos en IBM Cloud Object Storage. Para incluir una expresión de uso permitido, consulte Adición de expresiones de uso permitido a imágenes personalizadas.

Cuando tenga una imagen disponible en IBM Cloud Object Storage, puede importarla a la infraestructura de IBM Cloud VPC utilizando la interfaz de programación de aplicaciones (API).

Para importar una imagen personalizada utilizando la API, utilice Crear una imagen.

name no puede ser utilizado por otra imagen de la región y los nombres que empiezan por ibm- están reservados para las imágenes proporcionadas por el sistema. Especifique la subpropiedad file.href con la ubicación de la imagen. Especifique la subpropiedad operating_system.name con el nombre del sistema operativo de la imagen.

Las imágenes personalizadas genéricas del sistema operativo son una función beta y están disponibles con fines de evaluación y prueba. Los sistemas operativos genéricos tienen family de Generic. Asegúrese de seleccionar el que tenga el valor allow_user_image_creation de true y el user_data_format necesario para que el sistema operativo arranque e inicialice correctamente. Para obtener más información, consulte Consideraciones sobre el formato de datos de usuario.

El ejemplo siguiente importa una imagen personalizada con el nombre de my-image, la ubicación de origen de cos://us-south/my-bucket/my-image.qcow2 y el sistema operativo para la imagen es 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"
    }'

Importación de una imagen personalizada mediante Terraform

Para utilizar Terraform, descargue la CLI de Terraform y configure el complemento del proveedor IBM Cloud. Para obtener más información, consulte Introducción a Terraform.

Asegúrese de que la imagen personalizada compatible esté disponible en IBM Cloud Object Storage. Para obtener más información, consulte Creación de una imagen personalizada de Linux, Creación de una imagen personalizada de Windows, Creación de una imagen personalizada de un sistema operativo genérico, Traiga su propia licencia y Carga de datos en IBM Cloud Object Storage. Para incluir expresiones de uso permitido, consulte Agregar expresiones de uso permitido a imágenes personalizadas.

Cuando dispongas de una imagen en IBM Cloud Object Storage, podrás importarla a la infraestructura de IBM Cloud VPC mediante Terraform.

Para importar una imagen personalizada mediante Terraform, utilice el comando recursos de Terraform ibm_is_image.

Especifique el nombre de la imagen personalizada que se creará utilizando el valor name. El nombre no puede ser utilizado por otra imagen de la región y los nombres que empiezan por ibm- están reservados para las imágenes proporcionadas por el sistema. También debe especificar la fuente; por ejemplo, especifique el valor href con la ubicación del archivo de imagen. Especifique el valor operating_system con el nombre del sistema operativo para la imagen.

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

Planificar cambios de estado de ciclo de vida de imagen personalizada utilizando Terraform

Al importar una imagen personalizada utilizando Terraform, también puede planificar los cambios de estado de ciclo de vida de una imagen personalizada IBM Cloud VPC al mismo tiempo utilizando el mandato de recurso de Terraform ibm_is_image.

El atributo name no puede ser utilizado por otra imagen de la región y los nombres que empiezan por ibm- están reservados para las imágenes proporcionadas por el sistema.

Para planificar los atributos deprecation_at o obsolescence_at, especifique una fecha en el formato de fecha y hora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY es el año de cuatro dígitos
• MM es el mes de dos dígitos
• DD es el día de dos dígitos
• T separa la información de fecha y hora
• hh son las horas de dos dígitos
• mm son los minutos de dos dígitos
• +hh:mm o -hh:mm es el huso horario universal coordinado

Por lo tanto, la fecha del 30 de septiembre de 2023 a las 8:00 PM en el huso horario estándar de América del Norte (CST) sería 2023-09-30T20:00:00-06:00

Cuando planifica la fecha y la hora, no puede utilizar la fecha y la hora actuales. Por ejemplo, si son las 8:00 AM del 12 de junio, la fecha y hora planificadas deben ser posteriores a las 8:00 AM del 12 de junio. Si define las fechas y horas deprecation_at y obsolescence_at, la fecha obsolescence_at debe ser posterior a la fecha y hora deprecation_at.

El ejemplo siguiente importa una imagen personalizada con el nombre de example-image, la ubicación de origen de cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd y el sistema operativo para la imagen es ubuntu-16-04-amd64. La imagen está planificada para que esté en desuso en 2023-11-28T15:10:00.000Z. La imagen está planificada para que sea obsoleta en 2023-11-28T15:10:00.000Z.

• Planifique un cambio de estado a 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"
  }
  

• Planifique un cambio de estado a 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"
  }
  

Validación de una imagen personalizada importada utilizando la interfaz de usuario

Una vez importada una imagen personalizada, puedes consultar la suma de comprobación que se generó para dicha imagen al importarla a IBM Cloud VPC.

Si generas una suma de comprobación localmente para tu imagen antes de importarla, puedes comparar las dos sumas de comprobación para asegurarte de que son idénticas. Sumas de comprobación coincidentes indican que la imagen no se ha modificado.

1. En la consola deIBM Cloud, vaya al icono de menú > Infraestructura de VPC > Cálculo > Imágenes.
2. En la pestaña Imágenes personalizadas, en la lista de imágenes personalizadas, haz clic en el nombre de la imagen personalizada que quieras validar.
3. En el panel lateral de detalles de la imagen, localiza el campo Checksum ( SHA256 ). Verás contenidos similares a los de 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

Para z/OS Wazi aaS solo imagen personalizada: No se puede validar la suma de comprobación de las imágenes personalizadas importadas que se implementan desde Wazi Image Builder.

4. Compare el valor de la suma de comprobación (Checksum (SHA256)) con la salida que se genera cuando se calcula una suma de comprobación para la imagen localmente.

   • Ejemplo de mandato de Linux: sha256sum ubuntu_image.qcow2
   • Ejemplo de mandato de Mac: shasum -a 256 ubuntu_image.qcow2
   • Obtendrás un resultado similar al siguiente: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. Cree una instancia de servidor virtual o un servidor nativo utilizando esta imagen. Para obtener más información, consulte Crear una instancia de servidor virtual o Creación de Bare Metal Servers en VPC.

Validación de una imagen personalizada importada utilizando la CLI

Una vez importada una imagen personalizada, puedes consultar la suma de comprobación que se generó para dicha imagen al importarla a IBM Cloud VPC.

Si generas una suma de comprobación localmente para tu imagen antes de importarla, puedes comparar las dos sumas de comprobación para asegurarte de que son idénticas. Sumas de comprobación coincidentes indican que la imagen no se ha modificado.

Para validar una imagen personalizada importada utilizando la CLI, utilice el mandato ibmcloud is image.

En primer lugar, vea los detalles de la imagen personalizada importada que desea validar. Especifique el nombre o el ID de la imagen personalizada que se va a crear utilizando la variable IMAGE.

ibmcloud is image IMAGE

Para obtener más información, consulta ibmcloud is image en la página de referencia de la CLI de VPC.

El ejemplo siguiente muestra los detalles de una imagen personalizada con el 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

Compara el valor de la suma de comprobación devuelta ( SHA256 ) con el resultado que se genera al calcular una suma de comprobación de la imagen de forma local.

• Ejemplo de mandato de Linux: sha256sum ubuntu_image.qcow2
• Ejemplo de mandato de Mac: shasum -a 256 ubuntu_image.qcow2
• Obtendrás un resultado similar al siguiente: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Después de validar la suma de comprobación (SHA256), utilice la imagen para crear un servidor virtual. Consulte Creación de una instancia de servidor virtual utilizando la CLI.

Validación de una imagen personalizada importada utilizando la API

Una vez importada una imagen personalizada, puedes consultar la suma de comprobación que se generó para dicha imagen al importarla a IBM Cloud VPC.

Si generas una suma de comprobación localmente para tu imagen antes de importarla, puedes comparar las dos sumas de comprobación para asegurarte de que son idénticas. Sumas de comprobación coincidentes indican que la imagen no se ha modificado.

Para validar como imagen personalizada utilizando la API, utilice Listar todas las imágenes.

Para $image_id, especifique el ID de la imagen personalizada que desea validar.

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

Compara el valor de la suma de comprobación devuelta ( SHA256 ) con el resultado que se genera al calcular una suma de comprobación de la imagen de forma local.

• Ejemplo de mandato de Linux: sha256sum ubuntu_image.qcow2
• Ejemplo de mandato de Mac: shasum -a 256 ubuntu_image.qcow2
• Obtendrás un resultado similar al siguiente: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Después de validar la suma de comprobación (SHA256), utilice la imagen para crear un servidor virtual. Consulte Creación de una instancia de servidor virtual utilizando la API.