Gestion des images personnalisées
Après avoir importé une image personnalisée sur IBM Cloud VPC, vous pouvez afficher les détails de l'image, gérer le cycle de vie de l'image, utiliser l'image pour créer une instance de serveur virtuel, exporter l'image et même la partager avec un catalogue privé.
- Pour gérer une image à partir d'un volume, voir Gestion de l'image à partir d'un volume.
- Pour utiliser une image personnalisée dans un catalogue privé, voir Intégration d'une image de serveur virtuel pour VPC.
- Pour utiliser des expressions d'utilisation autorisée avec vos images personnalisées afin de définir les capacités et les restrictions d'une image et de vous aider à trouver des combinaisons d'images et de profils compatibles lors de la création du serveur, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.
IBM Cloud® Identity and Access Management (IAM) vous permet d'authentifier en toute sécurité les utilisateurs pour les services de la plateforme et de contrôler l'accès aux ressources de manière cohérente sur l'ensemble d' IBM Cloud. Pour plus d'informations sur les exigences d'accès pour les images personnalisées, voir les informations sur les rôles et les actions IAM dans Image Service for VPC.
Pour plus d'informations sur les variables $iam_token et $vpc_api_endpoint dans les exemples suivants, consultez les sections Authentification et URL des points de terminaison dans l'introduction à l'API Virtual Private Cloud.
Gestion des images personnalisées à l'aide de l'interface utilisateur
Vous pouvez gérer une image à l'aide de la console IBM Cloud.
- Dans la console d' IBM Cloud, accédez à
du menu de navigation >
> Compute > Images.
- Dans l'onglet Images personnalisées, cliquez sur l'icône Actions
pour une image spécifique et sélectionnez l'une des options disponibles. Les images personnalisées chiffrées sont identifiées par une icône de verrou après le nom de l'image. Vous pouvez sélectionner l'une des actions suivantes :
| Action | Description |
|---|---|
| Renommer | Renommez l'image personnalisée. |
| Créer une instance de serveur virtuel | Créez un serveur virtuel à partir de l'image personnalisée. |
| Exporter | Copiez l'image personnalisée dans IBM Cloud Object Storage. |
| Partager dans le catalogue | Partagez l'image personnalisée IBM Cloud VPC dans un catalogue privé existant. |
| Copier | Copiez l'identificateur unique universel de l'image personnalisée. |
| Afficher le total de contrôle | Affichez le total de contrôle de l'image personnalisée. |
| Planifier le cycle de vie | Ouvre le panneau Planifier le cycle de vie de l'image. Vous pouvez effectuer un changement de statut immédiat ou planifier un changement de statue pour une date et une heure futures. Vous pouvez planifier un seul changement
de statut ou planifier le cycle de vie complet des images. Les statuts d'image sont les suivants:
Vous pouvez passer d'un statut à l'autre parmi ces trois-là. Seuls les statuts que vous pouvez changer sont affichés. Vous pouvez planifier des changements de statut en utilisant la date et l'heure du calendrier ou le nombre de jours. Les dates d'obsolescence doivent toujours être postérieures à la date d'obsolescence. |
| Supprimer | Supprimez l'image personnalisée.
Si vous souhaitez supprimer une image personnalisée dans un catalogue privé, voir Suppression d'une image personnalisée dans un catalogue privé. |
Liste des images personnalisées à l'aide de l'interface de ligne de commande
Vous pouvez répertorier toutes les images personnalisées IBM Cloud VPC dans votre région à l'aide de l'interface de ligne de commande (CLI).
Pour répertorier toutes les images personnalisées à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is images. Les images personnalisées étant privées pour le compte dans lequel elles sont
créées, l'option --visibility est private.
ibmcloud is images --visibility private
Pour plus d'informations, consultez la section ibmcloud is images de la page de référence de la CLI VPC.
Répertorier toutes les images à l'aide de l'API
Vous pouvez répertorier toutes les images IBM Cloud VPC de votre région à l'aide de l'interface de programme d'application (API).
Pour répertorier toutes les images à l'aide de l'API, utilisez Répertorier toutes les images. Les images personnalisées sont privées pour le compte dans lequel elles sont créées. Vous pouvez donc
définir la propriété visibility sur private pour extraire uniquement les images personnalisées.
curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Affichage de la liste de toutes les images à l'aide de Terraform
Vous pouvez répertorier toutes les images IBM Cloud VPC de votre région à l'aide de Terraform.
Pour répertorier toutes les images à l'aide de Terraform, utilisez la commande de source de données Terraform ibm_is_images.
Les images personnalisées sont privées du compte dans lequel elles sont créées. Vous pouvez donc définir l'attribut visibility sur private pour extraire uniquement les images personnalisées.
data "ibm_is_images" "images" {
visibility = "public"
}
Affichage des détails d'une image personnalisée à l'aide de l'interface utilisateur
Vous pouvez afficher les détails suivants d'une image personnalisée:
- Expressions d'utilisation autorisée
- Groupe de ressources affecté
- Somme de contrôle
- Date de création
- CRN
- Date d'obsolescence (si définie)
- Type de chiffrement
- Emplacement
- Nom et ID
- Date d'obsolescence (si définie)
- Système d'exploitation et version
- Taille
- Type source
Vous pouvez éditer le nom de l'image personnalisée, ajouter des balises pour la recherche et afficher et copier le nom de ressource de cloud (CRN) unique. La valeur de la somme de contrôle SHA256 pour l'image est accessible.
Pour afficher les détails d'une image personnalisée, procédez comme suit :
- Dans la console d' IBM Cloud, accédez à
du menu de navigation >
> Compute > Images.
- Dans l'onglet Images personnalisées, cliquez sur le nom d'une image personnalisée puis, dans le panneau suivant, cliquez sur
View image details. - Sur la page Détails de l'image, vous pouvez modifier le nom de l'image, copier la somme de contrôle, ajouter des balises, copier le CRN de l'image et modifier les expressions d'utilisation autorisée de l'image.
- Depuis le menu Actions de la page Détails de l'image, vous pouvez effectuer des opérations telles que la création d'une instance de serveur virtuel à partir de l'image personnalisée ou la suppression de l'image. Pour obtenir la liste complète des actions possibles, voir Gestion des images personnalisées à l'aide de l'interface utilisateur.
Affichage des détails de l'image personnalisée à l'aide de l'interface de ligne de commande
Vous pouvez afficher les détails d'une image personnalisée, tels que le nom et l'ID, le système d'exploitation et la version, le statut de chiffrement, les dates d'obsolescence ou d'obsolescence et le groupe de ressources affecté, à l'aide de l'interface de ligne de commande (CLI).
Pour afficher les détails d'une image personnalisée à l'aide de l'interface de ligne de commande (CLI), utilisez la commande ibmcloud is image. Indiquez le nom ou l'ID de l'image personnalisée avec la variable IMAGE.
ibmcloud is image IMAGE
Pour plus d'informations, consultez la section ibmcloud is image de la page de référence de la CLI VPC.
Extraction des détails de l'image personnalisée à l'aide de l'API
Vous pouvez afficher les détails d'une image personnalisée, tels que le nom et l'ID, le système d'exploitation et la version, le statut de chiffrement, les dates d'obsolescence ou d'obsolescence et le groupe de ressources affecté, à l'aide de l'interface de programme d'application (API).
Pour extraire les détails d'une image personnalisée spécifique à l'aide de l'API, utilisez Extraire une image. Pour la variable $image_id, indiquez l'ID de l'image personnalisée que
vous souhaitez extraire.
curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Extraction des détails de l'image personnalisée à l'aide de Terraform
Vous pouvez afficher les détails d'une image personnalisée, tels que le nom et l'ID, le système d'exploitation et la version, le statut de chiffrement, les dates d'obsolescence ou d'obsolescence et le groupe de ressources affecté, à l'aide de Terraform.
Pour afficher les détails d'une image à l'aide de Terraform, utilisez la commande de source de données Terraform ibm_is_images.
Pour la variable name, indiquez le nom de l'image personnalisée que vous souhaitez extraire.
data "ibm_is_images" "image_name" {
}
Exportation d'une image personnalisée vers IBM Cloud Object Storage
Vous pouvez exporter une image personnalisée dans IBM Cloud Object Storage. Plus tard, vous souhaiterez peut-être copier l'image dans une nouvelle région en l'important à nouveau. Ou bien, vous pouvez extraire l'image en dehors du VPC pour l'utiliser à un autre endroit, par exemple sur site. Des frais peuvent être facturés pour le stockage d'images dans IBM Cloud Object Storage. Pour plus d'informations, voir Facturation.
Prérequis
Pour exporter une image personnalisée, vous devez respecter les prérequis suivants:
- Vous avez besoin d'un rôle IAM qui inclut les actions
is.image.image.exportetis.image.image.operate. Pour plus d'informations, voir Gestion de l'accès IAM pour VPC Infrastructure Services. - Vous devez créer une instance de service IBM Cloud Object Storage. Vous devez également créer une autorisation pour que le service Image Service for VPC puisse accéder à IBM Cloud Object Storage avec le rôle d'accès au service Writer. Pour plus d'informations, voir Octroi de l'accès à IBM Cloud Object Storage pour importer et exporter des images.
- Vous avez besoin d'un accès IAM pour écrire dans le compartiment où vous prévoyez d'exporter une image. Pour plus d'informations, voir Affectation de l'accès à un compartiment individuel.
Si l'image en cours d'exportation est supprimée alors qu'un travail d'exportation est en cours, le statut de l'image est défini sur deleting. Le travail d'exportation est autorisé à se terminer avant la fin de la suppression de
l'image. Lorsque la suppression de l'image est terminée, son historique des travaux d'exportation n'est pas disponible. Vous pouvez utiliser les événements de suivi d'activité pour
le travail d'exportation afin de déterminer son statut final.
Exportation d'une image personnalisée à l'aide de l'interface utilisateur
Pour exporter une image personnalisée vers IBM Cloud Object Storage, procédez comme suit.
- Dans la console d' IBM Cloud, accédez à
du menu de navigation >
> Compute > Images.
- Dans l'onglet Images personnalisées, cliquez sur le nom de l'image personnalisée à exporter.
- Sur la page des détails de l'image, cliquez sur le menu Actions et sélectionnez Exporter.
- Dans le panneau d'exportation d'image personnalisée, vous pouvez éventuellement spécifier un nom pour le travail d'exportation. Le nom est utilisé, avec le nom de l'image, pour construire le nom de l'objet exporté dans IBM Cloud Object Storage. Si vous ne spécifiez pas de nom, un nom est automatiquement généré.
- Sélectionnez le format de fichier pour l'exportation. Les formats de fichier valides sont QCOW2 et VHD. Si l'image personnalisée est une image chiffrée, le format QCOW2 est requis.
- Spécifiez l'instance de service IBM Cloud Object Storage et le compartiment dans lesquels vous souhaitez exporter l'image personnalisée. Vous pouvez également spécifier le CRN pour le compartiment IBM Cloud Object Storage dans lequel vous souhaitez exporter l'image.
- Cliquez sur Exporter une image personnalisée.
Exportation d'une image personnalisée à l'aide de l'interface de ligne de commande
Vous pouvez exporter une image personnalisée IBM Cloud VPC vers IBM Cloud Object Storage à l'aide de l'interface de ligne de commande.
Pour exporter une image personnalisée à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is image-export-job-create. Indiquez le nom ou l'ID de l'image personnalisée à exporter à l'aide de la variable
IMAGE. Vous pouvez spécifier un nom pour le travail d'exportation avec NEW_NAME. Vous pouvez également spécifier le format de fichier pour l'exportation de l'image, qcow2 ou vhd. Le format
qcow2 est le format de fichier par défaut et est le format requis si l'image personnalisée est chiffrée. En outre, spécifiez le IBM Cloud Object Storage BUCKET dans lequel vous souhaitez exporter l'image personnalisée.
ibmcloud is image-export-job-create IMAGE [--name NEW_NAME] [--format qcow2 | vhd] --bucket BUCKET
L'exemple suivant exporte une image personnalisée avec l'ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479. Le travail d'exportation est nommé my-export-job. Le format de fichier pour l'exportation de l'image est qcow2.
Compartiment IBM Cloud Object Storage dans lequel l'image exportée est nommée my-bucket.
ibmcloud is image-export-job-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-export-job --format qcow2 --bucket my-bucket
Pour plus d'informations, voir ibmcloud is image-export-job-create sur la page de référence de l'interface de ligne de commande VPC.
Exportation d'une image personnalisée avec l'API
Vous pouvez exporter une image personnalisée IBM Cloud VPC vers IBM Cloud Object Storage à l'aide de l'interface de programme d'application (API).
Pour exporter une image personnalisée à l'aide de l'API, utilisez Créer un travail d'exportation d'image.
Pour la variable $image_id, indiquez l'ID de l'image personnalisée que vous souhaitez exporter. Vous pouvez éventuellement spécifier un name significatif pour le travail d'exportation d'image. Dans cet exemple, le
nom du travail d'exportation est my-image-export. Pour la sous-propriété storage_bucket name, indiquez le nom du compartiment IBM Cloud Object Storage dans lequel vous souhaitez exporter l'image personnalisée.
Dans cet exemple, le nom de compartiment est bucket-27200-lwx4cfvcue. Vous pouvez également utiliser la sous-propriété crn pour spécifier le CRN du compartiment.
curl -X POST \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-image-export",
"storage_bucket": {
"name": "bucket-27200-lwx4cfvcue"
}
}'
Affichage et gestion de l'historique d'exportation des images personnalisées
Vous pouvez afficher l'historique d'exportation d'image personnalisée pour afficher des détails tels que le nom du travail d'exportation, le statut, le compartiment cible dans IBM Cloud Object Storage, le nom d'objet IBM Cloud Object Storage affecté, la date de début du travail d'exportation et, si le travail d'exportation est terminé, la date d'achèvement.
Vous pouvez également supprimer un travail d'exportation d'image terminé. Vous pouvez également supprimer (et annuler) un travail d'exportation d'image en cours si vous disposez d'un rôle IAM qui inclut l'action is.image.image.export.
Lorsque vous supprimez un travail d'exportation d'image, il est supprimé uniquement de l'historique d'exportation. Le fichier image exporté n'est pas supprimé du panier IBM Cloud Object Storage. Vous devez gérer les fichiers stockés sur IBM Cloud Object Storage en utilisant les interfaces IBM Cloud Object Storage.
Enfin, vous pouvez renommer un travail d'exportation d'image. Le changement de nom du travail d'exportation d'image ne modifie pas le nom de l'objet créé dans IBM Cloud Object Storage.
Limites pour les travaux d'exportation d'image
Les limites suivantes s'appliquent aux travaux d'exportation d'image:
- Cinq demandes de travail d'exportation actives par image
- Dix travaux d'exportation par image
- Vingt travaux d'exportation actifs par compte et par région
Affichage de l'historique d'exportation d'image personnalisée à l'aide de l'interface utilisateur
Pour afficher l'historique d'exportation d'une image personnalisée, procédez comme suit.
- Dans la console d' IBM Cloud, accédez à
du menu de navigation >
> Compute > Images.
- Dans l'onglet Images personnalisées, cliquez sur le nom d'une image personnalisée pour afficher les détails relatifs à cette image.
- Sur la page Détails de l'image, cliquez sur l'onglet Exporter l'historique.
Suppression ou annulation d'un travail d'exportation d'image à l'aide de l'interface utilisateur
Pour supprimer un travail d'exportation d'image terminé ou annuler (et supprimer) un travail d'exportation d'image en cours, procédez comme suit.
- Sur la page des détails de l'image, cliquez sur l'onglet Exporter l'historique.
- Pour le travail d'exportation que vous souhaitez supprimer ou annuler, cliquez sur l'icône Actions
et sélectionnez Supprimer.
Attribution d'un nouveau nom à un travail d'exportation d'image à l'aide de l'interface utilisateur
Pour renommer un travail d'exportation d'image, procédez comme suit.
- Sur la page des détails de l'image, cliquez sur l'onglet Exporter l'historique.
- Pour le travail d'exportation que vous souhaitez renommer, cliquez sur l'icône Actions
et sélectionnez Renommer.
Affichage de l'historique d'exportation d'image personnalisée à l'aide de l'interface de ligne de commande
Pour afficher l'historique d'exportation d'une image personnalisée spécifique à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is image-export-jobs. Indiquez le nom ou l'ID de l'image personnalisée
qui a été exportée à l'aide de la variable IMAGE.
ibmcloud is image-export-jobs IMAGE
L'exemple suivant présente l'historique des travaux d'exportation pour une image personnalisée avec l'ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479.
ibmcloud is image-export-jobs 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
Pour plus d'informations, consultez la section ibmcloud is image-export-jobs de la page de référence de la CLI VPC.
Affichage des détails du travail d'exportation d'image à l'aide de l'interface de ligne de commande
Pour afficher les détails d'un travail d'exportation d'image spécifique à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is image-export-job. Indiquez le nom ou l'ID de l'image personnalisée
qui a été exportée à l'aide de la variable IMAGE. Indiquez le nom ou l'ID du travail d'exportation d'image à l'aide de la variable JOB.
ibmcloud is image-export-job IMAGE JOB
Pour plus d'informations, voir ibmcloud is image-export-job dans la page de référence de l'interface de ligne de commande VPC.
Suppression ou annulation d'un travail d'exportation d'image à l'aide de l'interface de ligne de commande
Pour supprimer un travail d'exportation d'image terminé ou annuler (et supprimer) un travail d'exportation d'image en cours, utilisez la commande ibmcloud is image-export-job-delete. Indiquez le nom ou l'ID de
l'image personnalisée qui a été exportée à l'aide de la variable IMAGE. Indiquez le nom ou l'ID du travail d'exportation d'image à l'aide de la variable JOB.
ibmcloud is image-export-job-delete IMAGE JOB
Pour plus d'informations, voir ibmcloud is image-export-job-delete sur la page de référence de l'interface de ligne de commande VPC.
Changement du nom d'un travail d'exportation d'image à l'aide de l'interface de ligne de commande
Pour renommer un travail d'exportation d'image personnalisé à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is image-export-job-update. Indiquez le nom ou l'ID de l'image personnalisée
qui a été exportée à l'aide de la variable IMAGE. Indiquez le nom ou l'ID du travail d'exportation d'image à l'aide de la variable JOB. Indiquez le nouveau nom que vous souhaitez affecter au travail d'exportation
d'image à l'aide de la variable NAME.
ibmcloud is image-export-job-update IMAGE JOB --name NAME
Pour plus d'informations, consultez la section ibmcloud is image-export-job-update de la page de référence de la CLI VPC.
Affichage de l'historique d'exportation d'image personnalisée à l'aide de l'API
Pour afficher l'historique d'exportation d'une image personnalisée spécifique à l'aide de l'API, utilisez Répertorier tous les travaux d'exportation d'image.
Pour la variable $image_id, indiquez l'ID de l'image personnalisée pour laquelle vous souhaitez afficher les travaux d'exportation.
curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Affichage des détails d'un travail d'exportation d'image à l'aide de l'API
Pour afficher les détails d'un travail d'exportation d'image spécifique à l'aide de l'API, utilisez Extraire un travail d'exportation d'image.
Pour la variable $image_id, indiquez l'ID de l'image personnalisée qui a été exportée. Pour la variable $export_job_id, indiquez l'ID du travail d'exportation d'image dont vous souhaitez extraire les détails.
curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Suppression ou annulation d'un travail d'exportation d'image à l'aide de l'API
Pour supprimer un travail d'exportation d'image terminé ou annuler (et supprimer) un travail d'exportation d'image en cours à l'aide de l'API, utilisez Supprimer un travail d'exportation d'image.
Pour la variable $image_id, indiquez l'ID de l'image personnalisée pour laquelle vous souhaitez supprimer un travail d'exportation. Pour la variable $export_job_id, indiquez l'ID du travail d'exportation d'image à
supprimer.
curl -X DELETE \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Attribution d'un nouveau nom à un travail d'exportation d'image à l'aide de l'API
Pour renommer un travail d'exportation d'image personnalisé à l'aide de l'API, utilisez Mettre à jour un travail d'exportation d'image.
Pour la variable $image_id, indiquez l'ID de l'image personnalisée pour laquelle vous souhaitez renommer un travail d'exportation. Pour la variable $export_job_id, indiquez l'ID du travail d'exportation d'image à
renommer. Le nouveau nom à attribuer au travail d'exportation d'image dans l'exemple suivant est my-export-job-patched.
curl -X PATCH \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-export-job-patched"
}'
Partage d'une image personnalisée dans un catalogue privé à l'aide de l'interface utilisateur
Vous pouvez partager une image personnalisée IBM Cloud VPC existante dans un catalogue privé existant. Si vous ne disposez pas encore d'un catalogue privé, voir Intégration d'une image de serveur virtuel pour VPC.
L'action Partager l'image dans un catalogue privé n'est pas disponible pour les images suivantes:
- L'image est déjà partagée dans un catalogue privé. Une image dans un catalogue privé ne peut exister que dans une seule version d'une offre de produit dans un catalogue privé. Vous devez supprimer l'image de la version dans laquelle elle se trouve avant de pouvoir la partager dans une autre version.
- L'image est chiffrée.
- L'image n'est pas une image x86.
Pour partager une image personnalisée dans un catalogue privé, procédez comme suit.
- Dans la console d' IBM Cloud, accédez à
du menu de navigation >
> Compute > Images.
- Dans l'onglet Images personnalisées, cliquez sur l'icône Actions
et sélectionnez Partager dans le catalogue.
- Sur la page Partager l'image dans un catalogue privé, sélectionnez un catalogue privé dans la liste des catalogues privés disponibles.
- Entrez un numéro de version dans Version du logiciel.
- Cliquez sur Créer une offre de catalogue pour partager l'image dans le catalogue privé.
- Une fois l'image créée, cliquez sur Valider l'image.
Ce processus partage l'image personnalisée uniquement avec le catalogue privé. Le processus de validation se produit dans le catalogue privé. En cliquant sur Valider l'image, vous accédez à une nouvelle page et, à partir de cet écran, vous pouvez commencer par Etape 3: Valider l'image de serveur virtuel dans l'intégration d'une image de serveur virtuel pour VPC pour terminer le processus de validation.
Partage d'une image personnalisée dans un catalogue privé à l'aide de l'interface de ligne de commande
Vous pouvez partager une image personnalisée uniquement dans un catalogue privé à partir de IBM Cloud VPC en utilisant l'interface utilisateur. Pour plus d'informations sur l'intégration d'un catalogue privé à l'aide de l'interface de ligne de commande, consultez la rubrique Intégration de logiciels à votre compte.
Partage d'une image personnalisée dans un catalogue privé à l'aide de l'API
Vous pouvez partager une image personnalisée uniquement dans un catalogue privé à partir de IBM Cloud VPC en utilisant l'interface utilisateur. Pour plus d'informations sur l'intégration d'un catalogue privé à l'aide de l'API, consultez la rubrique Intégration de logiciels à votre compte.
Partage d'une image personnalisée dans un catalogue privé à l'aide de Terraform
Vous pouvez partager une image personnalisée uniquement dans un catalogue privé à partir de IBM Cloud VPC en utilisant l'interface utilisateur. Pour plus d'informations sur l'intégration d'un catalogue privé à l'aide de Terraform, consultez la rubrique Intégration de logiciels à votre compte.
Planifier un changement d'état du cycle de vie d'une image personnalisée dans la console
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. Vous pouvez effectuer un changement de statut immédiat uniquement si vous n'avez pas planifié de changement de statut futur.
Pour planifier un changement de statut unique, procédez comme suit:
Vous pouvez planifier un seul changement de statut pour une image.
- Dans la console IBM Cloud, allez dans le menu de navigation-
menu > icône Infrastructure
> Compute > Images.
- Dans l'onglet Images personnalisées, cliquez sur l'icône Actions
pour une image spécifique et sélectionnez l'une des options disponibles.
- Sélectionnez Planifier le cycle de vie.
- Dans Statut de l'image, sélectionnez le changement de statut de l'image.
- Dans Détails de l'obsolescence, indiquez si vous souhaitez modifier le statut Immédiatement ou Planifier une date future.
- 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é.
- Sélectionnez Par date calendaire ou Par nombre de jours.
- Cliquez sur Sauvegarder.
Procédez comme suit pour planifier le cycle de vie complet de l'image:
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.
-
Dans la console IBM Cloud, allez dans le menu de navigation-
menu > icône Infrastructure
> Compute > Images.
-
Dans l'onglet Images personnalisées, cliquez sur l'icône Actions
pour une image spécifique et sélectionnez l'une des options disponibles.
-
Sélectionnez Planifier le cycle de vie.
-
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.
-
Cliquez sur Planifier.
Modification du statut du cycle de vie de l'image personnalisée à l'aide de l'interface de ligne de commande
Vous pouvez modifier le statut du cycle de vie d'une image personnalisée IBM Cloud VPC à l'aide de l'interface de ligne de commande. 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).
YYYYest l'année à quatre chiffresMMest le mois à deux chiffresDDest le jour à deux chiffresTsépare les informations de date et d'heurehhest le nombre d'heures à deux chiffresmmest le nombre de minutes à deux chiffres+hh:mmou-hh:mmest 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.
Retrait d'un changement de statut de cycle de vie d'image personnalisé 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 du cycle de vie de l'image personnalisée à l'aide de l'API
Vous pouvez modifier le statut du cycle de vie d'une image personnalisée IBM Cloud VPC à 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).
YYYYest l'année à quatre chiffresMMest le mois à deux chiffresDDest le jour à deux chiffresTsépare les informations de date et d'heurehhest le nombre d'heures à deux chiffresmmest le nombre de minutes à deux chiffres+hh:mmou-hh:mmest 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_atetobsolescence_at, vous pouvez exécuter à nouveau ces commandes. Les dates et heures précédentes sont remplacées par les nouvelles dates et heures.
Supprimer le statut de cycle de vie d'image personnalisé 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
deprecatedenavailable, remplacez la propriétédeprecation_atparnull.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, remplacezobsolescence_atparnull. Si l'image contenait précédemment une valeur autre quenullfordeprecation_at, cette modification de propriété supprime l'étatobsoleteet repasse àdeprecated. Si l'état précédent étaitavailable, ce qui signifie que l'image a été déplacée deavailabledirectement àobsolete, cette modification de propriété passe deobsoleteà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_atouobsolescence_atsont à nouveau définies suravailable, vous devez mettre à jour les propriétésdeprecation_atouobsolescence_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 }'
Modifier le statut du cycle de vie d'une image personnalisée à l'aide de Terraform
Pour modifier immédiatement le statut à l'aide de Terraform, utilisez la commande ibm_is_image_deprecate ou ibm_is_image_obsolete commandes de ressources. Utilisez l'un des exemples suivants.
Pour la variable name, indiquez le nom 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 Suppression d'un changement de statut de cycle de vie d'image personnalisé planifié à l'aide de Terraform. 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.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 } -
Remplacez le statut du cycle de vie de l'image par
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 }
Pour planifier un changement de statut, utilisez l'un des exemples suivants.
Pour l'attribut deprecation_at ou obsolescence_at, indiquez une date au format de date et d'heure ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).
YYYYcorrespond à l'année à quatre chiffresMMcorrespond au mois à deux chiffresDDcorrespond au jour à deux chiffresTsépare les informations de date et d'heurehhest le nombre d'heures à deux chiffresmmcorrespond aux minutes à deux chiffres+hh:mmou-hh:mmest le fuseau horaire Temps universel coordonné
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
Lorsque vous programmez la date et l'heure, vous ne pouvez pas utiliser votre date et heure actuelles. 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.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" } -
Planifiez un changement de statut sur
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 vous souhaitez modifier les entrées de date et d'heure
deprecation_atetobsolescence_at, vous pouvez exécuter à nouveau ces commandes. Les dates et heures précédentes sont remplacées par les nouvelles dates et heures.
Supprimer le statut de cycle de vie d'une image personnalisée précédemment planifié à l'aide de Terraform
Pour supprimer tout changement de statut planifié, mettez à jour les attributs deprecation_at ou obsolescence_at sur null. Ce changement d'attribut 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
deprecatedenavailable, remplacez la propriétédeprecation_atparnull.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 } -
Pour faire passer une image de
obsoleteà son état précédent, remplacezobsolescence_atparnull. Si l'image contenait précédemment une valeur autre quenullfordeprecation_at, ce changement d'attribut supprime l'étatobsoleteet le remplace pardeprecated. Si l'état précédent étaitavailable, ce qui signifie que l'image a été déplacée deavailabledirectement àobsolete, cette modification d'attribut passe deobsoleteà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 } -
Pour modifier une image dont les propriétés
deprecation_atouobsolescence_atsont à nouveau définies suravailable, vous devez mettre à jour les attributsdeprecation_atouobsolescence_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 }