Gestione delle immagini personalizzate

Dopo aver importato un'immagine personalizzata in IBM Cloud VPC, è possibile visualizzare i dettagli dell'immagine, gestire il ciclo di vita dell'immagine, utilizzare l'immagine per creare un'istanza di server virtuale, esportare l'immagine e persino condividerla con un catalogo privato.

IBM Cloud® Identity and Access Management (IAM) consente di autenticare in modo sicuro gli utenti per i servizi della piattaforma e di controllare l'accesso alle risorse in modo coerente su tutta l'. IBM Cloud Per ulteriori informazioni sui requisiti di accesso per le immagini personalizzate, vedi le informazioni sui ruoli IAM e sulle azioni in Image Service for VPC.

Per i dettagli sulle variabili $vpc_api_endpoint e $iam_token nei seguenti esempi, consulta le sezioni Autenticazione e URL endpoint in Virtual Private Cloud API Introduction.

Gestione delle immagini personalizzate utilizzando la IU

Puoi gestire un'immagine utilizzando la console IBM Cloud.

  1. In IBM Cloud console, vai su Menu di navigazione iconicona del menu > Infrastrutture Icona VPC > Calcolo > Immagini.
  2. Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni icona Ulteriori azioni per un'immagine specifica e selezionare una delle opzioni disponibili. Le immagini personalizzate crittografate vengono identificate da un'icona a forma di lucchetto dopo il nome immagine. È possibile scegliere tra le seguenti azioni:
Azioni personalizzate per le immagini
Azione Descrizione
Rinomina Ridenominare l'immagine personalizzata.
Crea istanza del server virtuale Crea un nuovo server virtuale dall'immagine personalizzata.
Esporta Copia l'immagine personalizzata in IBM Cloud Object Storage.
Condividi nel catalogo Condividi l'immagine personalizzata IBM Cloud VPC con un catalogo privato esistente.
Copia Copiare l'UUID dell'immagine personalizzata.
Visualizza checksum Visualizzare il checksum per l'immagine personalizzata.
Pianifica ciclo di vita Apre il pannello Pianifica ciclo di vita dell'immagine. È possibile effettuare una modifica di stato immediata o pianificare una modifica della statua per una data e ora futura. È possibile pianificare una singola modifica di stato o pianificare il ciclo di vita completo delle immagini. Gli stati dell'immagine sono:

  • available: l'immagine può essere utilizzata per creare un'istanza.

  • deprecated: l'immagine è ancora disponibile per il provisioning e l'istanza. L'utilizzo dello stato " deprecated " può scoraggiare l'uso dell'immagine prima che lo stato cambi in " obsolete".

  • obsolete: l'immagine non è disponibile per l'uso per fornire un'istanza.

  • Pianificazione dell'intero ciclo di vita: è possibile pianificare contemporaneamente sia il passaggio allo stato " deprecated " che quello allo stato " obsolete ".

È possibile passare da uno stato all'altro tra i tre. Vengono visualizzati solo gli stati che è possibile modificare. È possibile pianificare le modifiche di stato utilizzando la data e l'ora del calendario o il numero di giorni. Le date di obsolescenza devono essere sempre successive alla data di obsolescenza.

Elimina Eliminare l'immagine personalizzata.

Se vuoi eliminare un'immagine personalizzata in un catalogo privato, vedi Eliminazione di un'immagine personalizzata in un catalogo privato.

Elenco delle immagini personalizzate utilizzando la CLI

Puoi elencare tutte le immagini personalizzate IBM Cloud VPC nella tua regione utilizzando la CLI (command - line interface).

Per elencare tutte le immagini personalizzate utilizzando la CLI, utilizza il comando ibmcloud is images. Le immagini personalizzate sono private per l'account in cui vengono create, quindi l'opzione --visibility è private.

ibmcloud is images --visibility private

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

Elenco di tutte le immagini utilizzando l'API

Puoi elencare tutte le immagini IBM Cloud VPC nella tua regione utilizzando l'API (application programming interface).

Per elencare tutte le immagini utilizzando l'API, utilizza Elenca tutte le immagini. Le immagini personalizzate sono private per l'account in cui vengono create, quindi puoi impostare la proprietà visibility su private per richiamare solo immagini personalizzate.

curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Elencare tutte le immagini utilizzando Terraform

