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

Lorsque vous disposez d'une image disponible dans IBM Cloud Object Storage, vous pouvez l'importer dans l'infrastructure IBM Cloud VPC à l'aide de la console IBM Cloud.

1. Assurez-vous que votre image personnalisée compatible est disponible dans IBM Cloud Object Storage. Pour télécharger une image sur IBM Cloud Object Storage, sur la page Objets de votre compartiment, cliquez sur Télécharger. Vous pouvez utiliser le plug-in de transfert à haut débit Aspera pour télécharger des images de plus de 200 Mo. Pour plus d'informations, voir Création d'une image personnalisée Linux, Création d'une image personnalisée Windows, Mode BYOL et Téléchargement de données dans IBM Cloud Object Storage.
2. Dans la consoleIBM Cloud, accédez à l'icône Menu > Infrastructure VPC > Calcul > Images.
3. Dans l'onglet Images personnalisées, cliquez sur Créer.
4. Remplissez les champs décrits dans le tableau 1, puis cliquez sur Créer une image personnalisée.

Importation d'une image personnalisée à l'aide de l'interface de ligne de commande

Assurez-vous que votre image personnalisée compatible est disponible dans IBM Cloud Object Storage. Pour plus d'informations, voir Création d'une image personnalisée Linux, Création d'une image personnalisée Windows, Création d'une image personnalisée d'un système d'exploitation générique, Apportez votre propre licence et Téléchargement de données sur IBM Cloud Object Storage. Pour inclure des expressions d'utilisation autorisée, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Lorsqu'une image est disponible sur IBM Cloud Object Storage, vous pouvez l'importer dans l'infrastructure IBM Cloud VPC en utilisant l'interface de ligne de commande (CLI).

Pour importer une image personnalisée à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is image-create. Spécifiez le nom de l'image personnalisée en utilisant la variable IMAGE_NAME. Le nom ne peut pas être utilisé par une autre image dans la région et les noms commençant par ibm- sont réservés aux images fournies par le système. Vous devez spécifier la source; par exemple, spécifiez l'option --file avec l'emplacement du fichier image. Spécifiez l'option --os-name avec le nom du système d'exploitation de l'image.

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

L'exemple suivant crée une image personnalisée avec le nom my-ubuntu-16-amd64. L'emplacement source de l'image est cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2. Le système d'exploitation est 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

Pour plus d'informations, consultez la section ibmcloud is image-create de la page de référence de la CLI 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

Importation d'une image personnalisée à l'aide de l'API

Assurez-vous que votre image personnalisée compatible est disponible dans IBM Cloud Object Storage. Pour plus d'informations, voir Création d'une image personnalisée Linux, Création d'une image personnalisée Windows, Création d'une image personnalisée d'un système d'exploitation générique, Apportez votre propre licence et Téléchargement de données sur IBM Cloud Object Storage. Pour inclure une expression d'utilisation autorisée, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Lorsque vous disposez d'une image disponible dans IBM Cloud Object Storage, vous pouvez l'importer dans l'infrastructure IBM Cloud VPC à l'aide de l'interface de programme d'application (API).

Pour importer une image personnalisée à l'aide de l'API, utilisez Créer une image.

name ne peut pas être utilisé par une autre image dans la région et les noms commençant par ibm- sont réservés aux images fournies par le système. Spécifiez la sous-propriété file.href avec l'emplacement de l'image. Indiquez la sous-propriété operating_system.name avec le nom du système d'exploitation de l'image.

Les images personnalisées du système d'exploitation générique sont une fonction bêta et sont disponibles à des fins d'évaluation et de test. Les systèmes d'exploitation génériques disposent de la valeur family de Generic. Veillez à sélectionner celui avec la valeur allow_user_image_creation true et le paramètre user_data_format requis pour que votre système d'exploitation s'initialise et s'initialise correctement. Pour plus d'informations, voir Remarques relatives au format des données utilisateur.

L'exemple suivant importe une image personnalisée avec le nom my-image, l'emplacement source de cos://us-south/my-bucket/my-image.qcow2 et le système d'exploitation de l'image est 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"
    }'

Importer une image personnalisée en utilisant Terraform

Pour utiliser Terraform, téléchargez l'interface CLI Terraform et configurez le plug-in Fournisseur d' IBM Cloud. Pour plus d'informations, voir Démarrer avec Terraform.

Assurez-vous que votre image personnalisée compatible est disponible dans IBM Cloud Object Storage. Pour plus d'informations, voir Création d'une image personnalisée Linux, Création d'une image personnalisée Windows, Création d'une image personnalisée d'un système d'exploitation générique, Apportez votre propre licence et Téléchargement de données sur IBM Cloud Object Storage. Pour inclure des expressions d'utilisation autorisée, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Lorsque vous disposez d'une image dans l' IBM Cloud Object Storage, vous pouvez l'importer dans l'infrastructure d' IBM Cloud VPC à l'aide de Terraform.

Pour importer une image personnalisée à l'aide de Terraform, utilisez la commande de ressource Terraform ibm_is_image.

Spécifiez le nom de l'image personnalisée à créer en utilisant la valeur name. Le nom ne peut pas être utilisé par une autre image dans la région et les noms commençant par ibm- sont réservés aux images fournies par le système. Vous devez également spécifier la source; par exemple, spécifiez la valeur href avec l'emplacement du fichier image. Spécifiez la valeur operating_system avec le nom du système d'exploitation pour l'image.

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

