Gestione dei criteri guest (legacy)

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

• Aggiorna le norme per gli ospiti: modifica le configurazioni delle norme per gli ospiti.
• Descrivi criteri guest: visualizza i dettagli di un criterio guest specifico.
• Elenca policy ospiti: visualizza un elenco delle policy ospiti in un progetto.
• Elimina un ospite: elimina una norma specifica per gli ospiti.
• Visualizza le configurazioni per un'istanza VM: visualizza le configurazioni applicate a un'istanza VM.
• Esegui il 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 una policy, saranno necessari circa 10-15 minuti per l'applicazione.

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

Prima di iniziare

• Esamina le quote di OS Config.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. 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:

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  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.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Aggiornamento delle norme relative a ospiti

Per aggiornare una norma per gli ospiti, completa i seguenti passaggi:

1. Aggiorna il file YAML o JSON.
2. Esegui un comando di aggiornamento o patch. La procedura di aggiornamento è simile a quella di creazione, con l'aggiunta del supporto per gli etag che consentono il controllo della concorrenza e della 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
}

Descrivere 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

Elenca le policy guest

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 l'eliminazione di una policy guest, lo stato attuale del sistema viene mantenuto, ma non viene eseguita alcuna ulteriore 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 mantiene il pacchetto UPDATED.

Se elimini le norme package-update-zone2b, si verificano le seguenti modifiche:

• Tutte le VM in us-west2-b su cui è installato my-package mantengono my-package installato. Non è previsto il ripristino dello stato attuale del sistema.

• In tutte le esecuzioni future dell'agente OS Config, dopo l'eliminazione della norma, si verifica quanto segue:

  • Se viene aggiunta una nuova VM a us-west2-b,my-package non viene installato su questa nuova VM.
  • Per le istanze con my-package installato, 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

Visualizza le 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

Esaminare le norme relative a ospiti

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

Esaminare 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 delle norme guest previste, è utile esaminare l'elenco delle norme guest le cui assegnazioni includono quella specifica istanza VM. Ciò consente di determinare se il campo Assignment nel criterio guest corrisponde a questa VM specifica.

Utilizza il comando os-config guest-policies lookup per elencare le policy guest che potrebbero avere come target una VM specifica. Sostituisci VM_NAME con il nome della VM da esaminare.

gcloud beta compute os-config guest-policies lookup VM_NAME

Per saperne di più, consulta Visualizzare le configurazioni per un'istanza VM.

L'output del comando potrebbe rivelare che la VM non è effettivamente presa di mira nelle proprietà di assegnazione VM della policy guest. Ad esempio, potrebbe non essere presente nell'elenco di Labels o nell'elenco dei prefissi dei nomi VM.

Recupero da errori

L'installazione non riuscita di una ricetta software non viene riprovata. Questo perché il sistema non conosce lo stato in cui si trova il software dopo l'errore.

Quando esegui il debug delle ricette software non riuscite, ti consigliamo di seguire questi passaggi:

1. Rinomina la ricetta software.
2. Elimina e ricrea la policy ospite utilizzando la ricetta software rinominata.

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

Passaggi successivi

• Scopri di più sulle norme per gli ospiti del sistema operativo (legacy).
• Configura un criterio guest.