Best practice per le famiglie di immagini

Questo documento spiega le best practice per l'utilizzo delle famiglie di immagini su Compute Engine.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

  Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

  gcloud

  1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

     gcloud init

     Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

• Imposta una regione e una zona predefinite.

REST

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

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Famiglie di immagini pubbliche

Compute Engine fornisce famiglie di immagini per fare in modo che i sistemi di automazione possano fare riferimento alle immagini più recenti. In qualità di amministratore, puoi raggruppare una serie di immagini in una famiglia. In questo modo, gli utenti delle immagini devono tenere traccia solo del nome della famiglia di immagini, anziché di un nome esatto dell'immagine. Poiché i nomi delle immagini devono essere univoci, le pipeline di build delle immagini spesso creano nomi di immagini con informazioni codificate, ad esempio il nome dell'applicazione, la data e la versione, ad esempio my-application-v3-20210101. Negli strumenti di automazione, puoi fare riferimento al nome della famiglia di immagini anziché dover aggiornare il nome dell'immagine a intervalli. L'utilizzo delle famiglie di immagini garantisce l'accesso sempre all'immagine più recente della famiglia, ad esempio my-application.

Le immagini pubbliche sono raggruppate in famiglie di immagini. Una famiglia di immagini pubblica fa sempre riferimento all'ultima versione di un'immagine disponibile in ogni zona. Quando vengono rilasciate nuove immagini a livello globale, la loro disponibilità iniziale nelle famiglie di immagini dipende dalla zona, il che migliora la tolleranza agli errori zonali per i tuoi workflow durante gli aggiornamenti delle immagini Google.

Durante l'implementazione dell'immagine, l'ultima versione di un'immagine in una famiglia di immagini potrebbe differire in zone diverse. Ad esempio, la debian-12 famiglia di immagini nel progetto debian-cloud punta sempre all'immagine Debian 12 più recente, ma l'immagine Debian 12 più recente nella zona us-central1-a e southamerica-east1-b potrebbe essere diversa.

Quando crei VM da famiglie di immagini utilizzando Google Cloud CLI, Compute Engine utilizza l'immagine più recente disponibile nella zona della VM per la tua richiesta. Quando crei VM utilizzando la console Google Cloud , Compute Engine mostra solo le immagini pubbliche disponibili nella zona selezionata. Se vuoi creare VM utilizzando l'ultima immagine disponibile a livello globale, utilizza il comando gcloud CLI instances create e specifica --image-family-scope=global.

Visualizzazione dell'ultima versione dell'immagine disponibile

Puoi visualizzare l'ultima immagine disponibile a livello globale in una famiglia di immagini oppure l'ultima immagine disponibile in una zona specifica.

A livello globale

Per visualizzare l'ultima immagine disponibile a livello globale in una famiglia di immagini, utilizza uno dei seguenti metodi:

gcloud compute images describe-from-family IMAGE_FAMILY_NAME  \
   --project=IMAGE_PROJECT

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

Per zona

Per visualizzare l'ultima immagine disponibile in una famiglia di immagini per una zona specifica, utilizza uno dei seguenti metodi:

gcloud compute images describe-from-family IMAGE_FAMILY_NAME  \
   --project=IMAGE_PROJECT \
   --zone=ZONE

GET https://compute.googleapis.com/compute/v1/projects/IMAGE_PROJECT/zones/ZONE/imageFamilyViews/IMAGE_FAMILY_NAME

Famiglie di immagini personalizzate

Puoi creare famiglie di immagini personalizzate per le tue immagini personalizzate. La famiglia di immagini rimanda all'immagine più recente che hai utilizzato per creare la famiglia di immagini. Per eseguire il rollback di una famiglia di immagini a una versione immagine precedente, puoi ritirare l'immagine più recente della famiglia, a condizione che l'immagine precedente non sia ritirata. Per saperne di più, vedi Impostare le versioni delle immagini in una famiglia di immagini.

Per creare un'immagine con una famiglia di immagini o per creare una famiglia di immagini se non esiste, devi aggiungere un flag --family aggiuntivo al passaggio di creazione dell'immagine, ad esempio:

gcloud compute images create my-application-v3-20210101 \
    --source-disk my-application-disk-1 \
    --source-disk-zone us-central1-f \
    --family my-application

Dopo aver eseguito questo comando, tutte le chiamate per eseguire un'istanza basata sull'immagine my-application puntano all'immagine appena creata, my-application-v3-20210101.

Quando selezioni un nome per la famiglia di immagini, consulta la Convenzione di denominazione.

Come utilizzare le famiglie di immagini

Sebbene le famiglie di immagini ti consentano di fare riferimento all'immagine più recente, quest'ultima potrebbe introdurre incompatibilità con la tua applicazione, il che può causare problemi in un ambiente di produzione se non viene convalidata. Se vuoi sfruttare al meglio i vantaggi delle famiglie di immagini riducendo i rischi, ti consigliamo di testare l'immagine di riferimento più recente della famiglia di immagini prima di utilizzarla nell'ambiente di produzione.

In sintesi, puoi prendere in considerazione il seguente approccio:

• Configura un ambiente di test separato dall'ambiente di produzione.
• Nell'ambiente di test, completa i seguenti passaggi:
  • Crea una famiglia di immagini personalizzata dalla famiglia di immagini di origine.
  • Verifica la stabilità della nuova immagine nella famiglia di immagini personalizzata rispetto ai tuoi workload.
• Una volta verificata, sposta questa famiglia di immagini personalizzate in un ambiente di produzione.

Ad esempio, la procedura potrebbe essere simile alla seguente.

1. Nel progetto di test, crea un'immagine dalla famiglia di immagini di origine. Questa nuova famiglia di origini immagini deve avere anche una propria famiglia di immagini personalizzata a cui fare riferimento nell'ambiente di test. Per creare l'immagine con una famiglia di immagini personalizzata, esegui il seguente comando:

   gcloud compute images create test-image-name \
   --source-image-project source-project \
   --source-image-family source-image-family \
   --project test-project \
   --family test-image-family
   

   Sostituisci quanto segue:

   • test-image-name: il nome dell'immagine di test.
   • source-project: il progetto a cui appartiene la famiglia di immagini di origine.
   • source-image-family: il nome della famiglia dell'immagine di origine.
   • test-project: il nome del progetto di test a cui vuoi aggiungere la famiglia di immagini.
   • test-image-family: il nome della famiglia di immagini di test.

2. Utilizzando la famiglia di immagini personalizzate test-image-family, crea una VM per testare il carico di lavoro. Per creare la VM, esegui questo comando:

   gcloud compute instances create test-instance-name \
   --image-family your-test-image-family \
   --project test-project
   

   Sostituisci quanto segue:

   • test-instance-name: il nome dell'istanza di test.
   • test-image-family: il nome della famiglia di immagini di test.
   • test-project: il nome del progetto di test.

3. Dopo aver verificato che questa immagine funzioni bene per il tuo carico di lavoro, copiala nell'ambiente di produzione.

   gcloud compute images create prod-image-name \
   --source-image-family test-image-family \
   --source-image-project test-project \
   --project prod-project \
   --family prod-image-family
   

   Sostituisci quanto segue:

   • prod-image-name: il nome dell'immagine di produzione.
   • test-image-family: il nome della famiglia di immagini di test.
   • test-project: il progetto a cui appartiene la famiglia di immagini di test.
   • prod-project: il nome del progetto che si trova nell'ambiente di produzione.
   • prod-image-family: il nome della famiglia di immagini che vuoi utilizzare nel tuo ambiente di produzione.