Visualizza i dettagli e lo stato delle estensioni su una VM

Utilizza i metodi di sola lettura extension-state list e get per visualizzare lo stato di runtime delle estensioni installate su ogni istanza VM senza connetterti a ogni macchina. Quando utilizzi le policy di estensione, su una VM potrebbero essere installate più estensioni da policy diverse. I metodi extension-state ti consentono di visualizzare la configurazione finale effettiva e la policy di gestione per ogni estensione installata e ti aiutano a risolvere i problemi quando viene installata un'estensione imprevista o un'estensione non funziona su un'istanza.

Informazioni sui dettagli e sullo stato delle estensioni

Puoi installare le estensioni VM sulle VM creando policy di estensione globali o di zona a livello di organizzazione, cartella o progetto. Una singola policy può installare più estensioni su una singola VM e più policy nella gerarchia delle risorse possono essere applicate alla stessa VM.

I metodi di stato dell'estensione di sola lettura ti consentono di elencare gli stati di tutte le estensioni sulla VM per visualizzare la configurazione effettiva finale e lo stato di runtime di ogni estensione installata. Le informazioni restituite mostrano la versione attiva, lo stato di applicazione, lo stato di integrità e l'identificatore della policy di gestione di ogni estensione.

Visualizza le estensioni e le versioni delle VM

Puoi utilizzare Google Cloud CLI o l'API Compute Engine per visualizzare i dettagli delle estensioni VM installate. Questo documento descrive come utilizzare gcloud. Per informazioni sull'utilizzo dell'API Compute Engine per visualizzare gli stati delle estensioni, consulta Visualizza gli stati delle estensioni MV su un'istanza.

Autorizzazioni IAM necessarie per visualizzare i dettagli dell'estensione

Per visualizzare i ruoli necessari per visualizzare le informazioni sulle estensioni installate e sulle relative versioni a livello di progetto, cartella o organizzazione, seleziona uno dei livelli:

Progetto

Per ottenere le autorizzazioni necessarie per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore delle policy di estensione delle VM di Compute (roles/compute.vmExtensionPolicyViewer) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di progetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy di estensione VM di zona o globali a livello di progetto, sono necessarie le seguenti autorizzazioni:

  • Descrivi un'estensione VM specifica su un'istanza: compute.vmExtensions.get
  • Elenca tutte le estensioni VM su un'istanza: compute.vmExtensions.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Cartella

Le policy delle estensioni a livello di cartella sono disponibili in anteprima.

Per ottenere le autorizzazioni necessarie per visualizzare le policy di estensione delle VM a livello di zona o globale nella cartella, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore delle policy di estensione delle VM di Compute a livello di cartella (roles/compute.folderVmExtensionPolicyViewer) nella cartella. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di cartella. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di cartella, sono necessarie le seguenti autorizzazioni:

  • Descrivi un'estensione VM specifica su un'istanza: compute.folderVmExtensions.get
  • Elenca tutte le estensioni VM su un'istanza: compute.folderVmExtensions.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Organizzazione

Le policy delle estensioni a livello di organizzazione sono disponibili in anteprima.

Per ottenere le autorizzazioni necessarie per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) sulla tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di organizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy di estensione delle VM a livello di zona o globale a livello di organizzazione, sono necessarie le seguenti autorizzazioni:

  • Descrivi un'estensione VM specifica su un'istanza: compute.orgVmExtensions.get
  • Elenca tutte le estensioni VM su un'istanza: compute.orgVmExtensions.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più sui ruoli e sulle autorizzazioni IAM in Compute Engine, consulta Ruoli e autorizzazioni di Compute Engine.

Elenca le estensioni e le versioni delle VM

Per elencare le estensioni e le versioni delle VM gestite dal gestore di estensioni VM nelle zone o a livello globale nel progetto, nella cartella o nell'organizzazione, seleziona una delle seguenti opzioni:

A livello di zona

Utilizza il comando gcloud preview compute zone-vm-extension-policies extensions list per elencare le estensioni VM in una zona all'interno del progetto, della cartella o dell'organizzazione:

Livello di progetto

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

Sostituisci le seguenti variabili nel comando:

  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f.
Livelli di cartella e organizzazione

Per eseguire l'attività precedente a livello di cartella o organizzazione, utilizza lo stesso comando con una delle seguenti modifiche:

  • Per informazioni a livello di cartella, sostituisci l'opzione --project=PROJECT_ID con --folder=folders/FOLDER_ID, dove FOLDER_ID è l'ID numerico della cartella.
  • Per informazioni a livello di organizzazione, sostituisci l'opzione --project=PROJECT_ID con --organization=organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID numerico della tua organizzazione.

Globale

Utilizza il comando gcloud preview compute global-vm-extension-policies extensions list per elencare le estensioni VM in tutte le zone del progetto, della cartella o dell'organizzazione:

Livello di progetto

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Sostituisci la seguente variabile nel comando:

  • PROJECT_ID: l'identificatore del progetto.
Livelli di cartella e organizzazione

Per eseguire l'attività precedente a livello di cartella o organizzazione, utilizza lo stesso comando con una delle seguenti modifiche:

  • Per informazioni a livello di cartella, sostituisci l'opzione --project=PROJECT_ID con --folder=folders/FOLDER_ID, dove FOLDER_ID è l'ID numerico della cartella.
  • Per informazioni a livello di organizzazione, sostituisci l'opzione --project=PROJECT_ID con --organization=organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID numerico della tua organizzazione.

Visualizza le informazioni su un'estensione VM specifica