Puoi elencare tutte le immagini IBM Cloud VPC nella tua regione utilizzando Terraform.

Per visualizzare tutte le immagini utilizzando Terraform, utilizza il comando dell'origine dati Terraform ibm_is_images. Le immagini personalizzate sono private per l'account in cui vengono create, quindi puoi impostare l'attributo visibility su private per richiamare solo le immagini personalizzate.

data "ibm_is_images" "images" {
  visibility = "public"
}

Visualizzazione dei dettagli dell'immagine personalizzata utilizzando l'IU

È possibile visualizzare i seguenti dettagli di un'immagine personalizzata:

  • Espressioni di uso consentito
  • Gruppo di risorse assegnato
  • Checksum
  • Data di creazione
  • CRN
  • Data di obsolescenza (se impostata)
  • Tipo di crittografia
  • Posizione
  • Nome e ID
  • Data di obsolescenza (se impostata)
  • Sistema operativo e versione
  • Dimensione
  • Tipo di origine

È possibile modificare il nome dell'immagine personalizzata, aggiungere tag per la ricerca e visualizzare e copiare il CRN (Cloud Resource Name) univoco. Il valore di checksum SHA256 dell'immagine è accessibile.

Per visualizzare i dettagli di un'immagine personalizzata, segui questi passaggi.

  1. In IBM Cloud console, vai su Menu di navigazione iconicona del menu > Infrastrutture Icona VPC > Calcolo > Immagini.
  2. Nella scheda Immagini personalizzate, fare clic sul nome di un'immagine personalizzata e, nel pannello successivo, fare clic su View image details.
  3. Nella pagina Dettagli immagine è possibile modificare il nome dell'immagine, copiare la checksum, aggiungere tag, copiare il CRN dell'immagine e modificare le espressioni di utilizzo consentito dell'immagine.
  4. Dal menu Azioni della pagina dei dettagli dell'immagine, è possibile eseguire azioni quali la creazione di un'istanza di server virtuale dall'immagine personalizzata o l'eliminazione dell'immagine. Per un elenco completo delle azioni possibili, consulta Gestione delle immagini personalizzate utilizzando l'IU.

Visualizzazione dei dettagli dell'immagine personalizzata utilizzando la CLI

È possibile visualizzare i dettagli di un'immagine personalizzata, come il nome e l'ID, il sistema operativo e la versione, lo stato di crittografia, le date di obsolescenza o di obsolescenza e il gruppo di risorse assegnato, utilizzando la CLI (command - line interface).

Per visualizzare i dettagli di un'immagine personalizzata utilizzando la CLI, utilizza il comando ibmcloud is image. Specificare il nome o ID dell'immagine personalizzata con la variabile IMAGE.

ibmcloud is image IMAGE

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

Richiamo dei dettagli dell'immagine personalizzata utilizzando l'API

È possibile visualizzare i dettagli di un'immagine personalizzata, come il nome e l'ID, il sistema operativo e la versione, lo stato di crittografia, le date di obsolescenza o di obsolescenza e il gruppo di risorse assegnato, utilizzando l'API (application programming interface).

Per richiamare i dettagli di una specifica immagine personalizzata utilizzando l'API, utilizza Richiama un'immagine. Per la variabile $image_id, specifica l'ID dell'immagine personalizzata che vuoi richiamare.

curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Richiamo dei dettagli dell'immagine personalizzata utilizzando Terraform

Puoi visualizzare i dettagli di un'immagine personalizzata, come il nome e l'ID, il sistema operativo e la versione, lo stato della crittografia, le date di obsolescenza o di obsolescenza e il gruppo di risorse assegnato, utilizzando Terraform.

Per visualizzare i dettagli di una immagine utilizzando Terraform, utilizza il comando dell'origine dati Terraform ibm_is_images. Per la variabile name, specifica il nome dell'immagine personalizzata che vuoi richiamare.

data "ibm_is_images" "image_name" {
}

Esportazione di un'immagine personalizzata in IBM Cloud Object Storage

Puoi esportare un'immagine personalizzata in IBM Cloud Object Storage. Successivamente, potresti voler copiare l'immagine in una nuova regione importandola di nuovo. Oppure, potresti voler estrarre l'immagine al di fuori del VPC per utilizzarla in un luogo diverso, ad esempio in sede. Potrebbero essere applicati addebiti per l'archiviazione delle immagini in IBM Cloud Object Storage. Per ulteriori informazioni, vedi Fatturazione.

