Gestion des images à partir d'un volume

Les images personnalisées créées à partir d'un volume sont indépendantes du volume d'origine. Vous pouvez mettre à jour l'image et la supprimer si nécessaire. Vous pouvez supprimer le volume d'origine ; l'image personnalisée est conservée. Vous pouvez planifier l'obsolescence et rendre l'image obsolète dans la console, à partir de l'interface de ligne de commande ou de l'API.

Expressions d'utilisation autorisée : Vous pouvez utiliser une expression d'utilisation autorisée avec votre image personnalisée pour définir les capacités et les restrictions d'une image et vous aider à trouver des combinaisons d'images et de profils compatibles lors de la création du serveur. La valeur par défaut des expressions d'utilisation autorisée pour toutes les images personnalisées créées à partir d'un volume est celle des expressions d'utilisation autorisée du volume source d'origine. Toutefois, vous pouvez modifier ces expressions d'utilisation autorisée dans l'image personnalisée. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Planification d'un changement de statut de cycle de vie pour une image personnalisée à l'aide de l'interface utilisateur

Vous pouvez planifier un changement de statut de cycle de vie d'image unique ou planifier les changements de statut pour l'ensemble du cycle de vie de l'image.

Procédez comme suit pour planifier un seul changement de statut:

Vous pouvez planifier un seul changement de statut pour une image.

  1. Dans la console IBM Cloud, allez dans le menu de navigation- icône menu > icône Infrastructure VPC > Compute > Images.
  2. Dans l'onglet Images personnalisées, cliquez sur l'icône Actions icône Actions supplémentaires pour une image spécifique et sélectionnez l'une des options disponibles.
  3. Sélectionnez Planifier le cycle de vie.
  4. Dans Statut de l'image, sélectionnez le changement de statut de l'image.
  5. Dans Détails de l'obsolescence, indiquez si vous souhaitez modifier le statut Immédiatement ou Planifier une date future.
  6. Si vous avez sélectionné Schedule future date, vous devez remplir les champs suivants :
    • Sélectionnez Par date calendaire ou Par nombre de jours.
      • Si vous avez sélectionné Par date calendaire, entrez les informations de date et d'heure. Il s'agit de la date et de l'heure auxquelles le changement de statut aura lieu.
      • Si vous avez sélectionné Par nombre de jours, indiquez le nombre de jours qui s'écouleront avant que le statut ne soit modifié.
  7. Cliquez sur Sauvegarder.

Pour planifier l'intégralité du cycle de vie de l'image, procédez comme suit:

Vous pouvez planifier le cycle de vie complet de l'image. L'image est d'abord obsolète, puis devient obsolète en fonction du planning que vous définissez. Procédez comme suit pour planifier un changement de cycle de vie.

  1. Dans la console IBM Cloud, allez dans le menu de navigation- icône menu > icône Infrastructure VPC > Compute > Images.

  2. Dans l'onglet Images personnalisées, cliquez sur l'icône Actions icône Actions supplémentaires pour une image spécifique et sélectionnez l'une des options disponibles.

  3. Sélectionnez Planifier le cycle de vie.

  4. Sélectionnez Planifier le cycle de vie complet.

    • Si vous avez sélectionné Par date calendaire, entrez la date et l'heure auxquelles vous souhaitez que le changement de statut se produise.
    • Si vous avez sélectionné Par nombre de jours, indiquez le nombre de jours à passer avant le changement de statut.

    La date d'obsolescence doit être postérieure à la date d'obsolescence.

  5. Cliquez sur Planifier.

Modification du statut de cycle de vie d'une image personnalisée à l'aide de l'interface de ligne de commande

Vous pouvez modifier le statut du cycle de vie d'une image IBM Cloud VPC créée à partir d'un volume à partir de l'interface de ligne de commande (CLI). Vous pouvez effectuer un changement de statut immédiat à l'aide des commandes ibmcloud is image-deprecate ou ibmcloud is image-obsolete. Vous pouvez également planifier ces changements de statut pour une date et une heure ultérieures à l'aide de la commande ibmcloud is image-update. Indiquez le nom ou l'ID de l'image personnalisée avec la variable IMAGE.

Pour effectuer un changement de statut immédiat, utilisez l'un des exemples suivants.