Planification des changements de statut de cycle de vie d'image personnalisée à l'aide de Terraform

Lorsque vous importez une image personnalisée à l'aide de Terraform, vous pouvez également planifier les changements de statut du cycle de vie d'une image personnalisée IBM Cloud VPC en même temps à l'aide de la commande de ressource Terraform ibm_is_image.

L'attribut name ne peut pas être utilisé par une autre image dans la région et les noms commençant par ibm- sont réservés aux images fournies par le système.

Pour planifier les attributs 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 correspond à l'année à quatre chiffres
• MM correspond au mois à deux chiffres
• DD correspond au jour à deux chiffres
• T sépare les informations de date et d'heure
• hh est le nombre d'heures à deux chiffres
• mm correspond aux minutes à deux chiffres
• +hh:mm ou -hh:mm est le fuseau horaire du temps universel coordonné

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

Lorsque vous planifiez la date et 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.

L'exemple suivant importe une image personnalisée avec le nom example-image, l'emplacement source de cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd et le système d'exploitation de l'image est ubuntu-16-04-amd64. L'image est planifiée pour être obsolète dans 2023-11-28T15:10:00.000Z. L'image est planifiée pour être obsolète sur 2023-11-28T15:10:00.000Z.

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

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

Une fois que vous avez importé une image personnalisée, vous pouvez consulter la somme de contrôle générée pour cette image lors de son importation vers IBM Cloud VPC.

Si vous générez localement une somme de contrôle pour votre image avant de l'importer, vous pouvez comparer les deux sommes de contrôle pour vous assurer qu'elles sont identiques. Des sommes de contrôle identiques indiquent que l'image n'a pas été modifiée.

1. Dans la consoleIBM Cloud, accédez à l'icône Menu > Infrastructure VPC > Calcul > Images.
2. Dans l'onglet Images personnalisées, dans la liste de vos images personnalisées, cliquez sur le nom de l'image personnalisée que vous souhaitez valider.
3. Dans le panneau latéral des détails de l’image, repérez le champ Checksum ( SHA256 ). Vous pouvez consulter des contenus similaires, par exemple : 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

Pour z/OS Wazi aaS image personnalisée uniquement : vous ne pouvez pas valider la somme de contrôle des images personnalisées importées qui sont déployées à partir de Wazi Image Builder.

4. Comparez la valeur de la somme de contrôle (SHA256) à la sortie qui est générée lorsque vous calculez une somme de contrôle pour l'image localement.

   • Exemple de commande Linux : sha256sum ubuntu_image.qcow2
   • Exemple de commande Mac : shasum -a 256 ubuntu_image.qcow2
   • Vous obtenez un résultat similaire à : 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. Créez une instance de serveur virtuel ou un serveur bare metal à l'aide de cette image. Pour plus d'informations, voir Création d'une instance de serveur virtuel ou Création de serveurs Bare Metal Servers sur VPC.

Validation d'une image personnalisée importée à l'aide de l'interface de ligne de commande

Une fois que vous avez importé une image personnalisée, vous pouvez consulter la somme de contrôle générée pour cette image lors de son importation vers IBM Cloud VPC.

Si vous générez localement une somme de contrôle pour votre image avant de l'importer, vous pouvez comparer les deux sommes de contrôle pour vous assurer qu'elles sont identiques. Des sommes de contrôle identiques indiquent que l'image n'a pas été modifiée.

Pour valider une image personnalisée importée à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is image.

Tout d'abord, affichez les détails de l'image personnalisée importée que vous souhaitez valider. Indiquez le nom ou l'ID de l'image personnalisée à créer à l'aide de 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.

L'exemple suivant affiche les détails d'une image personnalisée avec l'ID 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

Comparez la valeur de la somme de contrôle ( SHA256 ) renvoyée avec le résultat généré lorsque vous calculez localement la somme de contrôle de l'image.

• Exemple de commande Linux : sha256sum ubuntu_image.qcow2
• Exemple de commande Mac : shasum -a 256 ubuntu_image.qcow2
• Vous obtenez un résultat similaire à : 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Après avoir validé le total de contrôle (SHA256), utilisez l'image pour créer un serveur virtuel. Voir Création d'une instance de serveur virtuel à l'aide de l'interface de ligne de commande.

Validation d'une image personnalisée importée à l'aide de l'API

Une fois que vous avez importé une image personnalisée, vous pouvez consulter la somme de contrôle générée pour cette image lors de son importation vers IBM Cloud VPC.

Si vous générez localement une somme de contrôle pour votre image avant de l'importer, vous pouvez comparer les deux sommes de contrôle pour vous assurer qu'elles sont identiques. Des sommes de contrôle identiques indiquent que l'image n'a pas été modifiée.

Pour valider en tant qu'image personnalisée à l'aide de l'API, utilisez Répertorier toutes les images.

Pour $image_id, indiquez l'ID de l'image personnalisée que vous souhaitez valider.

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

Comparez la valeur de la somme de contrôle ( SHA256 ) renvoyée avec le résultat généré lorsque vous calculez localement la somme de contrôle de l'image.

• Exemple de commande Linux : sha256sum ubuntu_image.qcow2
• Exemple de commande Mac : shasum -a 256 ubuntu_image.qcow2
• Vous obtenez un résultat similaire à : 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Après avoir validé le total de contrôle (SHA256), utilisez l'image pour créer un serveur virtuel. Voir Création d'une instance de serveur virtuel à l'aide de l'API.