Attiva l'arresto normale in un'istanza Compute Engine

Console

1. Nella console Google Cloud , vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Nella colonna Nome, fai clic sul nome dell'istanza in cui vuoi attivare l'arresto normale.

   Viene visualizzata la pagina dei dettagli dell'istanza.

3. Fai clic su edit Modifica.

4. Nella sezione Gestione, segui questi passaggi:

   1. Seleziona la casella di controllo Esegui l'arresto normale della VM.

   2. (Facoltativo) Per specificare un periodo di arresto normale personalizzato, specifica una durata nel campo Durata massima.

5. Fai clic su Salva.

gcloud

Per attivare l'arresto normale in un'istanza esistente, utilizza il comando gcloud beta compute instances update con il flag --graceful-shutdown:

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --zone=ZONE

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza

• ZONE: la zona in cui si trova l'istanza

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il flag --graceful-shutdown-max-duration:

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --zone=ZONE

Sostituisci MAX_DURATION con una durata per il periodo di arresto. Il valore deve essere formattato come numero di ore, minuti o secondi seguito rispettivamente da h, m e s. Ad esempio, specifica 1h per un'ora o 20m10s per 20 minuti e 10 secondi.

REST

1. Crea un file JSON vuoto.

2. Per visualizzare le proprietà di un'istanza esistente, effettua una richiesta GET al metodo instances.get beta:

   GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto in cui si trova l'istanza

   • ZONE: la zona in cui si trova l'istanza

   • INSTANCE_NAME: il nome di un'istanza esistente

3. Nel file JSON vuoto che hai creato nei passaggi precedenti, procedi in questo modo:

   1. Inserisci i dettagli di configurazione dell'istanza dall'output della richiesta GET.

   2. Nel campo scheduling, aggiungi il campo gracefulShutdown come indicato di seguito:

      {
        ...
        "scheduling": {
          ...
          "gracefulShutdown": {
            "enabled": true
          }
        },
        ...
      }
      

      In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il flag maxDuration:

      {
        ...
        "scheduling": {
          ...
          "gracefulShutdown": {
            ...
            "enabled": true,
            "maxDuration": {
              "seconds": "MAX_DURATION"
            }
          }
        },
        ...
      }
      

      Sostituisci MAX_DURATION con una durata in secondi per il periodo di arresto normale. Il valore deve essere compreso tra 1 e 3600, vale a dire 3600 secondi (un'ora).

4. Per aggiornare l'istanza e riavviarla, invia una richiesta PUT al metodo instances.update beta. Nella richiesta, segui questi passaggi:

   • Nell'URL della richiesta, includi il parametro di query mostDisruptiveAllowedAction impostato su RESTART.

   • Nel corpo della richiesta, includi le proprietà dell'istanza dal file JSON che hai creato e aggiornato nei passaggi precedenti.

   La richiesta PUT per aggiornare l'istanza è simile alla seguente:

   PUT https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART
   
   {
     ...
     "scheduling": {
       ...
       "gracefulShutdown": {
         "enabled": true
       }
     },
     ...
   }
   

Console

1. Nella console Google Cloud , vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Fai clic su Crea istanza.

   Viene visualizzata la pagina Crea un'istanza.

3. Specifica un Nome per l'istanza.

4. Specifica la Regione e la Zona in cui creare l'istanza.

5. Specifica un tipo di macchina per l'istanza.

6. Nel menu di navigazione, fai clic su Avanzato.

7. Espandi la sezione expand_more Impostazioni avanzate del modello di provisioning delle VM e segui questi passaggi:

   1. Seleziona la casella di controllo Esegui l'arresto normale della VM.

   2. (Facoltativo) Per specificare un periodo di arresto normale personalizzato, specifica una durata nel campo Durata massima.

8. Fai clic su Crea.

gcloud

Per creare un'istanza in cui è abilitato l'arresto normale, utilizza il comando gcloud beta compute instances create con il flag --graceful-shutdown:

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza

• MACHINE_TYPE: il tipo di macchina da usare per l'istanza

• ZONE: la zona in cui creare l'istanza

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il flag --graceful-shutdown-max-duration:

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Sostituisci MAX_DURATION con una durata per il periodo di arresto normale. Il valore deve essere formattato in numero di ore, minuti o secondi seguito rispettivamente da h, m e s. Ad esempio, specifica 1h per un'ora o 20m10s per 20 minuti e 10 secondi.

REST

Per creare un'istanza in cui è abilitato l'arresto normale, effettua una richiesta POST al metodo beta.instances.insert. Nel corpo della richiesta, includi il campo gracefulShutdown:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "gracefulShutdown": {
      "enabled": true
    }
  }
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui creare l'istanza