Per visualizzare i dettagli di un'estensione VM specifica in una singola zona o a livello globale nel progetto, nella cartella o nell'organizzazione, seleziona una delle seguenti opzioni:

A livello di zona

Utilizza il comando gcloud preview compute zone-vm-extension-policies extensions describe per visualizzare i dettagli di un'estensione VM specifica in una zona all'interno del progetto, della cartella o dell'organizzazione:

Livello di progetto

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Sostituisci le seguenti variabili nel comando:

  • EXTENSION_NAME: una delle estensioni supportate dal gestore di estensioni VM, ad esempio ops-agent.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f.
Livelli di cartella e organizzazione

Per eseguire l'attività precedente a livello di cartella o organizzazione, utilizza lo stesso comando con una delle seguenti modifiche:

  • Per informazioni a livello di cartella, sostituisci l'opzione --project=PROJECT_ID con --folder=folders/FOLDER_ID, dove FOLDER_ID è l'ID numerico della cartella.
  • Per informazioni a livello di organizzazione, sostituisci l'opzione --project=PROJECT_ID con --organization=organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID numerico della tua organizzazione.

Globale

Utilizza il comando gcloud preview compute global-vm-extension-policies extensions describe per visualizzare i dettagli di un'estensione VM specifica in tutte le zone del progetto, della cartella o dell'organizzazione:

Livello di progetto

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Sostituisci le seguenti variabili nel comando:

  • EXTENSION_NAME: una delle estensioni supportate dal gestore di estensioni VM, ad esempio ops-agent.
  • PROJECT_ID: l'identificatore del progetto.
Livelli di cartella e organizzazione

Per eseguire l'attività precedente a livello di cartella o organizzazione, utilizza lo stesso comando con una delle seguenti modifiche:

  • Per informazioni a livello di cartella, sostituisci l'opzione --project=PROJECT_ID con --folder=folders/FOLDER_ID, dove FOLDER_ID è l'ID numerico della cartella.
  • Per informazioni a livello di organizzazione, sostituisci l'opzione --project=PROJECT_ID con --organization=organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID numerico della tua organizzazione.

Visualizza gli stati delle estensioni VM su un'istanza

Le policy di estensione potrebbero installare più estensioni su una singola VM. Per determinare lo stato di ogni estensione, inclusa la configurazione effettiva, lo stato di runtime e altre informazioni, puoi esaminare lo stato delle estensioni su una VM specifica.

I metodi extension-state restituiscono informazioni solo sulle istanze di Ops Agent installate e gestite dalle policy del gestore di estensioni VM. Se su alcune VM sono in esecuzione agenti installati con altri mezzi, non sono disponibili informazioni sulle estensioni da segnalare per questi agenti.

Puoi utilizzare Google Cloud CLI o l'API Compute Engine per visualizzare lo stato delle estensioni installate sulle VM. Questo documento descrive come utilizzare gcloud. Per informazioni sull'utilizzo dell'API Compute Engine per visualizzare gli stati delle estensioni, consulta Visualizza gli stati delle estensioni MV su un'istanza.

Autorizzazioni IAM necessarie per visualizzare lo stato dell'estensione

Per ottenere le autorizzazioni necessarie per visualizzare gli stati delle estensioni VM su un'istanza, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore Compute (roles/compute.viewer) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare gli stati delle estensioni VM su un'istanza. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare gli stati delle estensioni VM su un'istanza sono necessarie le seguenti autorizzazioni:

  • Elenca gli stati di tutte le estensioni VM su un'istanza: compute.instances.listVmExtensionStates
  • Recupera lo stato di un'estensione VM specifica su un'istanza: compute.instances.getVmExtensionState

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Elenca le estensioni installate su un'istanza VM

Per elencare tutte le estensioni VM installate su un'istanza e visualizzarne gli stati attuali utilizzando gcloud, esegui il comando gcloud beta compute instances list-vm-extension-states:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci le seguenti variabili nel comando:

  • INSTANCE_NAME: il nome dell'istanza VM
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona in cui risiede l'istanza, ad esempio us-central1-f.

Il comando restituisce il nome, lo stato di applicazione e lo stato di integrità di ogni estensione installata. Per informazioni sui valori restituiti quando visualizzi gli stati delle estensioni, consulta Interpreta i campi dello stato delle estensioni VM.

Per ulteriori informazioni sulla visualizzazione delle informazioni sullo stato delle estensioni sulle VM, incluse le informazioni sull'utilizzo dell'API Compute Engine, consulta Visualizza gli stati delle estensioni VM su un'istanza.

Visualizza lo stato di un'estensione VM specifica su un'istanza

Per ottenere informazioni sullo stato di un'estensione VM specifica installata su una VM utilizzando gcloud, esegui il comando gcloud beta compute instances get-vm-extension-state:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

Sostituisci le seguenti variabili nel comando:

  • INSTANCE_NAME: il nome dell'istanza VM
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona in cui risiede l'istanza, ad esempio us-central1-f.
  • EXTENSION_NAME: una delle estensioni supportate dal gestore di estensioni VM, ad esempio ops-agent.

Il comando restituisce il nome dell'estensione, la versione attiva, le informazioni sull'integrità, le informazioni sull'applicazione e l'ID della policy di gestione. Per informazioni sui valori restituiti quando visualizzi gli stati delle estensioni, consulta Interpreta i campi dello stato delle estensioni VM.

Per ulteriori informazioni sulla visualizzazione delle informazioni sullo stato delle estensioni sulle VM, incluse le informazioni sull'utilizzo dell'API Compute Engine, consulta Visualizza gli stati delle estensioni VM su un'istanza.

Passaggi successivi