Prerequisiti

Per esportare un'immagine personalizzata, è necessario soddisfare i seguenti prerequisiti:

Se l'immagine che si sta esportando viene eliminata mentre un lavoro di esportazione è in corso, lo stato dell'immagine è impostato su deleting. Il lavoro di esportazione può essere completato prima del completamento dell'eliminazione dell'immagine. Quando l'eliminazione dell'immagine è completa, la relativa cronologia del lavoro di esportazione non è disponibile. È possibile utilizzare gli eventi di monitoraggio delle attività per il lavoro di esportazione per determinarne lo stato finale.

Esportazione di un'immagine personalizzata utilizzando la IU

Per esportare un'immagine personalizzata in IBM Cloud Object Storage, completa la seguente procedura.

  1. In IBM Cloud console, vai su Menu di navigazione iconicona del menu > Infrastrutture Icona VPC > Calcolo > Immagini.
  2. Sulla scheda Immagini personalizzate, fai clic sul nome dell'immagine personalizzata che vuoi esportare.
  3. Nella pagina dei dettagli dell'immagine, fare clic sul menu Azioni e selezionare Esporta.
  4. Nel pannello Esporta immagine personalizzata, è possibile specificare facoltativamente un nome per il lavoro di esportazione. Il nome viene utilizzato, insieme al nome dell'immagine, per creare il nome dell'oggetto esportato in IBM Cloud Object Storage. Se non si specifica un nome, viene generato automaticamente un nome.
  5. Selezionare il formato file per l'esportazione. I formati file validi sono QCOW2 e VHD. Se l'immagine personalizzata è un'immagine codificata, è richiesto il formato QCOW2.
  6. Specifica il bucket e l'istanza del servizio IBM Cloud Object Storage in cui vuoi esportare l'immagine personalizzata. In alternativa puoi specificare il CRN per il bucket IBM Cloud Object Storage in cui vuoi esportare l'immagine.
  7. Fai clic su " Esporta immagine personalizzata ".

Esportazione di un'immagine personalizzata utilizzando la CLI

Puoi esportare un'immagine personalizzata IBM Cloud VPC in IBM Cloud Object Storage utilizzando la CLI (command - line interface).

Per esportare un'immagine personalizzata utilizzando la CLI, utilizza il comando ibmcloud is image - export - job - create. Specificare il nome o l'ID dell'immagine personalizzata da esportare utilizzando la variabile IMAGE. È possibile specificare un nome per il lavoro di esportazione con NEW_NAME. È anche possibile specificare il formato file per l'esportazione dell'immagine, qcow2 o vhd. Il formato qcow2 è il formato file predefinito ed è il formato richiesto se l'immagine personalizzata è crittografata. Inoltre, specifica IBM Cloud Object Storage BUCKET dove vuoi esportare l'immagine personalizzata.

ibmcloud is image-export-job-create IMAGE [--name NEW_NAME] [--format qcow2 | vhd] --bucket BUCKET

Il seguente esempio esporta un'immagine personalizzata con ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479. Il lavoro di esportazione è denominato my-export-job. Il formato file per l'esportazione dell'immagine è qcow2. Il bucket IBM Cloud Object Storage in cui l'immagine esportata è denominata my-bucket.

ibmcloud is image-export-job-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-export-job --format qcow2 --bucket my-bucket

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

Esportazione di un'immagine personalizzata con l'API

Puoi esportare un'immagine personalizzata IBM Cloud VPC in IBM Cloud Object Storage utilizzando l'API (application programming interface).

Per esportare un'immagine personalizzata utilizzando l'API, utilizza Crea un lavoro di esportazione dell'immagine.

Per la variabile $image_id, specifica l'ID dell'immagine personalizzata che vuoi esportare. Facoltativamente, è possibile specificare un name significativo per il lavoro di esportazione immagine. In questo esempio, il nome del lavoro di esportazione è my-image-export. Per la proprietà secondaria storage_bucket name, specifica il nome del bucket IBM Cloud Object Storage in cui vuoi esportare l'immagine personalizzata. In questo esempio, il nome bucket è bucket-27200-lwx4cfvcue. In alternativa, puoi utilizzare la proprietà secondaria crn per specificare il CRN del bucket.

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"
  }
}'