Vous pouvez effectuer un changement de statut immédiat uniquement si un changement de statut futur n'est pas planifié. Pour retirer un changement de statut planifié, voir Retrait d'un changement de statut de cycle de vie d'image personnalisé planifié à l'aide de l'interface de ligne de commande. Après avoir supprimé le changement de statut planifié, vous pouvez effectuer un changement de statut immédiat.

  • Remplacez le statut du cycle de vie de l'image par deprecate.

    ibmcloud is image-deprecate IMAGE
    
  • Remplacez le statut du cycle de vie de l'image par obsolete.

    ibmcloud is image-obsolete IMAGE
    

Pour planifier un changement de statut, utilisez l'exemple suivant.

Pour l'option deprecate-at ou obsolete-at, indiquez une date au format de date et d'heure ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

  • YYYY est l'année à quatre chiffres
  • MM est le mois à deux chiffres
  • DD est le jour à deux chiffres
  • T sépare les informations de date et d'heure
  • hh est le nombre d'heures à deux chiffres
  • mm est le nombre de minutes à deux chiffres
  • +hh:mm ou -hh:mm est le fuseau horaire UTC

Ainsi, la date du 30 septembre 2023 à 20h00 dans le fuseau horaire central (CST) de l'Amérique du Nord serait 2023-09-30T20:00:00-06:00

Lors de la planification de la date et de l'heure, vous ne pouvez pas utiliser la date et l'heure en cours. Par exemple, s'il s'agit de 8h00 le 12 juin, la date et l'heure planifiées doivent être postérieures à 8h00 le 12 juin. Si vous définissez à la fois les dates deprecate-at et obsolete-at, la date obsolete-at doit être postérieure à la date 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 vous souhaitez modifier les entrées de date et d'heure deprecate-at et obsolete-at, vous pouvez exécuter à nouveau ces commandes. Les dates et heures précédentes sont ensuite remplacées par les nouvelles dates et heures.

Suppression d'un changement de statut de cycle de vie précédemment planifié à l'aide de l'interface de ligne de commande

Vous pouvez supprimer un changement de statut planifié à l'aide des options --reset-deprecate-at ou --reset-obsolete-at . Si vous utilisez l'une de ces options avec la commande ibmcloud is image-update , la date et l'heure sont supprimées de l'image. L'image n'est plus planifiée pour ce changement de statut.

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

Si vous utilisez les options --reset-deprecate-at et --reset-obsolete-at , le statut de l'image revient à available.

Modification du statut de cycle de vie d'une image personnalisée à l'aide de l'API

Vous pouvez modifier le statut de cycle de vie d'une image IBM Cloud VPC créée à partir d'un volume à l'aide de l'interface de programme d'application (API). Vous pouvez effectuer un changement de statut immédiat ou planifier un changement de statut ultérieurement.

Pour effectuer un changement de statut immédiat, utilisez l'un des exemples suivants. Pour la variable $image_id, indiquez l'ID de l'image personnalisée pour le changement de statut.

Vous pouvez effectuer un changement de statut immédiat uniquement si un changement de statut futur n'est pas planifié. Pour supprimer un changement de statut planifié, voir Retrait d'un changement de statut de cycle de vie d'image personnalisé planifié à l'aide de l'API. Après avoir supprimé le changement de statut planifié, vous pouvez effectuer un changement de statut immédiat.

  • Remplacez le statut du cycle de vie de l'image par deprecated.

    curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token
  • Remplacez le statut du cycle de vie de l'image par obsolete.

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

Pour planifier un changement de statut, utilisez l'un des exemples suivants.

Pour les propriétés deprecation_at ou obsolescence_at, indiquez une date au format de date et d'heure ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

  • YYYY est l'année à quatre chiffres
  • MM est le mois à deux chiffres
  • DD est le jour à deux chiffres
  • T sépare les informations de date et d'heure
  • hh est le nombre d'heures à deux chiffres
  • mm est le nombre de minutes à deux chiffres
  • +hh:mm ou -hh:mm est le fuseau horaire UTC

Ainsi, la date du 30 septembre 2023 à 20h00 dans le fuseau horaire central (CST) de l'Amérique du Nord serait 2023-09-30T20:00:00-06:00

Lors de la planification de la date et de l'heure, vous ne pouvez pas utiliser la date et l'heure en cours. Par exemple, s'il s'agit de 8h00 le 12 juin, la date et l'heure planifiées doivent être postérieures à 8h00 le 12 juin. Si vous définissez à la fois les dates et heures deprecation_at et obsolescence_at, la date obsolescence_at doit être postérieure à la date et à l'heure deprecation_at.

  • Planifiez un changement de statut sur 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" }'
    
  • Planifiez un changement de statut sur 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 vous souhaitez modifier les entrées de date et d'heure deprecation_at et obsolescence_at, vous pouvez exécuter à nouveau ces commandes. Les dates et heures précédentes sont remplacées par les nouvelles dates et heures.

Suppression d'un changement de statut de cycle de vie précédemment planifié à l'aide de l'API

Effectuez une demande PATCH /images pour supprimer tout changement de statut planifié en mettant à jour deprecation_at ou obsolescence_at sur null. Cette modification de propriété supprime la date et l'heure de l'image et l'image n'est plus planifiée pour ce changement de statut.

  • Pour changer une image de deprecated en available, remplacez la propriété deprecation_at par 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 }'
    
  • Pour faire passer une image de obsolete à son état précédent, remplacez obsolescence_at par null. Si l'image contenait précédemment une valeur autre que null for deprecation_at, cette modification de propriété supprime l'état obsolete et repasse à deprecated. Si l'état précédent était available, ce qui signifie que l'image a été déplacée de available directement à obsolete, cette modification de propriété passe de obsolete à 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 }'
    
  • Pour modifier une image dont les propriétés deprecation_at ou obsolescence_at sont à nouveau définies sur available, vous devez mettre à jour les propriétés deprecation_at ou 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 }'
    

Considérations relative aux performances

Plusieurs facteurs peuvent influencer la rapidité avec laquelle votre image issue d'un volume est mise en file d'attente et créée, tels que la taille de l'image et le nombre de tâches en attente. Si une image prend trop de temps, vous pouvez annuler le travail.

Performances lors de la création de l'image

Lorsque vous créez l’image, le paramètre status_reasons de l’API indique image_request_queued, accompagné du message La demande d’image est acceptée et attend que des ressources système soient disponibles. Lorsque vous voyez ce message, le démarrage du travail peut prendre un certain temps. Le tableau ci-après fournit des instructions basées sur la taille de l'image. Vérifiez l'état in_progress pour voir si l'image est en cours de création. Là encore, selon la taille de l'image, il peut s'écouler un certain temps avant que l'image ne soit disponible.

Temps d'attente estimé pour la création d'une image
Taille de l'image Délai estimé avant la mise à disposition de l'image
5 Go 5 minutes
10 Go 10 minutes
25 Go 25 min
50 Go 50 min
75 Go 1h45
100 Go 1h40

Le délai de démarrage du travail est d'environ 30 secondes. Ce délai ne reflète pas le trafic dans la file d'attente, qui peut augmenter l'estimation. La plupart des travaux commencent dans les 5 à 10 minutes. Si cela prend plus de temps, annulez la création d'image.

Annulation d'une image en file d'attente de création

Vous pouvez annuler la création de l'image en supprimant l'image si le travail sous-jacent n'a pas encore commencé. Pour les images en attente, l'appel de l'API GET /images renvoie le code anomalie image_request_queued. Vous pouvez supprimer l'image en attente à l'aide d'une demande DELETE /image{image_id}. Vous pouvez également utiliser l'interface utilisateur ou l'interface de ligne de commande pour supprimer l'image qui est à l'état en attente.

Suppression d'une image personnalisée à l'aide de l'interface utilisateur

Vous pouvez supprimer de la liste des images personnalisées une image qui a été créée à partir d'un volume. Vous pouvez supprimer des images qui sont à l'état en attente (pendant leur création) et à l'état disponible.

  1. Accédez à la liste des images personnalisées. Dans la console IBM Cloud, accédez à l'icône du menu de navigation > icône VPC Infrastructure VPC > Calcul > Images.
  2. Dans l'onglet Images personnalisées, localisez l'image à supprimer. Dans le menu Actions icône Actions, sélectionnez Supprimer.

Suppression d'une image d'un volume à l'aide de l'interface de ligne de commande

  1. Recherchez l'image du volume dans la liste des images.

    ibmcloud is images
    
  2. Supprimez l'image par ID.

    ibmcloud is image-delete IMAGE_ID
    

Suppression d'une image d'un volume à l'aide de l'API

Effectuez une demande DELETE /images et indiquez l'ID de l'image créée à partir d'un volume d'amorçage.

  1. Recherchez l'ID de l'image du volume :

    curl -X GET "$vpc_api_endpoint/v1/images?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token"
    
  2. Supprimez l'image par ID :

    curl -X DELETE "$vpc_api_endpoint/v1/images/$image_id?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token"
    

Etapes suivantes

Découvrez le processus complet de création d'une image à partir d'un volume; vous pourrez ensuite utiliser cette image lors de la création d'une nouvelle instance de serveur virtuel. Pour plus d'informations, voir le tutoriel Image à partir d'un volume.