Visualizzare l'arresto graduale in un'istanza Compute Engine

Questo documento spiega come visualizzare i dettagli di un arresto graduale in un'istanza Compute Engine. Per scoprire di più sull'arresto sicuro, consulta la Panoramica dell'arresto sicuro.

La visualizzazione dei dettagli di un arresto graduale ti aiuta a monitorare la procedura di arresto graduale o a rivedere le relative impostazioni.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API. Google Cloud 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, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per visualizzare l'arresto graduale di un'istanza Compute, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.instances.get on the project necessaria per visualizzare l'arresto graduale di un'istanza di calcolo.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Visualizzare i dettagli di un arresto controllato

Per visualizzare i dettagli di un arresto elegante in un'istanza di calcolo, seleziona una delle seguenti opzioni:

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.

    Viene visualizzata la pagina dei dettagli dell'istanza e viene selezionata la scheda Dettagli.

  3. Per controllare le impostazioni di arresto graduale, nella sezione Criteri di disponibilità, controlla il valore del campo Durata massima dell'arresto graduale. Questo campo mostra il periodo di arresto graduale. Se viene visualizzato un trattino (-), significa che l'arresto graduale è disattivato.

  4. Per monitorare un arresto controllato in corso, nella sezione Informazioni di base controlla i seguenti campi:

    • Stato: questo campo mostra lo stato dell'istanza. Durante l'arresto graduale, viene visualizzato il messaggio Arresto in attesa e un timer conto alla rovescia che mostra il tempo rimanente prima del termine del periodo di arresto graduale.

    • Stato target: questo campo indica se Compute Engine sta interrompendo (Arrestato) o eliminando (Eliminato) l'istanza.

gcloud

Per visualizzare i dettagli di un'istanza e il relativo arresto graduale, utilizza il comando gcloud beta compute instances describe:

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.

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

Per controllare le impostazioni di arresto graduale o monitorare un arresto in corso, svolgi i seguenti passaggi:

  • Per controllare le impostazioni di arresto graduale nell'istanza, visualizza il campo scheduling nell'output:

    ...
scheduling:
  ...
  gracefulShutdown:
    enabled: true
    maxDuration:
      seconds: 'MAX_DURATION'
  ...
...

    Questo output include il valore MAX_DURATION, che specifica la durata del periodo di arresto graduale in secondi. Se non hai specificato un periodo di arresto personalizzato quando hai attivato l'arresto graduale nell'istanza, Compute Engine omette il campo maxDuration e imposta il periodo di arresto graduale su 10 minuti.

  • Per monitorare lo stato di un arresto controllato in corso, visualizza il campo shutdownDetails nell'output:

    ...
resourceStatus:
  ...
  shutdownDetails:
    maxDuration:
      seconds: 'MAX_DURATION'
    requestTimestamp: 'REQUEST_TIMESTAMP'
    stopState: STOP_STATE
    targetState: TARGET_STATE
...

    Questo output include i seguenti valori:

    • MAX_DURATION: la durata del periodo di chiusura graduale in secondi. Dopo che Compute Engine ha impostato STOP_STATE su STOPPING, elimina il campo maxDuration.

    • REQUEST_TIMESTAMP: il timestamp dell'inizio di STOP_STATE.

    • STOP_STATE: la fase di arresto dell'istanza. Il valore può essere uno dei seguenti:

      • PENDING_STOP: Compute Engine ha avviato l'interruzione di servizio graduale. L'istanza rimane in questo stato finché non interrompi manualmente l'arresto graceful o il periodo di arresto graceful non scade.

      • STOPPING: l'arresto graduale è terminato e Compute Engine prosegue con l'operazione di arresto o eliminazione.

    • TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza.

    Al termine dell'arresto dell'istanza, Compute Engine elimina il campo shutdownDetails.

REST

Per visualizzare i dettagli di un'istanza e il relativo arresto controllato, 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 dell'istanza.

Per controllare le impostazioni di arresto graduale o monitorare un arresto in corso, svolgi una delle seguenti operazioni:

  • Per controllare le impostazioni di arresto graduale nell'istanza, visualizza il campo scheduling nell'output:

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

    Questo output include il valore MAX_DURATION, che specifica la durata del periodo di arresto graduale in secondi. Se non hai specificato un periodo di arresto personalizzato quando hai attivato l'arresto graduale nell'istanza, Compute Engine omette il campo maxDuration e imposta il periodo di arresto graduale su 10 minuti.

  • Per monitorare lo stato di un arresto controllato in corso, visualizza il campo shutdownDetails nell'output:

    {
  ...
  "resourceStatus": {
    ...
    "shutdownDetails": {
      "maxDuration": {
        "seconds": "MAX_DURATION"
      },
      "requestTimestamp": "REQUEST_TIMESTAMP",
      "stopState": "STOP_STATE",
      "targetState": "TARGET_STATE"
    }
  },
  ...
}

    Questo output include i seguenti valori:

    • MAX_DURATION: la durata del periodo di chiusura graduale in secondi. Dopo che Compute Engine ha impostato STOP_STATE su STOPPING, elimina il campo maxDuration.

    • REQUEST_TIMESTAMP: il timestamp dell'inizio di STOP_STATE.

    • STOP_STATE: la fase di arresto dell'istanza. Il valore può essere uno dei seguenti:

      • PENDING_STOP: Compute Engine ha avviato l'interruzione di servizio graduale. L'istanza rimane in questo stato finché non interrompi manualmente l'arresto graceful o il periodo di arresto graceful non scade.

      • STOPPING: l'arresto graduale è terminato e Compute Engine prosegue con l'operazione di arresto o eliminazione.

    • TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza.

    Al termine dell'arresto dell'istanza, Compute Engine elimina il campo shutdownDetails.

Server dei metadati

  1. Connettersi all'istanza.

  2. Per visualizzare i dettagli di un arresto graduale in corso nell'istanza, esegui una query sul server di metadati:

    curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"

    Se è in corso un arresto elegante, l'output è simile al seguente:

    {
  "maxDuration": "MAX_DURATION",
  "requestTimestamp": "REQUEST_TIMESTAMP",
  "stopState": "STOP_STATE",
  "targetState": "TARGET_STATE"
}

    L'output include i seguenti valori:

    • MAX_DURATION: la durata del periodo di chiusura graduale in secondi. Dopo che Compute Engine ha impostato STOP_STATE su STOPPING, elimina il campo maxDuration.

    • REQUEST_TIMESTAMP: il timestamp dell'inizio di STOP_STATE.

    • STOP_STATE: la fase di arresto dell'istanza. Il valore può essere uno dei seguenti:

      • PENDING_STOP: Compute Engine ha avviato l'interruzione di servizio graduale. L'istanza rimane in questo stato finché non interrompi manualmente l'arresto graceful o il periodo di arresto graceful non scade.

      • STOPPING: l'arresto graduale è terminato e Compute Engine prosegue con l'operazione di arresto o eliminazione.

    • TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza.

Passaggi successivi