Visualizzazione e gestione della cronologia di esportazione delle immagini personalizzate

Puoi visualizzare la cronologia di esportazione dell'immagine personalizzata per visualizzare i dettagli quali il nome lavoro di esportazione, lo stato, il bucket di destinazione in IBM Cloud Object Storage, il nome oggetto IBM Cloud Object Storage assegnato, la data in cui è stato avviato il lavoro di esportazione e, se il lavoro di esportazione è completo, la data di completamento.

È anche possibile eliminare un lavoro di esportazione immagine completato. In alternativa, puoi eliminare (e annullare) un lavoro di esportazione dell'immagine in corso se hai un ruolo IAM che include l'azione is.image.image.export.

Quando si elimina un lavoro di esportazione immagini, viene rimosso solo dalla cronologia di esportazione. Il file immagine esportato non viene rimosso dal bucket IBM Cloud Object Storage. È necessario gestire i file memorizzati in IBM Cloud Object Storage utilizzando le interfacce di IBM Cloud Object Storage.

Infine, è possibile rinominare un lavoro di esportazione immagine. La ridenominazione del lavoro di esportazione dell'immagine non modifica il nome dell'oggetto creato in IBM Cloud Object Storage.

Limiti per i lavori di esportazione immagini

Esistono i seguenti limiti per i lavori di esportazione immagini:

  • Cinque richieste di lavoro di esportazione attive per immagine
  • Dieci lavori di esportazione totali per immagine
  • Venti lavori di esportazione attivi per account per regione

Visualizzazione della cronologia di esportazione dell'immagine personalizzata utilizzando l'interfaccia utente

Per visualizzare la cronologia di esportazione di una immagine personalizzata, completare la seguente procedura.

  1. In IBM Cloud console, vai su Menu di navigazione iconicona del menu > Infrastrutture Icona VPC > Calcolo > Immagini.
  2. Nella scheda Immagini personalizzate, fare clic sul nome di una immagine personalizzata per visualizzare i dettagli su tale immagine.
  3. Nella pagina Dettagli immagine, fare clic sulla scheda Esporta cronologia.

Eliminazione o annullamento di un lavoro di esportazione immagine utilizzando l'interfaccia utente

Per eliminare un lavoro di esportazione immagine completato o annullare (ed eliminare) un lavoro di esportazione immagine in corso, completare la seguente procedura.

  1. Nella pagina dei dettagli dell'immagine, fai clic sulla scheda Esporta cronologia.
  2. Per il lavoro di esportazione che si desidera eliminare o annullare, fare clic sull'icona Azioni icona Altre azioni e selezionare Elimina.

Ridenominazione di un lavoro di esportazione immagine utilizzando l'UI

Per ridenominare un lavoro di esportazione immagine, completare la seguente procedura.

  1. Nella pagina dei dettagli dell'immagine, fai clic sulla scheda Esporta cronologia.
  2. Per il lavoro di esportazione che si desidera rinominare, fare clic sull'icona Azioni icona Ulteriori azioni e selezionare Rinomina.

Visualizzazione della cronologia di esportazione delle immagini personalizzate utilizzando la CLI

Per visualizzare la cronologia di esportazione di una specifica immagine personalizzata utilizzando la CLI, utilizza il comando ibmcloud is image - export - jobs. Specificare il nome o ID dell'immagine personalizzata che è stata esportata utilizzando la variabile IMAGE.

ibmcloud is image-export-jobs IMAGE

Il seguente esempio mostra la cronologia del lavoro di esportazione per un'immagine personalizzata con l'ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479.

ibmcloud is image-export-jobs 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479

Per ulteriori informazioni, consulta ibmcloud is image - export - jobs nella pagina di riferimento della CLI VPC.

Visualizzazione dei dettagli del lavoro di esportazione immagine utilizzando la CLI

Per visualizzare i dettagli di uno specifico lavoro di esportazione immagine utilizzando la CLI, utilizza il comando ibmcloud is image-export-job. Specificare il nome o ID dell'immagine personalizzata che è stata esportata utilizzando la variabile IMAGE. Specificare il nome o l'ID del lavoro di esportazione immagine utilizzando la variabile JOB.

