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 un criterio specifico per gli ospiti.
• Visualizza le configurazioni per un'istanza VM: visualizza le configurazioni applicate a un'istanza VM.
• Esegui il debug di una policy guest: risolvi i problemi relativi a una policy 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 le policy 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 di verifica dell'identità per poter accedere a Trusted Cloud by S3NS servizi e 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. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:

     gcloud init

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

  Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:

  gcloud init

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

Aggiornamento dei criteri guest

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
}

Descrizione di una policy 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 che è stata attivata 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 di aver 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 policy, 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 di 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 policy guest

Puoi utilizzare la console Trusted Cloud o Google Cloud CLI per esaminare le policy guest associate al tuo progetto.

Esaminare le policy 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 della policy guest prevista, è utile esaminare l'elenco delle policy guest le cui assegnazioni includono quella specifica istanza VM. Ciò consente di determinare se il campo Assignment nella policy 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 ulteriori informazioni, consulta Visualizzazione delle configurazioni per un'istanza VM.

L'output del comando potrebbe rivelare che la VM non è effettivamente inclusa nelle proprietà di assegnazione della 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 una policy guest.