• ZONE: la zona in cui creare l'istanza

• INSTANCE_NAME: il nome dell'istanza

• MACHINE_TYPE: il tipo di macchina per l'istanza

• IMAGE_PROJECT: il progetto di immagini che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

• IMAGE: specifica una delle seguenti opzioni:

  • Una versione specifica dell'immagine sistema operativo, ad esempio debian-12-bookworm-v20240617.

  • Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. Questa formattazione specifica l'immagine sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per saperne di più sull'utilizzo delle famiglie di immagini, consulta le best practice per le famiglie di immagini.

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il campo maxDuration nel corpo della richiesta:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  }
}

Sostituisci MAX_DURATION con una durata in secondi per il periodo di arresto normale. Il valore deve essere compreso tra 1 e 3600, vale a dire 3600 secondi (un'ora).

gcloud

Per creare in blocco istanze in cui è abilitato l'arresto normale, utilizza il comando gcloud beta compute instances bulk create con il flag --graceful-shutdown.

Ad esempio, per creare istanze in blocco in un'unica zona e specificare un pattern del nome per le istanze, esegui il seguente comando:

gcloud beta compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

Sostituisci quanto segue:

• COUNT: il numero di istanze da creare.

• MACHINE_TYPE: il tipo di macchina per le istanze.

• NAME_PATTERN: il pattern del nome per le istanze. Per sostituire una sequenza di numeri in un nome dell'istanza, utilizza una sequenza di caratteri hash (#). Ad esempio, l'utilizzo di instance-# per il pattern del nome genera istanze con nomi che iniziano con instance-1, instance-2 e via di seguito fino al numero di VM specificato da COUNT.

• ZONE: la zona in cui creare le istanze in blocco.

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il flag --graceful-shutdown-max-duration:

gcloud beta compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

Sostituisci MAX_DURATION con una durata per il periodo di arresto normale. Il valore deve essere formattato in numero di ore, minuti o secondi seguito rispettivamente da h, m e s. Ad esempio, specifica 1h per un'ora o 20m10s per 20 minuti e 10 secondi.

REST

Per creare in blocco le istanze in cui è abilitato l'arresto normale, effettua una richiesta POST al metodo instances.bulkInsert beta. Nel corpo della richiesta, includi il campo gracefulShutdown.

Ad esempio, per creare in blocco più istanze in un'unica zona e specificare un pattern di nomi per le istanze, invia una richiesta POST nel modo seguente:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui creare le istanze in blocco.

• ZONE: la zona in cui creare le istanze in blocco.

• COUNT: il numero di istanze da creare.

• NAME_PATTERN: il pattern del nome per le istanze. Per sostituire una sequenza di numeri in un nome dell'istanza, utilizza una sequenza di caratteri hash (#). Ad esempio, l'utilizzo di instance-# per il pattern del nome genera istanze con nomi che iniziano con instance-1, instance-2 e via di seguito fino al numero di VM specificato da COUNT.

• MACHINE_TYPE: il tipo di macchina per le istanze.

• IMAGE_PROJECT: il progetto di immagini che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

• IMAGE: specifica una delle seguenti opzioni:

  • Una versione specifica dell'immagine sistema operativo, ad esempio debian-12-bookworm-v20240617.

  • Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. Questa formattazione specifica l'immagine sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per saperne di più sull'utilizzo delle famiglie di immagini, consulta le best practice per le famiglie di immagini.

• ZONE: la zona in cui creare le istanze in blocco.

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il campo maxDuration nel corpo della richiesta:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

Sostituisci MAX_DURATION con una durata in secondi per il periodo di arresto normale. Il valore deve essere compreso tra 1 e 3600, vale a dire 3600 secondi (un'ora).

Console

1. Nella console Google Cloud , vai alla pagina Modelli di istanza.

   Vai a Modelli di istanza

2. Fai clic su Crea template di istanza.

   Viene visualizzata la pagina Crea un template di istanza.

3. Nel campo Nome, inserisci un nome per il template di istanza.

4. Seleziona la Località come descritto di seguito:

   • Per ridurre la dipendenza tra regioni creando un template di istanza regionale, segui questi passaggi:

     1. Scegli Regionale, se non è già selezionato.

     2. Nel campo Regione, seleziona la regione in cui creare il template di istanza.

   • Altrimenti, per utilizzare il template di istanza in più regioni, scegli Globale.

5. Nella sezione Configurazione macchina, specifica un tipo di macchina.

6. Espandi la sezione expand_more Impostazioni avanzate del modello di provisioning delle VM e segui questi passaggi:

   1. Seleziona la casella di controllo Esegui l'arresto normale della VM.

   2. (Facoltativo) Per specificare un periodo di arresto normale personalizzato, specifica una durata nel campo Durata massima.

7. Fai clic su Crea.

gcloud

Per creare un'istanza in cui è abilitato l'arresto normale, utilizza il comando gcloud beta compute instance-templates create con il flag --graceful-shutdown.

Ad esempio, per creare un template di istanza regionale con l'arresto normale abilitato, esegui il seguente comando:

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

Sostituisci quanto segue:

• INSTANCE_TEMPLATE_NAME: il nome del template di istanza

• REGION: la regione in cui creare il template di istanza

• MACHINE_TYPE: il tipo di macchina per le istanze create utilizzando il template di istanza

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il flag --graceful-shutdown-max-duration.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

Sostituisci MAX_DURATION con una durata per il periodo di arresto. Il valore deve essere formattato come numero di ore, minuti o secondi seguito rispettivamente da h, m e s. Ad esempio, specifica 1h per un'ora o 20m10s per 20 minuti e 10 secondi.

REST

Per creare un template di istanza in cui è attivato l'arresto normale, effettua una richiesta POST con uno dei seguenti metodi:

• Per creare un template di istanza globale: metodo instanceTemplates.insert beta.

• Per creare un template di istanza regionale: metodo regionInstanceTemplates.insert beta.

Ad esempio, per creare un template di istanza regionale con l'arresto normale abilitato, effettua una richiesta POST come segue:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui creare il template di istanza.

• REGION: la regione in cui creare il template di istanza.

• INSTANCE_TEMPLATE_NAME: il nome del template di istanza

• IMAGE_PROJECT: il progetto di immagini che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

• IMAGE: specifica una delle seguenti opzioni:

  • Una versione specifica dell'immagine sistema operativo, ad esempio debian-12-bookworm-v20240617.

  • Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. Questa formattazione specifica l'immagine sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per saperne di più sull'utilizzo delle famiglie di immagini, consulta le best practice per le famiglie di immagini.

• MACHINE_TYPE: il tipo di macchina per le istanze create utilizzando il template di istanza

In via facoltativa, per specificare un periodo di arresto normale personalizzato, includi il campo maxDuration nel corpo della richiesta.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

Sostituisci MAX_DURATION con una durata in secondi per il periodo di arresto. Il valore deve essere compreso tra 1 e 3600, vale a dire 3600 secondi (un'ora).