Importazione di una immagine personalizzata utilizzando l'interfaccia utente

Quando disponi di un'immagine in IBM Cloud Object Storage, puoi importarla nell'infrastruttura IBM Cloud VPC utilizzando la console IBM Cloud.

1. Assicurati che la tua immagine personalizzata compatibile sia disponibile in IBM Cloud Object Storage. Per caricare un'immagine in IBM Cloud Object Storage, nella pagina Objects del tuo bucket, fai clic su Upload. Puoi utilizzare il plug-in di trasferimento ad alta velocità Aspera per caricare immagini più grandi di 200 MB: Per ulteriori informazioni, vedi Creazione di un'immagine personalizzata Linux, Creazione di un'immagine personalizzata Windows, Bring your own license e Caricamento dei dati in IBM Cloud Object Storage.
2. Nella consoleIBM Cloud, vai a Menu icon > VPC Infrastructure> Compute> Images.
3. Nella scheda Immagini personalizzate, fare clic su Crea.
4. Completare i campi descritti nella Tabella 1 e fare clic su Crea immagine personalizzata.

Importazione di una immagine personalizzata utilizzando la CLI

Assicurati che la tua immagine personalizzata compatibile sia disponibile in IBM Cloud Object Storage. Per ulteriori informazioni, vedere Creazione di un'immagine personalizzata di Linux, Creazione di un'immagine personalizzata di Windows, Creazione di un'immagine personalizzata di un sistema operativo generico, Portare la propria licenza e Caricamento dei dati su IBM Cloud Object Storage. Per includere le espressioni di uso consentito, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Quando un'immagine è disponibile in IBM Cloud Object Storage, è possibile importarla nell'infrastruttura IBM Cloud VPC utilizzando l'interfaccia a riga di comando (CLI).

Per importare un'immagine personalizzata utilizzando la CLI, utilizza il comando ibmcloud is image-create. Specificare il nome dell'immagine personalizzata utilizzando la variabile IMAGE_NAME. Il nome non può essere utilizzato da un'altra immagine nella regione e i nomi che iniziano con ibm- sono riservati per immagini fornite dal sistema. È necessario specificare l'origine; ad esempio, specificare l'opzione --file con il percorso del file immagine. Specificare l'opzione --os-name con il nome del sistema operativo per l'immagine.

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

Il seguente esempio crea un'immagine personalizzata con il nome my-ubuntu-16-amd64. L'ubicazione dell'origine immagine è cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2. Il sistema operativo è 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

Per ulteriori informazioni, vedi ibmcloud is image - create nella pagina di riferimento della 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

Importazione di un'immagine personalizzata utilizzando l'API

Assicurati che la tua immagine personalizzata compatibile sia disponibile in IBM Cloud Object Storage. Per ulteriori informazioni, vedere Creazione di un'immagine personalizzata di Linux, Creazione di un'immagine personalizzata di Windows, Creazione di un'immagine personalizzata di un sistema operativo generico, Portare la propria licenza e Caricamento dei dati su IBM Cloud Object Storage. Per includere un'espressione di uso consentito, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Quando hai un'immagine disponibile in IBM Cloud Object Storage, puoi importarla nell'infrastruttura IBM Cloud VPC utilizzando l'API (application programming interface).

Per importare un'immagine personalizzata utilizzando l'API, utilizza Crea un'immagine.

Il name non può essere utilizzato da un'altra immagine nella regione e i nomi che iniziano con ibm- sono riservati per immagini fornite dal sistema. Specificare la proprietà secondaria file.href con l'ubicazione dell'immagine. Specificare la proprietà secondaria operating_system.name con il nome del sistema operativo immagine.

Le immagini personalizzate generiche del sistema operativo sono una funzione beta e sono disponibili a scopo di valutazione e test. I sistemi operativi generici hanno family di Generic. Assicurarsi di selezionare quello con valore allow_user_image_creation di true e il user_data_format necessario per il corretto avvio e inizializzazione del sistema operativo. Per ulteriori informazioni, consultare Considerazioni sul formato dei dati utente.

Il seguente esempio importa un'immagine personalizzata con il nome my-image, l'ubicazione di origine di cos://us-south/my-bucket/my-image.qcow2 e il sistema operativo per l'immagine è 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"
    }'

Importare un'immagine personalizzata utilizzando Terraform

Per utilizzare Terraform, scaricare la CLI Terraform e configurare il plug-in Provider IBM Cloud. Per ulteriori informazioni, si veda Iniziare con Terraform.

Assicurati che la tua immagine personalizzata compatibile sia disponibile in IBM Cloud Object Storage. Per ulteriori informazioni, vedere Creazione di un'immagine personalizzata di Linux, Creazione di un'immagine personalizzata di Windows, Creazione di un'immagine personalizzata di un sistema operativo generico, Portare la propria licenza e Caricamento dei dati su IBM Cloud Object Storage. Per includere le espressioni di uso consentito, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

IBM Cloud VPC Se disponi di un'immagine su IBM Cloud Object Storage, puoi importarla nell'infrastruttur utilizzando Terraform.

Per importare un'immagine personalizzata utilizzando Terraform, utilizzare il comando ibm_is_image della risorsa Terraform.

Specificare il nome dell'immagine personalizzata da creare utilizzando il valore name. Il nome non può essere utilizzato da un'altra immagine nella regione e i nomi che iniziano con ibm- sono riservati per immagini fornite dal sistema. È necessario specificare anche l'origine; ad esempio, specificare il valore href con il percorso del file immagine. Specificare il valore operating_system con il nome del sistema operativo per l'immagine.

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

Pianificare le modifiche dello stato del ciclo di vita dell'immagine personalizzata utilizzando Terraform