ibmcloud is image-export-job IMAGE JOB

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

Eliminazione o annullamento di un lavoro di esportazione immagine utilizzando la CLI

Per eliminare un lavoro di esportazione dell'immagine completato o annullare (ed eliminare) un lavoro di esportazione dell'immagine in corso, utilizzare il comando ibmcloud is image-export-job-delete. Specificare il nome o ID dell'immagine personalizzata che è stata esportata utilizzando la variabile IMAGE. Specificare il nome o l'ID del lavoro di esportazione immagine utilizzando la variabile JOB.

ibmcloud is image-export-job-delete IMAGE JOB

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

Ridenominazione di un lavoro di esportazione immagine utilizzando la CLI

Per ridenominare un lavoro di esportazione di immagini personalizzate utilizzando la CLI, utilizza il comando ibmcloud is image-export-job-update. Specificare il nome o ID dell'immagine personalizzata che è stata esportata utilizzando la variabile IMAGE. Specificare il nome o l'ID del lavoro di esportazione immagine utilizzando la variabile JOB. Specificare il nome che si desidera assegnare al job di esportazione immagine utilizzando la variabile NAME.

ibmcloud is image-export-job-update IMAGE JOB --name NAME

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

Visualizzazione della cronologia di esportazione dell'immagine personalizzata utilizzando la API

Per visualizzare la cronologia di esportazione di una specifica immagine personalizzata utilizzando l'API, utilizza List all image export jobs.

Per la variabile $image_id, specifica l'ID dell'immagine personalizzata per cui vuoi visualizzare i lavori di esportazione.

curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Visualizzazione dei dettagli del lavoro di esportazione immagine utilizzando l'API

Per visualizzare i dettagli di uno specifico lavoro di esportazione immagini utilizzando l'API, utilizza Richiama un lavoro di esportazione immagini.

Per la variabile $image_id, specifica l'ID dell'immagine personalizzata che è stata esportata. Per la variabile $export_job_id, specifica l'ID del lavoro di esportazione immagine per cui vuoi richiamare i dettagli.

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"

Eliminazione o annullamento di un lavoro di esportazione immagine utilizzando l'API

Per eliminare un lavoro di esportazione immagine completato o annullare (ed eliminare) un lavoro di esportazione immagine in corso utilizzando l'API, utilizzare Elimina un lavoro di esportazione immagine.

Per la variabile $image_id, specifica l'ID dell'immagine personalizzata per cui vuoi eliminare un lavoro di esportazione. Per la variabile $export_job_id, specifica l'ID del lavoro di esportazione immagine che vuoi eliminare.

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"

Ridenominazione di un lavoro di esportazione immagine utilizzando l'API

Per ridenominare un lavoro di esportazione immagine personalizzata utilizzando l'API, utilizza Aggiorna un lavoro di esportazione immagine.

Per la variabile $image_id, specifica l'ID dell'immagine personalizzata per cui vuoi ridenominare un job di esportazione. Per la variabile $export_job_id, specifica l'ID del job di esportazione immagine che vuoi ridenominare. Il nuovo nome da assegnare al lavoro di esportazione immagine nel seguente esempio è 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"
    }'

Condivisione di una immagine personalizzata in un catalogo privato utilizzando l'UI

Puoi condividere un'immagine personalizzata IBM Cloud VPC esistente con un catalogo privato esistente. Se non hai già un catalogo privato, vedi Onboarding di un'immagine del server virtuale per VPC.

L'azione Condividi immagine su catalogo privato non è disponibile per le immagini seguenti:

  • L'immagine è già stata condivisa in un catalogo privato. Un'immagine in un catalogo privato può essere presente in una sola versione all'interno di un'offerta di prodotto in un catalogo privato. È necessario rimuovere l'immagine dalla versione in cui si trova prima che tale immagine possa essere condivisa in una versione diversa.
  • L'immagine è crittografata.
  • L'immagine non è un'immagine x86.

Per condividere un'immagine personalizzata in un catalogo privato, completa la seguente procedura.

  1. In IBM Cloud console, vai su Menu di navigazione iconicona del menu > Infrastrutture Icona VPC > Calcolo > Immagini.
  2. Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni icona Altre azioni e selezionare Condividi nel catalogo.
  3. Nella pagina Condividi immagine a catalogo privato, seleziona Catalogo privato dall'elenco di cataloghi privati disponibili.
  4. Immettere un numero di versione in Versione software.
  5. Fai clic su Create catalog offering per condividere l'immagine nel catalogo privato.
  6. Una volta creata l'immagine, fare clic su Convalida immagine.

