Gestione delle immagini da un volume

Le immagini personalizzate create da un volume sono indipendenti dal volume originale. È possibile aggiornare l'immagine ed eliminarla come necessario. È possibile eliminare il volume originale e l'immagine personalizzata persiste. Puoi pianificare l'obsolescenza e rendere l'immagine obsoleta nella console, dalla CLI o dall'API.

Espressioni di utilizzo consentito: È possibile utilizzare un'espressione di uso consentito con l'immagine personalizzata per definire le capacità e le restrizioni di un'immagine e aiutare a trovare combinazioni di immagini e profili compatibili durante la creazione del server. Il valore predefinito delle espressioni di uso consentito per le immagini personalizzate create da un volume è quello delle espressioni di uso consentito del volume di origine. Tuttavia, è possibile modificare queste espressioni di uso consentito sull'immagine personalizzata. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Pianificazione di una modifica dello stato del ciclo di vita per un'immagine personalizzata utilizzando l'interfaccia utente

È 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.

Utilizzare la seguente procedura per pianificare una modifica di stato singola:

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

Nella console IBM Cloud, vai a del menu di navigazione > infrastruttura > Elaborazione > Immagini.
Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni per un'immagine specifica e selezionare una delle opzioni disponibili.
Selezionare Pianifica ciclo di vita.
In Stato immagine, selezionare la modifica dello stato dell'immagine.
In Dettagli obsoleti, selezionare se modificare lo stato Immediatamente o Pianifica data futura.
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.
Fare clic su Salva.

Utilizza la 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.

Nella console IBM Cloud, vai a del menu di navigazione > infrastruttura > Elaborazione > Immagini.
Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni per un'immagine specifica e selezionare una delle opzioni disponibili.
Selezionare Pianifica ciclo di vita.
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.
Fai clic su Schedule.

Modifica dello stato del ciclo di vita di un'immagine personalizzata utilizzando la CLI

Puoi modificare lo stato del ciclo di vita di un'immagine IBM Cloud VPC creata da un volume dalla CLI (command - line interface). È possibile apportare una modifica di stato immediata utilizzando i comandi ibmcloud is image-deprecate o ibmcloud is image-obsolete. È anche possibile 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.

Rimuovere la modifica dello stato del ciclo di vita 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 dello stato del ciclo di vita di un'immagine personalizzata utilizzando l'API

Puoi modificare lo stato del ciclo di vita di un'immagine IBM Cloud VPC creata dal volume con 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 la modifica dello stato del ciclo di vita 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 }'
```

Considerazioni sulle prestazioni

Diversi fattori possono influire sulla velocità di accodamento e creazione dell'immagine dal volume, ad esempio la dimensione dell'immagine e il numero di lavori nella coda. Se un'immagine impiega più tempo di quanto si desidera attendere, è possibile annullare il lavoro.

Prestazioni durante la creazione dell'immagine

Quando crei l'immagine, il parametro API status_reasons indica image_request_queued, con un messaggio "La richiesta dell'immagine viene accettata e attende che le risorse di sistema diventino disponibili". Quando viene visualizzato questo messaggio, l'avvio del lavoro potrebbe richiedere del tempo. La seguente tabella fornisce alcune linee guida che si basano sulla dimensione dell'immagine. Controllare lo stato di in_progress per verificare se l'immagine è in fase di creazione. Di nuovo, a seconda della dimensione dell'immagine, potrebbe essere necessario del tempo prima che l'immagine sia disponibile.

Tempo di attesa stimato per la creazione dell'immagine
Dimensione immagine	Tempo stimato prima che l'immagine sia disponibile
5 GB	5 min
10 GB	10 min
25 GB	25 min
50 GB	50 min
75 GB	1 ora 15 min
100 GB	1 ora 40 min

L'ora di avvio del lavoro è di circa 30 secondi. Questo tempo non riflette il traffico nella coda, che può aumentare la stima. La maggior parte dei lavori inizia entro 5-10 minuti. Se ci vuole più tempo, annulla la creazione dell'immagine.

Annullamento di un'immagine in coda per la creazione

Puoi annullare la creazione dell'immagine eliminando l'immagine se il lavoro sottostante non è stato ancora avviato. Per le immagini in uno stato in sospeso , la chiamata API GET /images restituisce un codice motivo image_request_queued. Puoi eliminare l'immagine in sospeso con una richiesta DELETE /image{image_id}. In alternativa, puoi utilizzare la IU o la CLI per eliminare l'immagine che si trova in uno stato in sospeso.

Eliminazione di un'immagine personalizzata utilizzando l'interfaccia utente

È possibile eliminare un'immagine creata da un volume dall'elenco delle immagini personalizzate. È possibile eliminare le immagini che si trovano nello stato In sospeso (durante la creazione) e nello stato Disponibile.

Vai all'elenco di immagini personalizzate. Nell'IBM Cloud console, vai alla pagina Menu di navigazione > Infrastruttura VPC > Compute > Immagini.
Nella scheda Immagini personalizzate, individua l'immagine che vuoi eliminare. Dal menu Azioni , selezionare Elimina.

Eliminazione di un'immagine dal volume utilizzando la CLI

Individua l'immagine dal volume nell'elenco di immagini.
```
ibmcloud is images
```
Elimina l'immagine per ID.
```
ibmcloud is image-delete IMAGE_ID
```

Eliminazione di un'immagine dal volume utilizzando l'API

Effettuare una richiesta DELETE /images e specificare l'ID dell'immagine che è stata creata da un volume di boot.

Individua l'ID dell'immagine dal volume:

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

Elimina l'immagine per ID:

curl -X DELETE "$vpc_api_endpoint/v1/images/$image_id?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token"

Passi successivi

Visualizza in anteprima il processo end-to-end per creare una immagine dal volume, quindi puoi utilizzare l'immagine quando crei una nuova istanza del server virtuale. Per ulteriori informazioni, vedi l'esercitazione Immagine dal volume.