Gestione dei criteri guest (legacy)

Dopo aver creato un criterio ospite, puoi utilizzare le seguenti procedure per esaminare e gestire i criteri:

• Aggiorna i criteri guest: modifica le configurazioni dei criteri guest.
• Descrivi i criteri relativi agli ospiti: ricevi dettagli su uno specifico criterio per gli ospiti.
• Elenca criteri guest: visualizza un elenco di criteri guest in un progetto.
• Elimina un ospite: elimina un criterio specifico per gli invitati.
• Visualizza le configurazioni per un'istanza VM: visualizza le configurazioni applicate a un'istanza VM.
• Debug di un criterio guest: risolvi i problemi relativi a un criterio guest.

Poiché l'agente OS Config viene eseguito ogni 10-15 minuti, quando configuri un aggiornamento o un'eliminazione di un criterio, ci vorranno circa 10-15 minuti prima che le modifiche diventino effettive.

Puoi gestire i criteri guest utilizzando Google Cloud CLI o REST.

Prima di iniziare

• Esamina le quote di configurazione del sistema operativo.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
  

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

  gcloud

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

     gcloud init

  2. Set a default region and zone.

  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 sull'autenticazione di Google Cloud.

Aggiornamento dei criteri guest

Per aggiornare un criterio relativo agli ospiti, segui questi passaggi:

1. Aggiorna il file YAML o JSON.
2. Esegui un comando di aggiornamento o applicazione di patch. Il processo di aggiornamento è simile a quello di creazione, con l'aggiunta del supporto per gli etag, che consentono il controllo di contemporaneità e coerenza.

gcloud beta compute os-config guest-policies update POLICY_ID \
     --file=FILE

PATCH https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

{
  For more information, see Guest policy JSON
}

Descrizione di un criterio guest

gcloud beta compute os-config guest-policies describe POLICY_ID

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Norme relative agli invitati della scheda

gcloud beta compute os-config guest-policies list

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies

Eliminazione dei criteri guest

Quando l'agente OS Config rileva che viene attivata l'eliminazione di un criterio guest, lo stato attuale del sistema viene mantenuto, ma non vengono eseguite ulteriori operazioni di manutenzione della configurazione. Ad esempio, supponiamo che tu abbia configurato un criterio guest package-update-zone2b che installa un pacchetto my-package su tutte le VM nella zona us-west2-b e conserva il pacchetto UPDATED.

Se elimini il criterio package-update-zone2b, verranno applicate le seguenti modifiche:

• Tutte le VM in us-west2-b che hanno my-package installato mantengono my-package installata. Lo stato attuale del sistema non viene ripristinato.

• Su tutte le esecuzioni future dell'agente OS Config, dopo l'eliminazione del criterio, avviene quanto segue:

  • Se una nuova VM viene aggiunta a us-west2-b,my-package non sarà installata su questa nuova VM.
  • Per le istanze in cui è installato my-package, il pacchetto non viene aggiornato.

gcloud beta compute os-config guest-policies delete POLICY_ID

DELETE https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Visualizzazione delle configurazioni per un'istanza VM

gcloud beta compute os-config guest-policies lookup VM_NAME \
    --zone=ZONE

POST https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME:lookupEffectiveGuestPolicy

Risoluzione dei problemi

Esamina i criteri guest

Puoi utilizzare la console Google Cloud o Google Cloud CLI per ispezionare i criteri guest associati al tuo progetto.

Ispeziona i criteri guest per una VM specifica

Puoi eseguire il comando lookup per una determinata VM per vedere quali configurazioni si applicano a quella VM.

Nei casi in cui una VM non sembra applicare i requisiti del criterio guest previsto, è utile ispezionare l'elenco dei criteri guest le cui assegnazioni includono quella specifica istanza VM. Questo consente di determinare se il campo Assignment nel criterio guest corrisponde a questa specifica VM.

Utilizza il comando os-config guest-policies lookup per elencare i criteri guest che potrebbero avere come target una determinata VM. Sostituisci VM_NAME con il nome della VM da ispezionare.

gcloud beta compute os-config guest-policies lookup VM_NAME

Per saperne di più, consulta Visualizzazione delle configurazioni per un'istanza VM.

L'output del comando potrebbe rivelare che la VM non è stata effettivamente scelta come target nelle proprietà di assegnazione della VM del criterio guest. Ad esempio, potrebbe non essere elencata nell'elenco di Labels o nell'elenco dei prefissi dei nomi delle VM.

Recupero dall'errore in corso...

Un'installazione non riuscita di una ricetta software non viene riprovata. Questo perché il sistema non conosce lo stato in cui la formula del software non riuscita ha lasciato gli elementi.

Per eseguire il debug delle ricette software non riuscite, ti consigliamo di seguire questi passaggi:

1. Rinomina la formula del software.
2. Elimina e ricrea il criterio guest utilizzando la formula software rinominata.

Per ulteriori passaggi di risoluzione dei problemi, consulta Risoluzione dei problemi di VM Manager.

Che cosa succede dopo?

• Scopri di più sui criteri guest del sistema operativo (legacy).
• Configura un criterio per gli invitati.