Quando importi un'immagine personalizzata utilizzando Terraform, puoi anche pianificare le modifiche dello stato del ciclo di vita di un'immagine personalizzata IBM Cloud VPC contemporaneamente utilizzando il comando della risorsa Terraform ibm_is_image.

L'attributo name non può essere utilizzato da un'altra immagine nella regione e i nomi che iniziano con ibm- sono riservati per immagini fornite dal sistema.

Per pianificare gli attributi deprecation_at o obsolescence_at, specificare una data nel formato data e ora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY è l'anno a quattro cifre
• MM è il mese a due cifre
• DD è il giorno di due cifre
• T separa le informazioni di data e ora
• hh è l'ora a due cifre
• mm è il numero di minuti a due cifre
• +hh:mm o -hh:mm è il fuso orario UTC (Coordinated Universal Time)

Pertanto, la data del 30 settembre 2023 alle 20:00 nel fuso orario del Nord America Central Standard (CST) sarà 2023-09-30T20:00:00-06:00

Quando si pianifica la data e l'ora, non è possibile utilizzare la data e ora correnti. Ad esempio, se sono le 8:00 del 12 giugno, la data e l'ora pianificate devono essere successive alle 8:00 del 12 giugno. Se si definiscono le date e le ore deprecation_at e obsolescence_at, la data obsolescence_at deve essere successiva alla data e all'ora deprecation_at.

Il seguente esempio importa un'immagine personalizzata con il nome example-image, l'ubicazione di origine di cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd e il sistema operativo per l'immagine è ubuntu-16-04-amd64. L'immagine è pianificata per essere obsoleta su 2023-11-28T15:10:00.000Z. L'immagine è pianificata per essere obsoleta su 2023-11-28T15:10:00.000Z.

• Pianificare una modifica di stato in 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"
  }
  

• Pianificare una modifica di stato in 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"
  }
  

Convalida di una immagine personalizzata importata utilizzando l'interfaccia utente

Dopo aver importato un'immagine personalizzata, puoi visualizzare il checksum generato per l'immagine quando viene importata in IBM Cloud VPC.

Se si genera un checksum localmente per l'immagine prima di importarla, è possibile confrontare i due checksum per assicurarsi che siano identici. I checksum corrispondenti indicano che l'immagine non è alterata.

1. Nella consoleIBM Cloud, vai a Menu icon > VPC Infrastructure> Compute> Images.
2. Dalla scheda Immagini personalizzate, dall'elenco di immagini personalizzate, fai clic sul nome dell'immagine personalizzata che vuoi convalidare.
3. Nel pannello laterale dei dettagli dell'immagine, individua il campo Checksum (SHA256). Il contenuto è simile a 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

Solo per immagini personalizzate z/OS Wazi aaS: non è possibile convalidare il checksum delle immagini personalizzate importate distribuite da Wazi Image Builder.

4. Confronta il valore Checksum (SHA256) con l'output generato quando calcoli localmente un checksum per l'immagine.

   • Esempio di comando Linux: sha256sum ubuntu_image.qcow2
   • Comando Mac di esempio: shasum -a 256 ubuntu_image.qcow2
   • Si riceve un output simile a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. Crea un'istanza del server virtuale o un server bare metal utilizzando questa immagine. Per ulteriori informazioni, vedi Crea un'istanza del server virtuale o Creazione di Bare Metal Servers su VPC.

Convalida di una immagine personalizzata importata utilizzando la CLI

Dopo aver importato un'immagine personalizzata, puoi visualizzare il checksum generato per l'immagine quando viene importata in IBM Cloud VPC.

Se si genera un checksum localmente per l'immagine prima di importarla, è possibile confrontare i due checksum per assicurarsi che siano identici. I checksum corrispondenti indicano che l'immagine non è alterata.

Per convalidare un'immagine personalizzata importata utilizzando la CLI, utilizza il comando ibmcloud is image.

Per prima cosa, visualizza i dettagli dell'immagine personalizzata importata che vuoi convalidare. Specificare il nome o l'ID dell'immagine personalizzata da creare utilizzando la variabile IMAGE.

ibmcloud is image IMAGE

Per ulteriori informazioni, vedi ibmcloud is image nella pagina di riferimento della CLI VPC.

Nel seguente esempio vengono visualizzati i dettagli di un'immagine personalizzata con 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

Confronta il valore Checksum restituito (SHA256) con l'output generato quando calcoli localmente un checksum per l'immagine.

• Esempio di comando Linux: sha256sum ubuntu_image.qcow2
• Comando Mac di esempio: shasum -a 256 ubuntu_image.qcow2
• Si riceve un output simile a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Dopo aver convalidato il checksum (SHA256), utilizza l'immagine per creare un server virtuale. Vedi Creazione di un'istanza del server virtuale utilizzando la CLI.

Convalida di una immagine personalizzata importata utilizzando la API

Dopo aver importato un'immagine personalizzata, puoi visualizzare il checksum generato per l'immagine quando viene importata in IBM Cloud VPC.

Se si genera un checksum localmente per l'immagine prima di importarla, è possibile confrontare i due checksum per assicurarsi che siano identici. I checksum corrispondenti indicano che l'immagine non è alterata.

Per convalidare come immagine personalizzata utilizzando l'API, utilizza List all images.

Per il $image_id, specifica l'ID dell'immagine personalizzata che vuoi convalidare.

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

Confronta il valore Checksum restituito (SHA256) con l'output generato quando calcoli localmente un checksum per l'immagine.

• Esempio di comando Linux: sha256sum ubuntu_image.qcow2
• Comando Mac di esempio: shasum -a 256 ubuntu_image.qcow2
• Si riceve un output simile a: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Dopo aver convalidato il checksum (SHA256), utilizza l'immagine per creare un server virtuale. Vedi Creazione di un'istanza del server virtuale utilizzando l'API.