Imposta la versione immagine in una famiglia di immagini

Utilizza le famiglie di immagini per semplificare il controllo delle versioni delle immagini. Aggiungi un'immagine a una famiglia di immagini per impostarla come versione immagine più recente. Se ritieni necessario eseguire il rollback della famiglia di immagini a una versione immagine precedente, ritira l'immagine più recente della famiglia.

Per le best practice relative l'utilizzo delle famiglie di immagini, consulta Best practice per le famiglie di immagini.

Facoltativamente, puoi specificare la posizione di archiviazione dell'immagine utilizzando la consoleGoogle Cloud , il comando gcloud compute images create con il flag --storage-location o il metodo images().insert.

Prima di iniziare

  • Leggi il documento Immagini.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo di verifica dell'identità per poter accedere a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

      Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Imposta la versione immagine in una famiglia di immagini

Console

  1. Nella console Google Cloud , vai alla pagina Crea un'immagine.

    Vai a Crea un'immagine

  2. Specifica il Nome dell'immagine. Ad esempio, image-v1.

  3. Specifica l'Origine da cui vuoi creare un'immagine. Può essere un disco permanente, uno snapshot, un'altra immagine o un file disk.raw in Cloud Storage.

  4. Se stai creando un'immagine da un disco collegato a una VM in esecuzione, seleziona Mantieni in esecuzione l'istanza per confermare che vuoi creare l'immagine mentre la VM è in esecuzione. Puoi preparare la VM prima di creare l'immagine.

  5. Nell'elenco a discesa Basata sulla posizione del disco di origine (impostazione predefinita), specifica la posizione in cui archiviare l'immagine. Ad esempio, specifica us per archiviare l'immagine nella località multiregionale us oppure us-central1 per archiviarla nella regione us-central1. Se non effettui una selezione, Compute Engine archivia l'immagine nella località multiregionale più vicina a quella di origine dell'immagine.

  6. Specifica la Famiglia della nuova immagine. Ad esempio, aggiungi my-image-family per organizzare l'immagine all'interno di una famiglia di immagini.

  7. (Facoltativo) Specifica altre proprietà dell'immagine:

    • Descrizione: una descrizione dell'immagine personalizzata.
    • Etichetta: un'etichetta per raggruppare le risorse.

  8. Specifica la chiave di crittografia. Puoi scegliere tra una Google-owned and Google-managed encryption key, una chiave Cloud Key Management Service (Cloud KMS) o una chiave di crittografia fornita dal cliente (CSEK). Se non viene specificata alcuna chiave di crittografia, le immagini vengono criptate utilizzando una Google-owned and Google-managed encryption key.

  9. Fai clic su Crea per creare l'immagine.

gcloud 

gcloud compute images create image-v1 \
    --source-disk disk-1 \
    --source-disk-zone us-central1-f \
    --family my-image-family

La famiglia di immagini rimanda a image-v1. Aggiungi una seconda immagine alla famiglia:

gcloud compute images create image-v2 \
    --source-disk disk-2 \
    --source-disk-zone us-central1-f \
    --family my-image-family

REST

Effettua una richiesta POST al metodo images().insert. Specifica la famiglia di immagini nel corpo della richiesta.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images

{
  "name": "image-v2",
  "sourceDisk": "/zones/us-central1-f/disks/disk-2",
  "family":"my-image-family",

}

La famiglia di immagini rimanda a image-v2 perché è l'immagine più recente che hai aggiunto alla famiglia.

gcloud

Puoi vedere a quale immagine rimanda una famiglia eseguendo il comando gcloud compute images describe-from-family.

Ad esempio:

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '8904691942610171306'
kind: compute#image
name: image-v2
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v2
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v2
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY

REST

Effettua una richiesta GET al metodo images().getFromFamily. Specifica la famiglia di immagini nel corpo della richiesta.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/family

{
  "resourceId":"my-image-family",

}

Se ritieni necessario eseguire il rollback della famiglia di immagini in modo che non rimandi più a image-v2, ritira image-v2 e la famiglia rimanderà di nuovo a image-v1.

gcloud compute images deprecate image-v2 \
    --state DEPRECATED \
    --replacement image-v1

Verifica che la famiglia di immagini rimandi a image-v1.

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '2741732787056801255'
kind: compute#image
name: image-v1
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v1
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v1
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY