Gestión de imágenes personalizadas utilizando la interfaz de usuario

Puede gestionar una imagen utilizando la consola de IBM Cloud.

1. En la consol IBM Cloud, ve al del menú de navegación > > Computación > Imágenes.
2. En la pestaña Imágenes personalizadas, pulse el icono Acciones para una imagen específica y seleccione entre las opciones disponibles. Las imágenes personalizadas cifradas se identifican mediante un icono de candado después del nombre de la imagen. Puede seleccionar una de las acciones siguientes:

Listado de imágenes personalizadas utilizando la CLI

Puede listar todas las imágenes personalizadas de IBM Cloud VPC en su región utilizando la interfaz de línea de mandatos (CLI).

Para listar todas las imágenes personalizadas utilizando la CLI, utilice el mandato ibmcloud is images. Las imágenes personalizadas son privadas para la cuenta donde se crean, por lo que la opción --visibility es private.

ibmcloud is images --visibility private

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

Listado de todas las imágenes mediante la API

Puede listar todas las imágenes de IBM Cloud VPC de su región utilizando la interfaz de programación de aplicaciones (API).

Para listar todas las imágenes utilizando la API, utilice Listar todas las imágenes. Las imágenes personalizadas son privadas para la cuenta donde se crean, por lo que puede establecer la propiedad visibility en private para recuperar sólo imágenes personalizadas.

curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Listado de todas las imágenes utilizando Terraform

Puede listar todas las imágenes de IBM Cloud VPC en su región utilizando Terraform.

Para listar todas las imágenes utilizando Terraform, utilice el mandato de origen de datos de Terraform ibm_is_images. Las imágenes personalizadas son privadas en la cuenta donde se crean, por lo que puede establecer el atributo visibility en private para recuperar sólo imágenes personalizadas.

data "ibm_is_images" "images" {
  visibility = "public"
}

Cómo consultar los detalles de una imagen personalizada mediante la interfaz de usuario

Puede ver los siguientes detalles de una imagen personalizada:

• Expresiones de uso permitido
• Grupo de recursos asignado
• Suma de comprobación
• Fecha de creación
• CRN
• Fecha de desuso (si se ha establecido)
• Tipo de cifrado
• Ubicación
• Nombre e ID
• Fecha de obsolescencia (si se ha establecido)
• Sistema operativo y versión
• Tamaño
• Tipo de origen

Puede editar el nombre de la imagen personalizada, añadir etiquetas para la capacidad de búsqueda y ver y copiar el nombre de recurso de nube (CRN) exclusivo. El valor de la suma de comprobación SHA256 de la imagen es accesible.

Para ver los detalles de una imagen personalizada, siga estos pasos.

1. En la consol IBM Cloud, ve al del menú de navegación > > Computación > Imágenes.
2. En la pestaña Imágenes personalizadas, haga clic en el nombre de una imagen personalizada y, a continuación, en el panel siguiente, haga clic en View image details.
3. En la página Detalles de la imagen puede editar el nombre de la imagen, copiar la suma de comprobación, añadir etiquetas, copiar el CRN de la imagen y editar las expresiones de uso permitido de la imagen.
4. Desde el menú Acciones de la página Detalles de la imagen, puedes realizar acciones como crear una instancia de servidor virtual a partir de la imagen personalizada o eliminar la imagen. Para obtener una lista completa de posibles acciones, consulte Gestión de imágenes personalizadas utilizando la interfaz de usuario.

Visualización de detalles de imagen personalizada utilizando la CLI

Puede ver los detalles de una imagen personalizada, como el nombre y el ID, el sistema operativo y la versión, el estado de cifrado, las fechas en desuso o obsolescencia y el grupo de recursos asignado, utilizando la interfaz de línea de mandatos (CLI).

Para ver los detalles de una imagen personalizada mediante la CLI, utiliza el comando ibmcloud is image. Especifique el nombre o el ID de la imagen personalizada con 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.

Recuperación de detalles de imagen personalizada utilizando la API

Puede ver los detalles de una imagen personalizada, como el nombre y el ID, el sistema operativo y la versión, el estado de cifrado, las fechas en desuso o obsolescencia y el grupo de recursos asignado, utilizando la interfaz de programación de aplicaciones (API).

Para recuperar los detalles de una imagen personalizada específica utilizando la API, utilice Recuperar una imagen. Para la variable $image_id, especifique el ID de la imagen personalizada que desea recuperar.

curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Recuperación de detalles de imagen personalizada utilizando Terraform