Questo processo condivide l'immagine personalizzata solo con il catalogo privato. Il processo di convalida si verifica all'interno del catalogo privato. Facendo clic su Convalida immagine si apre una nuova pagina e da questa schermata, è possibile iniziare con Passo 3: convalida dell'immagine del server virtuale in Onboarding di un'immagine del server virtuale per VPC per completare il processo di convalida.

Condivisione di un'immagine personalizzata in un catalogo privato utilizzando la CLI

È possibile condividere un'immagine personalizzata solo in un catalogo privato da IBM Cloud VPC utilizzando l'interfaccia utente. Per ulteriori informazioni sull'integrazione di un catalogo privato tramite CLI, vedere Integrazione del software nel proprio account.

Condivisione di una immagine personalizzata in un catalogo privato utilizzando l'API

È possibile condividere un'immagine personalizzata solo in un catalogo privato da IBM Cloud VPC utilizzando l'interfaccia utente. Per ulteriori informazioni sull'integrazione di un catalogo privato utilizzando l'API, vedere Integrazione del software nel proprio account.

Condivisione di una immagine personalizzata in un catalogo privato utilizzando Terraform

È possibile condividere un'immagine personalizzata solo in un catalogo privato da IBM Cloud VPC utilizzando l'interfaccia utente. Per ulteriori informazioni sull'integrazione di un catalogo privato utilizzando Terraform, vedere Integrazione del software nel proprio account.

Pianificazione di una modifica personalizzata dello stato del ciclo di vita dell'immagine nella console

È possibile pianificare una singola modifica dello stato del ciclo di vita dell'immagine o pianificare le modifiche dello stato per l'intero ciclo di vita dell'immagine. È possibile effettuare una modifica di stato immediata solo se non è stata pianificata una modifica di stato futura.

Per pianificare una singola modifica di stato, attenersi alla seguente procedura:

È possibile pianificare una singola modifica di stato per un'immagine.

  1. Nella console IBM Cloud, vai a Icona del menu di navigazione > Icona VPC infrastruttura > Elaborazione > Immagini.
  2. Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni icona Ulteriori azioni per un'immagine specifica e selezionare una delle opzioni disponibili.
  3. Selezionare Pianifica ciclo di vita.
  4. In Stato immagine, selezionare la modifica dello stato dell'immagine.
  5. In Dettagli obsoleti, selezionare se modificare lo stato Immediatamente o Pianifica data futura.
  6. Se è stata selezionata la voce Pianifica data futura, è necessario compilare i seguenti campi:
    • Selezionare Per data calendario o Per numero di giorni.
      • Se è stato selezionato Per data calendario, immettere le informazioni relative alla data e all'ora. Si tratta della data e dell'ora in cui si verificherà la modifica dello stato.
      • Se è stato selezionato Per numero di giorni, inserire il numero di giorni che passeranno prima che lo stato venga modificato.
  7. Fare clic su Salva.

Attenersi alla seguente procedura per pianificare l'intero ciclo di vita dell'immagine:

È possibile pianificare il ciclo di vita completo per l'immagine. L'immagine è prima obsoleta e quindi diventa obsoleta in base alla pianificazione definita. Utilizzare la seguente procedura per pianificare una modifica del ciclo di vita.

  1. Nella console IBM Cloud, vai a Icona del menu di navigazione > Icona VPC infrastruttura > Elaborazione > Immagini.

  2. Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni icona Ulteriori azioni per un'immagine specifica e selezionare una delle opzioni disponibili.

  3. Selezionare Pianifica ciclo di vita.

  4. Selezionare Pianifica ciclo di vita completo.

    • Se si seleziona Per data calendario, immettere la data e l'ora in cui si desidera che si verifichi la modifica dello stato.
    • Se è stato selezionato Per numero di giorni, inserire il numero di giorni che si desidera trascorrere prima che lo stato venga modificato.

    La data di obsolescenza deve essere successiva alla data di obsolescenza.

  5. Fai clic su Schedule.

