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.
- Per gestire un'immagine dal volume, vedi Gestione dell'immagine dal volume.
- Per utilizzare un'immagine personalizzata in un catalogo privato, vedere Onboarding di un'immagine di server virtuale per VPC.
- Per utilizzare le espressioni di uso consentito con le immagini personalizzate 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, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.
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.
- In IBM Cloud console, vai su Menu di navigazione icon
> Infrastrutture
> Calcolo > Immagini.
- Sulla scheda Immagini personalizzate, fare clic sull'icona 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:
| 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:
È 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.
- In IBM Cloud console, vai su Menu di navigazione icon
> Infrastrutture
> Calcolo > Immagini.
- Nella scheda Immagini personalizzate, fare clic sul nome di un'immagine personalizzata e, nel pannello successivo, fare clic su
View image details. - 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.
- 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:
- Ti serve un ruolo IAM che includa le azioni
is.image.image.exporteis.image.image.operate. Per ulteriori informazioni, vedi Gestione dell'accesso IAM per i servizi dell'infrastruttura VPC. - Hai bisogno di un'istanza del servizio IBM Cloud Object Storage creata. Devi anche creare un'autorizzazione per il Servizio immagini per VPC per accedere a IBM Cloud Object Storage con il ruolo di accesso del servizio Writer. Per ulteriori informazioni, consultare Concessione dell'accesso a IBM Cloud Object Storage per importare ed esportare immagini.
- Hai bisogno dell'accesso IAM per scrivere nel bucket in cui intendi esportare un'immagine. Per ulteriori informazioni, vedi Assegnazione dell'accesso a un singolo bucket.
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.
- In IBM Cloud console, vai su Menu di navigazione icon
> Infrastrutture
> Calcolo > Immagini.
- Sulla scheda Immagini personalizzate, fai clic sul nome dell'immagine personalizzata che vuoi esportare.
- Nella pagina dei dettagli dell'immagine, fare clic sul menu Azioni e selezionare Esporta.
- 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.
- 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.
- 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.
- 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.
- In IBM Cloud console, vai su Menu di navigazione icon
> Infrastrutture
> Calcolo > Immagini.
- Nella scheda Immagini personalizzate, fare clic sul nome di una immagine personalizzata per visualizzare i dettagli su tale immagine.
- 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.
- Nella pagina dei dettagli dell'immagine, fai clic sulla scheda Esporta cronologia.
- Per il lavoro di esportazione che si desidera eliminare o annullare, fare clic sull'icona 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.
- Nella pagina dei dettagli dell'immagine, fai clic sulla scheda Esporta cronologia.
- Per il lavoro di esportazione che si desidera rinominare, fare clic sull'icona 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.
- In IBM Cloud console, vai su Menu di navigazione icon
> Infrastrutture
> Calcolo > Immagini.
- Sulla scheda Immagini personalizzate, fare clic sull'icona Azioni
e selezionare Condividi nel catalogo.
- Nella pagina Condividi immagine a catalogo privato, seleziona Catalogo privato dall'elenco di cataloghi privati disponibili.
- Immettere un numero di versione in Versione software.
- Fai clic su Create catalog offering per condividere l'immagine nel catalogo privato.
- 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.
- 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.
- Selezionare Per data calendario o Per numero di giorni.
- 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.
-
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 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 cifreMMè il mese a due cifreDDè il giorno a due cifreTsepara le informazioni di data e orahhè l'ora a due cifremmsono i minuti a due cifre+hh:mmo-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 cifreMMè il mese a due cifreDDè il giorno a due cifreTsepara le informazioni di data e orahhè l'ora a due cifremmsono i minuti a due cifre+hh:mmo-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_ateobsolescence_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
deprecatedaavailable, modificare la proprietàdeprecation_atinnull.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
obsoleteallo stato precedente, modificareobsolescence_atinnull. Se l'immagine precedentemente conteneva un valore diverso danullperdeprecation_at, questa modifica della proprietà rimuove lo statoobsoletee lo modifica nuovamente indeprecated. Se lo stato precedente eraavailable, il che significa che l'immagine è stata spostata daavailabledirettamente aobsolete, questa modifica della proprietà passa daobsoleteaavailable.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_atoobsolescence_atimpostate di nuovo suavailable, è necessario aggiornare entrambe le proprietàdeprecation_atoobsolescence_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 cifreMMè il mese a due cifreDDè il giorno a due cifreTsepara le informazioni di data e orahhè il numero di ore a due cifremmè il numero di minuti a due cifre+hh:mmo-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_ateobsolescence_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
deprecatedaavailable, modificare la proprietàdeprecation_atinnull.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
obsoleteallo stato precedente, modificareobsolescence_atinnull. Se l'immagine precedentemente conteneva un valore diverso danullperdeprecation_at, la modifica di questo attributo rimuove lo statoobsoletee lo riporta adeprecated. Se lo stato precedente eraavailable, il che significa che l'immagine è stata spostata daavailabledirettamente aobsolete, questa modifica di attributo si sposta daobsoleteaavailable.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_atoobsolescence_atreimpostate suavailable, è necessario aggiornare entrambi gli attributideprecation_atoobsolescence_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 }