Puede ver los detalles de una imagen personalizada, como el nombre y el ID, el sistema operativo y la versión, el estado de cifrado, las fechas en desuso o obsolescencia y el grupo de recursos asignado, utilizando Terraform.

Para ver los detalles de una imagen utilizando Terraform, utilice el mandato de origen de datos de Terraform ibm_is_images. Para la variable name, especifique el nombre de la imagen personalizada que desea recuperar.

data "ibm_is_images" "image_name" {
}

Compartición de una imagen personalizada en un catálogo privado utilizando la interfaz de usuario

Puede compartir una imagen personalizada IBM Cloud VPC existente en un catálogo privado existente. Si todavía no tiene un catálogo privado, consulte Incorporación de una imagen de servidor virtual para VPC.

La acción Compartir imagen en catálogo privado no está disponible para las imágenes siguientes:

• La imagen ya se ha compartido en un catálogo privado. Una imagen de un catálogo privado sólo puede existir en una versión dentro de una oferta de producto en un catálogo privado. Debe eliminar la imagen de la versión en la que está en primer lugar antes de que la imagen se pueda compartir en una versión diferente.
• La imagen está cifrada.
• La imagen no es una imagen x86.

Para compartir una imagen personalizada en un catálogo privado, realice los pasos siguientes.

1. En la consol IBM Cloud, ve al del menú de navegación > > Computación > Imágenes.
2. En la pestaña Imágenes personalizadas, pulse el icono Acciones y seleccione Compartir en catálogo.
3. En la página Compartir imagen en catálogo privado, seleccione un Catálogo privado en la lista de catálogos privados disponibles.
4. Especifique un número de versión en Versión de software.
5. Pulse Crear oferta de catálogo para compartir la imagen con el catálogo privado.
6. Después de crear la imagen, pulse Validar imagen.

Este proceso comparte la imagen personalizada solo con el catálogo privado. El proceso de validación se produce dentro del catálogo privado. Pulsar Validar imagen le lleva a una página nueva y, desde esta pantalla, puede empezar con el Paso 3: Validar la imagen de servidor virtual en la incorporación de una imagen de servidor virtual para VPC para completar el proceso de validación.

Compartición de una imagen personalizada en un catálogo privado utilizando la CLI

Puede compartir una imagen personalizada solo en un catálogo privado de IBM Cloud VPC utilizando la interfaz de usuario. Para obtener más información sobre cómo incorporar un catálogo privado mediante el CLI, consulte Incorporación de software a su cuenta.

Compartición de una imagen personalizada en un catálogo privado utilizando la API

Puede compartir una imagen personalizada solo en un catálogo privado de IBM Cloud VPC utilizando la interfaz de usuario. Para obtener más información sobre cómo incorporar un catálogo privado mediante la API, consulte Incorporación de software a su cuenta.

Compartición de una imagen personalizada en un catálogo privado utilizando Terraform

Puede compartir una imagen personalizada solo en un catálogo privado de IBM Cloud VPC utilizando la interfaz de usuario. Para obtener más información sobre cómo incorporar un catálogo privado mediante Terraform, consulte Incorporación de software a su cuenta.

Programar un cambio de estado del ciclo de vida de la imagen personalizado en la consola

Puede planificar un único cambio de estado de ciclo de vida de imagen o planificar los cambios de estado para todo el ciclo de vida de la imagen. Puede realizar un cambio de estado inmediato sólo si no ha planificado un cambio de estado futuro.

Siga estos pasos para planificar un único cambio de estado:

Puede planificar un único cambio de estado para una imagen.

1. En la consola IBM Cloud, diríjase al menú de navegación > Infraestructura > Compute > Imágenes.
2. En la pestaña Imágenes personalizadas, pulse el icono Acciones para una imagen específica y seleccione entre las opciones disponibles.
3. Seleccione Planificar ciclo de vida.
4. En Estado de imagen, seleccione el cambio de estado para la imagen.
5. En Detalles de característica en desuso, seleccione si desea cambiar el estado Inmediatamente o Planificar fecha futura.
6. Si ha seleccionado Programar fecha futura, deberá rellenar los siguientes campos:
   • Seleccione Por fecha de calendario o Por número de días.
     • Si ha seleccionado Por fecha de calendario, especifique la información de fecha y hora. Es la fecha y hora en que se producirá el cambio de estado.
     • Si ha seleccionado Por número de días, ponga el número de días que pasarán antes de cambiar el estado.
7. Pulse Guardar.

Siga estos pasos para planificar todo el ciclo de vida de la imagen:

Puede planificar el ciclo de vida completo para la imagen. La imagen primero está en desuso y, a continuación, cambia a obsoleta de acuerdo con la planificación que defina. Utilice los pasos siguientes para planificar un cambio de ciclo de vida.

1. En la consola IBM Cloud, diríjase al menú de navegación > Infraestructura > Compute > Imágenes.

2. En la pestaña Imágenes personalizadas, pulse el icono Acciones para una imagen específica y seleccione entre las opciones disponibles.

3. Seleccione Planificar ciclo de vida.

4. Seleccione Programar ciclo de vida completo.

   • Si ha seleccionado Por fecha de calendario, especifique la fecha y hora en que desea que se produzca el cambio de estado.
   • Si ha seleccionado Por número de días, ponga el número de días que desea pasar antes de cambiar el estado.

   La fecha de obsolescencia debe ser posterior a la fecha de obsolescencia.

5. Pulse Planificación.

Cambiar el estado del ciclo de vida de la imagen personalizada utilizando la CLI

Puede cambiar el estado del ciclo de vida de una imagen personalizada de IBM Cloud VPC utilizando la interfaz de línea de mandatos (CLI). Puede realizar un cambio de estado inmediato utilizando los mandatos ibmcloud is image-deprecate o ibmcloud is image-obsoleto. También puede planificar estos cambios de estado para una fecha y hora futuras utilizando el mandato ibmcloud is image-update. Especifique el nombre o el ID de la imagen personalizada con la variable IMAGE.

Para realizar un cambio de estado inmediato, utilice uno de los ejemplos siguientes.

Puede realizar un cambio de estado inmediato sólo si un cambio de estado futuro no está planificado. Para eliminar un cambio de estado planificado, consulte Eliminar un cambio de estado de ciclo de vida de imagen personalizado planificado utilizando la CLI. Después de eliminar el cambio de estado planificado, puede realizar un cambio de estado inmediato.

• Cambie el estado del ciclo de vida de la imagen a deprecate.

  ibmcloud is image-deprecate IMAGE
  

• Cambie el estado del ciclo de vida de la imagen a obsolete.

  ibmcloud is image-obsolete IMAGE
  

Para planificar un cambio de estado, utilice el ejemplo siguiente.

Para la opción deprecate-at o obsolete-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 UTC

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

Al planificar la fecha y hora, no puede utilizar la fecha y hora actual. 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 deprecate-at y obsolete-at, la fecha obsolete-at debe ser posterior a la fecha deprecate-at.

ibmcloud is image-update IMAGE [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

Si desea cambiar las entradas de fecha y hora deprecate-at y obsolete-at, puede volver a ejecutar estos mandatos. Las fechas y horas anteriores se sustituyen por las nuevas fechas y horas.

Eliminar un cambio de estado de ciclo de vida de imagen personalizado planificado anteriormente utilizando la CLI

Puede eliminar un cambio de estado planificado utilizando las opciones --reset-deprecate-at o --reset-obsolete-at . Si utiliza cualquiera de estas opciones con el mandato ibmcloud is image-update , la fecha y la hora se eliminan de la imagen. La imagen ya no está planificada para ese cambio de estado.

ibmcloud is image-update IMAGE [--reset-deprecate-at] [--reset-obsolete-at]

Si utiliza las opciones --reset-deprecate-at y --reset-obsolete-at , el estado de la imagen vuelve a available.

Cambiar el estado del ciclo de vida de la imagen personalizada utilizando la API

Puede cambiar el estado del ciclo de vida de una imagen personalizada IBM Cloud VPC utilizando la interfaz de programación de aplicaciones (API). Puede realizar un cambio de estado inmediato o planificar un cambio de estado para que se produzca más tarde.

Para realizar un cambio de estado inmediato, utilice uno de los ejemplos siguientes. Para la variable $image_id, especifique el ID de la imagen personalizada para el cambio de estado.

Puede realizar un cambio de estado inmediato sólo si un cambio de estado futuro no está planificado. Para eliminar un cambio de estado planificado, consulte Eliminar un cambio de estado de ciclo de vida de imagen personalizado planificado utilizando la API. Después de eliminar el cambio de estado planificado, puede realizar un cambio de estado inmediato.

• Cambie el estado del ciclo de vida de la imagen a deprecated.

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

• Cambie el estado del ciclo de vida de la imagen a obsolete.

  curl -X POST "$vpc_api_endpoint/v1/images/$image_id/obsolete?version=2023-12-21&generation=2" -H “Authorization: Bearer $iam_token”
  

Para planificar un cambio de estado, utilice uno de los ejemplos siguientes.

Para las propiedades 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 UTC

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

Al planificar la fecha y hora, no puede utilizar la fecha y hora actual. 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.

• Planifique un cambio de estado a deprecated.

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
   "deprecation_at": "2023-03-01T06:11:28+05:30" }'
  

