Avant de commencer

1. Assurez-vous d'avoir téléchargé, installé et initialisé les plug-in de l'interface de ligne de commande suivants :

   • CLI IBM Cloud
   • Le plug-in infrastructure-service

   Pour plus d'informations, voir la référence de l'interface de ligne de commande.

2. Assurez-vous que vous avez créé un IBM Cloud VPC.

Créer une image à partir d'un volume de démarrage attaché à une instance

1. Pour localiser l'instance à partir de laquelle vous souhaitez créer une image, répertoriez les instances dans la région. Notez l'ID d'instance dans la sortie de la commande.

   ibmcloud is instances
   

2. Arrêtez l'instance en cours d'exécution avant de créer l'image à partir du volume.

   ibmcloud is instance-stop INSTANCE_ID
   

3. Exécutez la commande image-create pour créer une image d'un volume d'amorçage. Spécifiez l'ID du volume source.

   ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID]
   

   Voir l'exemple suivant :

   $ ibmcloud is image-create test-ifv-vol1 --source-volume ecc68c2f-96a1-4862-bc86-14f47e5d9ed8
   
   Creating image test-ifv-vol1 in resource group  under account Test Account as user test.user@ibm.com...
   ID                 5b2fd4ee-c636-44c4-9673-453fca36832e
   Name               test-ifv-vol1
   CRN                crn:v1:bluemix:public:is:us-south:a/a123456::image:5b2fd4ee-c636-44c4-9673-453fca36832e
   Status             pending
   Status reason      Code                   Message                                                More info
                      image_request_queued   The image request is accepted and waiting for system   -
                                             resources to become available.
   Operating system   Name             Architecture   Vendor   Version                 Dedicated host only
                      centos-8-amd64   amd64          CentOS   8.x - Minimal Install   false
   Source volume      ID                                     Name
                      ecc68c2f-96a1-4862-bc86-14f47e5d9ed8   aa-1-bx-boot-1617035447000
   Created            2021-05-20T09:43:16+08:00
   Visibility         private
   File size(GB)      -
   Encryption         none
   Resource group     f22cf48f-8836-4527-9131-1d7c73ba85e9
   

Planification des changements de statut du cycle de vie des images personnalisées à l'aide de l'interface CLI

Lorsque vous importez une image personnalisée à l'aide de l'interface de ligne de commande (CLI), vous pouvez également planifier les changements de statut de cycle de vie de l'image personnalisée IBM Cloud VPC en même temps à l'aide des options de la commande ibmcloud is image-create.

Indiquez le nom de l'image personnalisée à créer à l'aide de la variable IMAGE_NAME et de la source à l'aide de l'option --source-volume pour indiquer que la source est un volume d'amorçage existant.

Pour planifier les propriétés 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 correspond aux heures à deux chiffres.
• mm est le nombre de 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 2024, la date et l'heure planifiées doivent être postérieures à 8h00 le 12 juin 2024. Si vous définissez à la fois les dates et heures deprecate-at et obsolete-at, la date deprecate-at doit être postérieure à la date et à l'heure obsolete-at.

ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

Avant de commencer

Avant de commencer, vérifiez que vous avez configuré votre environnement d'API.

Création d'une image à partir d'un amorçage d'une instance à l'aide de l'API

1. Localisez l'instance et le volume d'amorçage à partir de laquelle vous souhaitez créer une image. Obtenez la liste des instances disponibles avec la méthode list instance.

   curl -X GET "$vpc_api_endpoint/v1/instances?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

2. Notez l'ID d'instance et utilisez-le pour extraire les détails de l'instance.

   curl -X GET "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

   La réponse contient le nom, l'ID et d'autres détails du volume d'amorçage dans la section volume_attachments.

   "volume_attachments": [
    {
     "device": {
       "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
       },
     "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
     "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
     "name": "my-boot-volume-attachment",
     "volume": {
       "crn": "crn:[...]",
       "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "name": "my-boot-volume"
       }
     }
   ]
   

3. Si l'instance est en cours d'exécution, arrêtez-la en spécifiant l'action stop dans un appel POST /instances :

   curl -X POST \
   "$vpc_api_endpoint/v1/instances/{instance-id}/gen/actions?ersion=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"\
   -d '{"type":"stop"}'
   

4. A l'aide de l'ID de volume d'amorçage, créez une image. Voir l'exemple suivant :

    curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
    -H "Authorization: Bearer $iam_token"
    -d '{
         "name": "my-image",
         "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
         }`
   

   Dans l'exemple de réponse, source_volume indique le volume de démarrage utilisé pour créer l'image. Remarquez également que le chiffrement de l'image apparaît sous la forme none car le volume source utilisait le chiffrement par défaut IBM-managed encryption. Si vous avez utilisé votre propre clé racine, la réponse indique user-managed à la place.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "my-boot-volume"
      }
    }
   

Création d'une image à partir d'un volume et spécification de votre propre clé de chiffrement

1. Comme décrit dans la section précédente, recherchez l'instance et les informations sur le volume d'amorçage. Arrêtez l'instance.

2. Obtenez votre ID d'instance de service de gestion de clés et votre CRN de clé racine.

   • Key Protect-Extraction de l'ID d'instance et du nom de ressource de cloud(CRN).
   • Hyper Protect Crypto Services-Extraction de votre ID d'instance.

3. Effectuez une demande d'API pour créer une image. Indiquez l'ID volume du CRN de la clé racine, comme illustré dans l'exemple suivant.

   curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"
       -d '{
            "name": "my-encrypted-image",
            "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
            "encryption_key":{"crn":"crn:[...key:...]"
           },
   

   La réponse comprend des informations sur la clé racine.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption_key": {
      "crn": "crn:[...key:...]"
      },
    "encryption": "user_managed",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "ifv-boot-vol"
      }
    }
   

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

Lorsque vous créez une image à partir d'un volume à l'aide de l'interface de programme d'application (API), vous pouvez planifier les changements de statut de cycle de vie de l'image personnalisée en même temps.

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é source.volume pour indiquer la source de l'image à partir du volume.

Pour planifier 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 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 2024, la date et l'heure planifiées doivent être postérieures à 8h00 le 12 juin 2024. 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.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
      "name": "test-ifv-boot-volume",
      "source_volume": {
    	  "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"
      },
      "deprecation_at": "2023-03-01T06:11:28+05:30",
      "obsolescence_at": "2023-12-31T06:11:28+05:30"
    }'