Modifica lo stato del ciclo di vita dell'immagine personalizzata utilizzando la CLI

Puoi cambiare lo stato del ciclo di vita di un'immagine personalizzata IBM Cloud VPC utilizzando la CLI (command - line interface). Puoi apportare una modifica di stato immediata utilizzando i comandi ibmcloud is image - deprecate o ibmcloud is image - obsolete. Puoi anche pianificare queste modifiche di stato per una data e ora future utilizzando il comando ibmcloud is image - update. Specificare il nome o ID dell'immagine personalizzata con la variabile IMAGE.

Per effettuare una modifica di stato immediata, utilizzare uno dei seguenti esempi.

È possibile effettuare una modifica di stato immediata solo se una modifica di stato futura non è pianificata. Per rimuovere una modifica di stato pianificata, vedi Rimuovi una modifica di stato del ciclo di vita dell'immagine personalizzata pianificata utilizzando la CLI. Dopo aver rimosso la modifica di stato pianificata, è possibile effettuare una modifica di stato immediata.

  • Modificare lo stato del ciclo di vita dell'immagine in deprecate.

    ibmcloud is image-deprecate IMAGE
    
  • Modificare lo stato del ciclo di vita dell'immagine in obsolete.

    ibmcloud is image-obsolete IMAGE
    

Per pianificare una modifica dello stato, utilizzare il seguente esempio.

Per l'opzione deprecate-at o obsolete-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 a due cifre
  • T separa le informazioni di data e ora
  • hh è l'ora a due cifre
  • mm sono i minuti a due cifre
  • +hh:mm o -hh:mm è il fuso orario UTC

Pertanto, la data del 30 settembre 2023 alle 20:00 nel CST (Central Standard Time Zone) del Nord America 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 è 8:00 AM del 12 giugno, la data e l'ora pianificate devono essere successive alle 8:00 AM del 12 giugno. Se si definiscono entrambe le date deprecate-at e obsolete-at, la data obsolete-at deve essere successiva alla data 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]

Se si desidera modificare le voci di data e ora deprecate-at e obsolete-at, è possibile eseguire nuovamente questi comandi. Le date e le ore precedenti vengono quindi sostituite con le nuove date e ore.

Rimuovi una modifica dello stato del ciclo di vita dell'immagine personalizzata precedentemente pianificata utilizzando la CLI

È possibile rimuovere una modifica di stato pianificata utilizzando le opzioni --reset-deprecate-at o --reset-obsolete-at . Se utilizzi una di queste opzioni con il comando ibmcloud is image - update , la data e l'ora vengono rimosse dall'immagine. L'immagine non è più pianificata per tale modifica dello stato.

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

Se utilizzi entrambe le opzioni --reset-deprecate-at e --reset-obsolete-at , lo stato dell'immagine ritorna a available.

Modifica lo stato del ciclo di vita dell'immagine personalizzata utilizzando l'API

Puoi modificare lo stato del ciclo di vita di un'immagine personalizzata IBM Cloud VPC utilizzando l'API (application programming interface). È possibile effettuare una modifica di stato immediata o pianificare una modifica di stato in un secondo momento.

Per effettuare una modifica di stato immediata, utilizzare uno dei seguenti esempi. Per la variabile $image_id, specifica l'ID dell'immagine personalizzata per la modifica dello stato.

È possibile effettuare una modifica di stato immediata solo se una modifica di stato futura non è pianificata. Per rimuovere una modifica di stato pianificata, vedi Rimuovi una modifica di stato del ciclo di vita dell'immagine personalizzata pianificata utilizzando l'API. Dopo aver rimosso la modifica di stato pianificata, è possibile effettuare una modifica di stato immediata.

  • Modificare lo stato del ciclo di vita dell'immagine in deprecated.

    curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token
  • Modificare lo stato del ciclo di vita dell'immagine in obsolete.

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

Per pianificare una modifica dello stato, utilizzare uno dei seguenti esempi.

Per le proprietà 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 a due cifre
  • T separa le informazioni di data e ora
  • hh è l'ora a due cifre
  • mm sono i minuti a due cifre
  • +hh:mm o -hh:mm è il fuso orario UTC