• Planifique un cambio de estado a obsolete.

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
   “obsolescence_at": "2023-12-31T06:11:28+05:30" }'
  

  Si desea cambiar las entradas de fecha y hora deprecation_at y obsolescence_at, puede volver a ejecutar estos mandatos. Las fechas y horas anteriores se sustituyen por las nuevas fechas y horas.

Eliminar el estado de ciclo de vida de imagen personalizada planificada anteriormente utilizando la API

Realice una solicitud PATCH /images para eliminar cualquier cambio de estado planificado actualizando deprecation_at o obsolescence_at a null. Este cambio de propiedad elimina la fecha y hora de la imagen y la imagen ya no está planificada para ese cambio de estado.

• Para cambiar una imagen de deprecated a available, cambie la propiedad deprecation_at a null.

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null }'
  

• Para cambiar una imagen de obsolete a su estado anterior, cambie obsolescence_at a null. Si la imagen contenía anteriormente un valor distinto de null para deprecation_at, este cambio de propiedad elimina el estado obsolete y lo vuelve a cambiar a deprecated. Si el estado anterior era available, lo que significa que la imagen se ha movido de available directamente a obsolete, este cambio de propiedad se mueve de obsolete de nuevo a available.

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": null }'
  

• Para cambiar una imagen que tiene las propiedades deprecation_at o obsolescence_at establecidas de nuevo en available, debe actualizar las propiedades deprecation_at o obsolescence_at .

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null, “obsolescence_at": null }'
  

Cambiar el estado del ciclo de vida de la imagen personalizada mediante Terraform

Para realizar un cambio de estado inmediato mediante Terraform, utilice el ibm_is_image_deprecate o ibm_is_image_obsolete comandos de recursos. Utilice uno de los siguientes ejemplos. Para la variable name, especifique el nombre de la imagen personalizada para el cambio de estado.

Puede realizar un cambio de estado inmediato sólo si un cambio de estado futuro no está planificado. Para eliminar un cambio de estado planificado, consulte Eliminar un cambio de estado de ciclo de vida de imagen personalizado planificado utilizando Terraform. Después de eliminar el cambio de estado planificado, puede realizar un cambio de estado inmediato.

• Cambie el estado del ciclo de vida de la imagen 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"
    encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
    encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
  }
  resource "ibm_is_image_deprecate" "example" {
    image               = ibm_is_image.example.id
  }
  

• Cambie el estado del ciclo de vida de la imagen 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"
    encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
    encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
  }
  resource "ibm_is_image_obsolete" "example" {
    image               = ibm_is_image.example.id
  }
  

Para planificar un cambio de estado, utilice uno de los ejemplos siguientes.

Para el atributo 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 en dos dígitos
• DD es el día de dos dígitos
• T separa la información de fecha y hora
• hh son las dos cifras de las horas
• mm son los minutos en dos dígitos
• +hh:mm o -hh:mm es la zona horaria del Tiempo Universal Coordinado

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

Cuando programes la fecha y la hora, no podrás utilizar tu fecha y 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.

• 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"
    deprecation_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"
  }
  

  Si desea cambiar las entradas de fecha y hora deprecation_at y obsolescence_at, puede volver a ejecutar estos mandatos. Las fechas y horas anteriores se sustituyen por las nuevas fechas y horas.

Eliminar el estado del ciclo de vida de la imagen personalizada programado previamente mediante Terraform

Para eliminar cualquier cambio de estado planificado, actualice los atributos deprecation_at o obsolescence_at a null. Este cambio de atributo elimina la fecha y hora de la imagen y la imagen ya no está planificada para ese cambio de estado.

• Para cambiar una imagen de deprecated a available, cambie la propiedad deprecation_at a null.

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

• Para cambiar una imagen de obsolete a su estado anterior, cambie obsolescence_at a null. Si la imagen contenía anteriormente un valor distinto de null para deprecation_at, este cambio de atributo elimina el estado obsolete y lo vuelve a cambiar a deprecated. Si el estado anterior era available, lo que significa que la imagen se ha movido de available directamente a obsolete, este cambio de atributo se mueve de obsolete de nuevo a available.

  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    = null
  }
  

• Para cambiar una imagen que tiene las propiedades deprecation_at o obsolescence_at establecidas de nuevo en available, debe actualizar los atributos deprecation_at o obsolescence_at.

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