Pertanto, la data del 30 settembre 2023 alle 20:00 nel CST (Central Standard Time Zone) del Nord America 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 è 8:00 AM del 12 giugno, la data e l'ora pianificate devono essere successive alle 8:00 AM 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.

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

    Se si desidera modificare le voci di data e ora deprecation_at e obsolescence_at, è possibile eseguire nuovamente questi comandi. Le date e le ore precedenti vengono sostituite con le nuove date e ore.

Rimuovere lo stato del ciclo di vita dell'immagine personalizzata precedentemente pianificata utilizzando l'API

Effettuare una richiesta PATCH /images per rimuovere qualsiasi modifica di stato pianificata aggiornando deprecation_at o obsolescence_at a null. Questa modifica della proprietà rimuove la data e l'ora dall'immagine e l'immagine non è più pianificata per tale modifica di stato.

  • Per cambiare un'immagine da deprecated a available, modificare la proprietà deprecation_at in 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 }'
    
  • Per modificare un'immagine da obsolete allo stato precedente, modificare obsolescence_at in null. Se l'immagine precedentemente conteneva un valore diverso da null per deprecation_at, questa modifica della proprietà rimuove lo stato obsolete e lo modifica nuovamente in deprecated. Se lo stato precedente era available, il che significa che l'immagine è stata spostata da available direttamente a obsolete, questa modifica della proprietà passa da obsolete a 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 }'
    
  • Per modificare un'immagine che ha entrambe le proprietà deprecation_at o obsolescence_at impostate di nuovo su available, è necessario aggiornare entrambe le proprietà deprecation_at o 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 }'
    

Modificare lo stato del ciclo di vita dell'immagine personalizzata utilizzando Terraform

Per modificare immediatamente lo stato utilizzando Terraform, utilizzare il ibm_is_image_deprecate o ibm_is_image_obsolete comandi delle risorse. Utilizzare uno dei seguenti esempi. Per la variabile name, specifica il nome dell'immagine personalizzata per la modifica dello stato.

È possibile effettuare una modifica di stato immediata solo se una modifica di stato futura non è pianificata. Per rimuovere una modifica di stato pianificata, consulta Rimuovi una modifica di stato del ciclo di vita dell'immagine personalizzata pianificata utilizzando Terraform. Dopo aver rimosso la modifica di stato pianificata, è possibile effettuare una modifica di stato immediata.

  • Modificare lo stato del ciclo di vita dell'immagine 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"
      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
    }
    
  • Modificare lo stato del ciclo di vita dell'immagine 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"
      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
    }
    

Per pianificare una modifica di stato, utilizzare uno dei seguenti esempi.

Per l'attributo 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 a due cifre
  • T separa le informazioni di data e ora
  • hh è il numero di ore a due cifre
  • mm è il numero di minuti a due cifre
  • +hh:mm o -hh:mm è il fuso orario del Tempo universale coordinato

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

Quando si pianifica la data e l'ora, non è possibile utilizzare la data e l'ora correnti. Ad esempio, se è 8:00 AM del 12 giugno, la data e l'ora pianificate devono essere successive alle 8:00 AM 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.

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

    Se si desidera modificare le voci di data e ora deprecation_at e obsolescence_at, è possibile eseguire nuovamente questi comandi. Le date e le ore precedenti vengono sostituite con le nuove date e ore.

Rimuovere lo stato del ciclo di vita dell'immagine personalizzata precedentemente pianificato utilizzando Terraform

Per rimuovere eventuali modifiche di stato pianificate, aggiornare gli attributi deprecation_at o obsolescence_at in null. Questa modifica di attributo rimuove la data e l'ora dall'immagine e l'immagine non viene più pianificata per tale modifica di stato.

  • Per cambiare un'immagine da deprecated a available, modificare la proprietà deprecation_at in null.

    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
    }
    
  • Per modificare un'immagine da obsolete allo stato precedente, modificare obsolescence_at in null. Se l'immagine precedentemente conteneva un valore diverso da null per deprecation_at, la modifica di questo attributo rimuove lo stato obsolete e lo riporta a deprecated. Se lo stato precedente era available, il che significa che l'immagine è stata spostata da available direttamente a obsolete, questa modifica di attributo si sposta da obsolete a 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
    }
    
  • Per modificare un'immagine con entrambe le proprietà deprecation_at o obsolescence_at reimpostate su available, è necessario aggiornare entrambi gli attributi deprecation_at o obsolescence_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
    }